Skip to content

Game Paths & Covers

aldostools edited this page Dec 10, 2021 · 64 revisions

Game Paths

The following are the standard paths for the different content types supported by webMAN MOD.

The ISO folders support subdirectories, except NET folders that only support single letter subdirectories or directories that match with the file name of the ISO in the folder.

/dev_ms, /dev_cf, /dev_sd are also supported on phat models where it says /dev_usb***

prepISO (formerly known prepNTFS) adds support for content stored in NTFS, ext2/ext3 and exFAT devices.

GAMES and GAMEZ folders are for BD games with extracted files (aka Jailbreak folders)

GAMEI folder is for PSN games extracted files from PKG files. Name the folders as Title ID or Content ID.

Content Type Path
PS3
*.ISO
*.ISO.# (split-ISO)
/dev_hdd0/PS3ISO
/dev_usb***/PS3ISO
/ntfs*/PS3ISO
/net*/PS3ISO
PS3
JB folders
/dev_hdd0/GAMES
/dev_hdd0/GAMEZ

/dev_usb***/GAMES
/dev_usb***/GAMEZ

/net*/GAMES
/net*/GAMEZ
PS2
CFW: *.ISO, *.BIN.ENC
HEN: *..BIN.ENC only
/dev_hdd0/PS2ISO

/dev_usb***/PS2ISO (this copy the content to hdd0)
/ntfs*/PS2ISO (this copy the content to hdd0)
/net*/PS2ISO (this copy the content to hdd0)
PSX
CUE/BIN, IMG/CCD, *.ISO, *.MDF
/dev_hdd0/PSXISO
/dev_hdd0/PSXGAMES

/dev_usb***/PSXISO
/dev_usb***/PSXGAMES

/ntfs*/PSXISO
/ntfs*/PSXGAMES

/net*/PSXISO
/net*/PSXGAMES
PSP
*.ISO only
/dev_hdd0/PSPISO
/dev_usb***/PSPISO

/dev_usb***/ISO (e.g. connect PSP to USB)

/ntfs*/PSPISO (requires prepISO 1.26 or later)

/net*/PSPISO (use latest ps3netsrv to mount it)
DVD
*.ISO, *.IMG, *.MDF
/dev_hdd0/DVDISO
/dev_usb***/DVDISO

/ntfs*/DVDISO
/net*/DVDISO
BluRay
*.ISO, *.IMG, *.MDF
/dev_hdd0/BDISO
/dev_usb***/BDISO

/ntfs*/BDISO
/net*/BDISO
Package Files (*.pkg) /dev_hdd0/packages
/dev_usb***/packages

/ntfs*/packages
/ntfs*/Packages
/ntfs*/PKG
/net*/PKG
Fake ISO (prepISO) /ntfs*/VIDEO (*.mp4, *.avi)
/ntfs*/MOVIES (*.mp4, *.avi)
/ntfs*/MUSIC (*.mp3)
/ntfs*/THEME (*.p3t)
/ntfs*/UPDATE (*.PUP)
/ntfs*/BDFILE (*.*)
PSN games
(app_home/PS3_GAME icon is required)
/dev_hdd0/game
/dev_usb***/GAMEI

/net*/GAMEI

SPECIAL NOTES:

ISO Files

The ISO file name should include the extension .ISO or .iso (.BIN, .IMG and .MDF are also supported).

For split or multi-part ISOs, the files must be 4GB or smaller. The extension must be: .ISO.# or .iso.# (where # is 0-63). All parts are recommended to have the same size, except the last part.

For PSX games it is recommended to include the .CUE or .CCD file for information about the audio tracks. The ISO must be MODE2/2352. Other unofficial sector sizes supported are: 2048, 2336, 2448, 2328, 2340, 2368.

For PS2 Classics, the extension must be .BIN.ENC (all caps).

PS2 Config

The CONFIG can be useful not only to make a PS2 game playable, but also to improve the performance or fix glitches, stuttering, etc.

If the file name of the PS2 ISO contains the game id enclosed in brackets, webMAN MOD will search the PS2CONFIG database copied locally in your system and copy it to the PS2ISO folder, if the ISO already don't have one. e.g.

/dev_hdd0/PS2ISO/My Game 1 (SLES-12345).ISO /dev_hdd0/PS2ISO/My Game 2 [SLUS_123.45].iso /dev_hdd0/PS2ISO/My Game 3 [SLPM12345].BIN.ENC

Notice that there is a space before the square bracket or the parenthesis. The game ID must be upper case.

You can disable this feature unchecking the option "Auto CONFIG" found hidden in the "Scan for Content" of /setup.ps3

You can setup the CONFIG manually downloading the file from https://ps3.aldostools.org/ps2config.html and copying it to the same folder of the ISO with the same file name + .CONFIG (in caps). e.g. /dev_hdd0/PS2ISO/My Game.iso /dev_hdd0/PS2ISO/My Game.iso.CONFIG

