ROM-mapnamen in muOS: welke map bij welk systeem hoort

In muOS hoef je geen vaste mappenstructuur na te bouwen. Je maakt een map in ROMS, zet je games erin, en muOS leidt uit de mapnaam af welk systeem het is en welke emulator erbij hoort. Dat werkt alleen als muOS de naam kent. Op deze pagina vind je de namen die muOS kent, hoe het ze leest en wat je doet met een systeem dat het niet herkent.

Getest op: Anbernic RG40XXH · muOS 2601.0 Jacaranda. De lijst hieronder is die uit deze versie (assign.json, 378 namen voor 34 systemen).

Waar de mappen komen

SD-kaart 1: de map ROMS bovenaan de kaart.
SD-kaart 2 (als je die hebt): een eigen map ROMS bovenaan.

Elk systeem krijgt een eigen map direct in ROMS, bijvoorbeeld ROMS/GBA. muOS maakt die mappen niet voor je aan: op een nieuwe kaart is ROMS misschien leeg of staan er maar een paar in.

Hoe muOS een mapnaam leest

Als je een map voor het eerst opent in Explore Content, doet muOS dit:

het zet de mapnaam in kleine letters,
haalt spaties, -, _ en + weg,
zoekt het resultaat op in zijn lijst. Staat het erin, dan krijgt de map dat systeem en de standaardemulator ervan.

Dus GBA, gba, Game Boy Advance en game-boy-advance werken allemaal: ze worden gba of gameboyadvance, en die staan op de lijst.

Sommige namen die je zou verwachten staan niet op de lijst van 2601, dus die mappen worden niet herkend:

Game Boy Color (gameboycolor), terwijl Game Boy en Game Boy Advance wel werken. Gebruik GBC.
FBNeo en MAME, terwijl de emulators er wel zijn. Gebruik ARCADE of FBA.
NDS en andere systemen zonder naam op de lijst (zie verderop).

De lijst

De korte naam raden we aan: hij staat op de lijst van muOS en is makkelijk te typen. De andere namen werken ook.

Systeem	Korte naam	Andere namen die muOS herkent (selectie)
Nintendo Game Boy	`GB`	`GAMEBOY`, `DMG`, `Game Boy`
Nintendo Game Boy Color	`GBC`	`GBCOLOR`, `NGBC` (maar niet `Game Boy Color`, zie hierboven)
Nintendo Game Boy Advance	`GBA`	`GBADVANCE`, `Game Boy Advance`
Nintendo NES / Famicom	`NES`	`FC`, `FAMICOM`
Nintendo SNES / Super Famicom	`SNES`	`SFC`, `SUPERNES`, `Super Famicom`
Nintendo 64	`N64`	`64`, `NINTENDO64`
Sega Mega Drive / Genesis	`MD`	`GENESIS`, `MEGADRIVE`, `GEN`
Sega Master System	`SMS`	`MS`, `MASTERSYSTEM`
Sega Game Gear	`GG`	`GAMEGEAR`
Sega 32X	`32X`	`SEGA32X`, `S32X`
Sega Mega-CD / Sega CD	`SEGACD`	`MEGACD`, `SCD`
Sega Dreamcast	`DC`	`DREAMCAST`
Sega Naomi / Atomiswave	`NAOMI`	`ATOMISWAVE`, `AW`
Sony PlayStation	`PS`	`PSX`, `PS1`, `PLAYSTATION`
Sony PSP	`PSP`	`PPSSPP`
NEC PC Engine / TurboGrafx-16	`PCE`	`TG16`, `PCENGINE`, `TURBOGRAFX`
NEC PC Engine CD	`PCECD`	`TGCD`, `PCENGINECD`
NEC SuperGrafx	`SGFX`	`SUPERGRAFX`
SNK Neo Geo	`NEOGEO`	`NG`
SNK Neo Geo CD	`NEOCD`	`NGCD`, `NEOGEOCD`
SNK Neo Geo Pocket / Color	`NGP`	`NGPC`, `NEOGEOPOCKET`
Arcade	`ARCADE`	`FBA`, `MAME2003`, `CPS`, `FINALBURNNEO`
Atari 2600	`ATARI2600`	`2600`, `A2600`, `ATARI`
Atari Lynx	`LYNX`	`ATARILYNX`
Commodore Amiga	`AMIGA`	`AMIGA500`
Commodore 64	`C64`	`COMMODORE64`
PC DOS	`DOS`	`PC`, `MSDOS`, `DOSBOX`
PICO-8	`PICO8`	`PICO`, `FAKE08`
ScummVM	`SCUMMVM`	`SCUMM`
Doom	`DOOM`	`PRBOOM`
Cave Story	`CAVESTORY`	`NXENGINE`
Ports (scripts)	`PORTS`	`APPS`, `SCRIPTS`
Boeken	`BOOKS`	`BOOK`
Video en muziek	`MEDIA`	`VIDEOS`, `MUSIC`, `MOVIES`

