Start with the path, not the command list#
Most POPStarter failures in the local notes are layout failures: wrong folder, wrong prefix, wrong boot=, wrong share name, wrong __.POPS spelling, or support files placed under the VCD folder instead of the per-game folder. Only tune commands after the file tree is known-good.
First split the symptom#
| Symptom | Do first | Do not do first |
|---|---|---|
| Black screen launching HDD from OPL Apps with HDD LED stuck. | Set unused OPL devices such as network/BDM/SMB to Manual or Disabled. | Start stacking compatibility modes. |
| Black screen after choosing IGR exit. | Check $IGR5, BOOT.ELF, and the loader-disable path. | Rewrite storage folders. |
| USB not detected. | Check drive format/fragmentation and config byte $413. | Use $USBDELAY_# as a device-detection fix. |
| Game boots but cheats/fixes do nothing. | Check uppercase filenames and basename support folder. | Assume the compatibility command is wrong. |
| SMB boots but saves fail. | Check share write permission and per-game folder creation. | Change POPStarter build first. |
Game-specific lore is not a preset pack#
Some reference examples are valuable because they demonstrate a rule, not because they should be copied globally. Tekken 3 shows that 0x06 and 0x04 can combine. Crash Bash shows why title-specific fix threads matter. Tomb Raider CDDA desync shows that some issues are POPS emulation limits rather than POPStarter setup errors.
When in doubt, make a support report#
A useful report includes exact storage backend, frontend, POPStarter build, VCD basename, renamed ELF, support folder path, CHEATS.TXT, DISCS.TXT, VMCDIR.TXT, last visible screen, and for SMB the two config files plus auth/write-permission details.
| Issue | Symptom | Likely causes | Mitigation | Sources |
|---|---|---|---|---|
| Black screen after accepting POPStarter IGR exit high verified-primary |
IGR popup appears, user chooses YES, then the console hangs on black screen. |
|
Use $IGR5 for no-popup direct close. If BOOT.ELF chaining still black-screens, use loader-disable PATCH_9.BIN in the POPS folder or replace/recompress BOOT.ELF. | PSX-Place POPStarter page 15 - IGR and BOOT.ELF discussion PSX-Place POPStarter page 4 - PATCH_9.BIN loader-disable post |
| Expected 240p but POPStarter outputs interlaced video high verified-primary |
Game appears in 480i/576i instead of PS1-style 240p/288p. |
|
Check the per-game CHEATS.TXT first; remove $HDTVFIX unless the target display requires it. | PSX-Place POPStarter page 15 - IGR and BOOT.ELF discussion |
| HDD POPStarter launched from OPL Apps hangs with HDD LED stuck high verified-cross-source |
Black screen and fixed HDD activity light when launching HDD POPStarter ELF from OPL Apps. |
|
Set non-needed OPL devices to Manual or Disabled before launching HDD POPStarter through Apps. | ElOtroLado POPS emulator for PS2 thread (mention only) PSX-Place POPStarter page 15 - IGR and BOOT.ELF discussion |
| SMB config ignored because filenames are wrong high verified-cross-source |
SMB launch cannot connect or appears to ignore network configuration. |
|
Use IPCONFIG.DAT, SMBCONFIG.DAT, and poweroff.irx as shown in the ElOtroLado first post. | ElOtroLado POPS emulator for PS2 thread (mention only) User uploaded operational notes |
| HDD returns to Browser or freezes because __.POPS is misspelled high verified-cross-source |
Game launch returns to the PS2 Browser, freezes at logo, or cannot find VCDs. |
|
Use hdd:/__.POPS/ exactly for VCDs and hdd:/__common/POPS/ for common POPS files. | ElOtroLado POPS emulator for PS2 thread (mention only) PSX-Place POPStarter page 4 - PATCH_9.BIN loader-disable post |
| USB videos stutter or games slow down medium verified-single-source |
FMVs stutter, loading is poor, or audio/video is unstable on USB. |
|
Use a USB HDD where possible, FAT32 64K clusters if compatible, and avoid repeated copy/delete churn. | ElOtroLado POPS emulator for PS2 thread (mention only) |
| SMB requires legacy configuration medium verified-cross-source |
Modern Windows/NAS share cannot be reached by POPStarter. |
|
Use an isolated network/share if enabling legacy SMB behavior; prefer a dedicated PS2 share with write permission for VMCs. | PSX-Place POPStarter release thread ElOtroLado POPS emulator for PS2 thread (mention only) |
| OPL Apps entry missing because title.cfg was saved as .txt high verified-hardware-user |
The app entry does not appear, or the entry launches nothing. |
|
Save the file as plain text named exactly title.cfg, put it beside the renamed ELF, and make boot= match only that ELF filename. | User uploaded operational notes |
| CHEATS, VMC, or fixes ignored because the per-game folder name is wrong high verified-cross-source |
The game boots, but CHEATS.TXT, VMC sharing, or Hugopocked fixes do not apply. |
|
Name the support folder after the VCD basename without .VCD: mass:/POPS/<Game>/ on USB, hdd:/__common/POPS/<Game>/ on HDD, and smb:/POPS/<Game>/ on SMB. | User uploaded operational notes ElOtroLado POPS emulator for PS2 thread (mention only) |
| CHEATS.TXT ignored because the filename case is wrong high recovered-cross-check |
Named commands or raw cheat codes do nothing, especially on internal HDD/PFS. |
|
Rename the file to uppercase CHEATS.TXT and place it in the folder matching the VCD basename. | POPSLoader recovered POPStarter documentation site (mention only) ElOtroLado POPS emulator for PS2 thread (mention only) |
| USB POPS0-POPS9 game boots without expected patches or handlers high recovered-cross-check |
A game in POPS0 through POPS9 launches, but BIOS.BIN, PATCH_#.BIN, TROJAN_#.BIN, or VMCDIR.TXT behavior is missing. |
|
Keep POPS_IOX.PAK and IGR TM2 textures in mass:/POPS, but copy BIOS.BIN, PATCH_#.BIN, TROJAN_#.BIN, and VMCDIR.TXT into every POPS# folder that needs them. | POPSLoader recovered POPStarter documentation site (mention only) ShaolinAssassin POPStarter documentation wiki |
| HDD VCD folder created as +__.POPS instead of __.POPS high recovered-cross-check |
Modern HDD launch cannot find VCDs even though a similarly named partition exists. |
|
Use hdd0:/__.POPS/ for VCDs and hdd0:/__common/POPS/ for shared POPS files and per-game support folders. | POPSLoader recovered POPStarter documentation site (mention only) ElOtroLado POPS emulator for PS2 thread (mention only) |
| Old RIP or WIP build used instead of the final 2019 r13 beta high recovered-cross-check |
Documented final-build behavior such as $IGR5 or later config-byte meanings does not match the user's setup. |
|
Treat POPStarter r13 Beta 2019-06-05 as the canonical final public build unless deliberately testing an older build. | POPSLoader recovered POPStarter documentation site (mention only) Retro-Jogos POPStarter guide home |
| SMB debug text mistaken for a required debug build high recovered-cross-check |
SMB launch shows startup/debug text and the user assumes the wrong POPStarter build was used. |
|
Do not chase a separate debug build just because SMB startup text is visible. Focus on SB. prefix, memory-card modules, IPCONFIG.DAT, SMBCONFIG.DAT, and share write permission. | POPSLoader recovered POPStarter documentation site (mention only) ElOtroLado POPS emulator for PS2 thread (mention only) |
| SMB launch fails because the prefix or OPL SMB protocol name is wrong high verified-cross-source |
The SMB app entry starts then black-screens, or OPL Apps does not launch the ELF. |
|
Use SB.<Game>.ELF for SMB POPStarter launchers. For newer OPL betas, try smb0:/APPS/SB.<Game>.ELF if smb:/APPS/SB.<Game>.ELF does not work. | ElOtroLado POPS emulator for PS2 thread (mention only) User uploaded operational notes |
| SMB game boots but VMC saves fail high verified-single-source |
The game launches over SMB, but memory card files are not created or saves do not persist. |
|
Give the configured SMB user or guest account write permission on the share. POPStarter creates/updates SLOT0.VMC and SLOT1.VMC over SMB. | ElOtroLado POPS emulator for PS2 thread (mention only) |
| USB exFAT does not work because BDM modules were not renamed into POPStarter's driver names high verified-primary |
FAT32 USB works, but exFAT USB is not detected by POPStarter. |
|
Place bdm_assault.irx as mc?:/POPSTARTER/usbd.irx and usbd_bd_assault.irx as mc?:/POPSTARTER/usbhdfsd.irx. Keep internal HDD POPS data on APA/PFS. | BDM Assault GitHub repository User uploaded operational notes |
| Multi-disc swap or shared VMC does not work medium verified-hardware-user |
Later discs cannot find the disc set, or each disc creates separate saves. |
|
Put DISCS.TXT in every disc support folder and VMCDIR.TXT in later-disc support folders. List exact VCD filenames, one per line. | User uploaded operational notes ShaolinAssassin POPStarter documentation wiki |
| POPSLoader starts incorrectly because its support folder is misplaced high verified-cross-source |
POPSLoader launches to a blank screen, cannot list games, or loses expected UI/resources. |
|
Keep POPSLOADER.ELF and the POPSLDR folder together under the POPSLoader app folder, and document fork-specific behavior separately from original POPStarter core. | POPSLoader by El_isra Ripto/NathanNeurotic POPSLoader fork User uploaded operational notes |
| POPSLoader fork device missing because BDMA mode is wrong high verified-primary |
USB/MX4SIO/MMCE games do not appear or launch from the fork. |
|
Use mc0, enable BDMA for non-HDD devices, and select only the device mode being used. | Ripto/NathanNeurotic POPSLoader fork |