Custom configuration files can be created using the PS2 CONFIG editor included in ManaGunZ.

Covers

A huge covers pack for webMAN MOD is available here thanks to @DeViL303:

UPDATE:

To create your own covers I highly recommend the PScoverBOX by @0_obeWAN

There is another cover tool by Rudi Rastelli that can be useful

What sizes w/h in pixels they must have (for both, PSX and PS2 covers)? The images should be squares due the XML is generate with the icon_notation: WNT_XmbItemSavePS3 If the image is too big, too small, too wide or too tall, it will be resized. PScoverBOX uses 268x268

As the form factor of the covers varies depending on the game platform, I suggest to use PNG and fill the blank space with transparent pixels to create the square image. PScoverBOX already takes care of this.

Is there any size limitation?
Although images in big resolution look better, they also consume more VSH memory. So I suggest to make the images the smallest possible if you plan to list a large number of games. e.g. 160x160 or smaller

The width & height must be multiple of 4.

Where to place them?
webMAN MOD uses several locations. I suggest to use multiMAN's location for covers, so they can be used by multiMAN, IRISMAN, sman, webMAN, webMAN MOD

PS1 & PS2:

/dev_hdd0/game/BLES80608/USRDIR/covers_retro/psx/

The file name format for PS1 and PS2 is SLUS_123.45_COV.JPG or .PNG (uppercase)

PS3

/dev_hdd0/game/BLES80608/USRDIR/covers/

Other locations for covers can be:

/dev_hdd0//game/BLES80608/USRDIR/covers
/dev_hdd0/tmp/game_repo/main/covers
/dev_hdd0/game/NPEA00374/USRDIR/covers
/dev_hdd0//game/MANAGUNZ0/USRDIR/covers
/dev_hdd0/GAMES/covers
/dev_hdd0/GAMEZ/covers

(The double // in the paths is used intentionally to search in hdd0 when the external gameDATA is enabled)

For custom locations the user can define it in COVERS_PATH of the language file.

The file name format is BLES12345.JPG or BLES12345.PNG (uppercase)

webMAN MOD also can list the covers from an online server hosted FREE of cost to the community by @DeViL303. To use this feature select ONLINE COVERS in /setup.ps3

It is highly recommended to install multiMAN's cover pack for faster response and reduce server traffic.

For ISOs (PS1, PS2, PS3, PSP, DVD, BD, ROMS, NTFS) the cover must have the same file name of the ISO but with the file extension changed to .png or .jpg

<path>/<filename of ISO>.png
<path>/<filename of ISO>.jpg
<path>/<titleid of ISO>.JPG or PNG

Also include the game ID between square brackets in the file name for faster scanning.

examples:

/dev_hdd0/PS3ISO/MyGame [BLES12345].jpg
/dev_hdd0/PSXISO/MyGame [SLUS-12345].jpg
/dev_hdd0/PS2ISO/MyGame [SLUS_123.45].jpg
/net0/PSXISO/MyGame.iso.png (can be without .iso too)
/ntfs1/PSXISO/MyGame.png
/dev_usb000/PSXISO/MyGame.jpg
/dev_usb000/PS3ISO/BLES12345.PNG

The covers of exFAT / NTFS games are cached automatically in: /dev_hdd0/tmp/wmtmp

For PS2 Classics (.BIN.ENC):

/dev_hdd0/PS2ISO/<filename>.BIN.ENC
/dev_hdd0/PS2ISO/<filename>.BIN.ENC.PNG <= Used as ICON0.PNG when the game is mounted
/dev_hdd0/PS2ISO/<filename>.BIN.ENC.PIC0.PNG <= optional
/dev_hdd0/PS2ISO/<filename>.BIN.ENC.PIC1.PNG <= optional
/dev_hdd0/PS2ISO/<filename>.BIN.ENC.PIC2.PNG <= optional

Alternative file names for icons and background

/dev_hdd0/PS2ISO/<filename>.PNG <= Used as ICON0.PNG when the game is mounted
/dev_hdd0/PS2ISO/<filename>.PIC0.PNG <= optional
/dev_hdd0/PS2ISO/<filename>.PIC1.PNG <= optional
/dev_hdd0/PS2ISO/<filename>.PIC2.PNG <= optional

How they are recognized? If by filename, then how? By GameID (i.e "SLUS12345.png")?
Both methods are supported.

If the TITLE ID is included in the file name of the ISO, the cover is searched in the same folder or in the centralized repositories. If the title id is not found, the cover is searched in the same path of the ISO as file name + .JPG or PNG (.iso extension is optional)

They are in anyway overlay like i.e in OPL overlayed by 3D disc case?
I don't know any 3D disc case overlay. ManaGunZ can display the cases in real 3D.

PScoverBOX includes various nice 2D overlays.

Clone this wiki locally