Mapnamen die ook emulatornamen zijn (bijvoorbeeld MGBA, SNES9X, DUCKSTATION, FLYCAST) staan ook op de lijst en kiezen dat systeem.

Een systeem dat niet op de lijst staat

Sommige systemen die muOS kan draaien hebben geen naam op de lijst van 2601, bijvoorbeeld de Nintendo DS. Hun mappen worden wel getoond, maar muOS weet niet welke emulator het moet gebruiken. Stel het één keer met de hand in:

Open de map in Explore Content en selecteer een willekeurige game.
Druk op SELECT voor de opties van de inhoud, kies Core en druk op A.
Kies het systeem en daarna de emulator.
Druk op X om hem te gebruiken voor alle games in deze map (A stelt hem alleen voor deze ene game in).

muOS onthoudt de keuze voor die map.

Games met meerdere bestanden

Disc-games (PlayStation, Dreamcast, Sega CD …) bestaan vaak uit meerdere bestanden (.cue + .bin, .gdi + tracks). Zet elke game in een eigen map binnen de systeemmap, bijvoorbeeld ROMS/DC/Naam van de game/.

Games via wifi in de juiste map zetten

Onze gratis app Wi-Fi Transfer sorteert de games voor je. Tik in de browser van je telefoon of pc op Games toevoegen en kies de bestanden: een .gba gaat naar ROMS/GBA, een .sfc naar ROMS/SNES, enzovoort. Heb je al een map die muOS kent voor dat systeem, bijvoorbeeld ROMS/GBA, dan gebruikt de app die. Bestandstypen die bij meerdere systemen kunnen horen (.zip, .bin, .iso, .chd): open eerst de juiste map en upload ze daarin.

Gebruik alleen games die je mag hebben, zoals gratis homebrew. Voor ideeën, zie de beste gratis homebrewgames voor de RG40XXH.

Problemen oplossen

De map staat er, maar games starten niet of vragen om een core: de naam staat niet op de lijst van muOS. Geef de map een korte naam uit de tabel, of stel het systeem met de hand in zoals hierboven.
Een game start met de verkeerde emulator: selecteer hem, druk op SELECT → Core en kies een andere (X voor de hele map).
Games verschijnen helemaal niet: controleer of ze direct in de systeemmap staan (of in één gamemap daarbinnen) en niet in een .zip met een hele verzameling.

Samenvatting

Maak in ROMS één map per systeem, met een korte naam uit de tabel (GB, GBA, SNES, PS, PSP …).
Hoofdletters, spaties, -, _ en + maken niet uit.
Niet op de lijst (bijvoorbeeld Game Boy Color, NDS, FBNEO, MAME)? Hernoem de map, of gebruik SELECT → Core en dan X voor de hele map.

Bronnen: de mappenlijst in muOS 2601.0 (assign.json op de handheld); hoe muOS mapnamen leest: broncode van MustardOS frontend; Assigning a core to a directory (FAQ van de muOS-community).

Vragen? Mail naar feedback@pocketkode.com.

PocketKode is niet verbonden aan muOS of Anbernic.