| ONScripter Multi Converter | |
|---|---|
 | |
| General | |
| Author | Prince-of-sea, PC-CNT |
| Type | File Operation |
| Version | 1.4.8 |
| License | MIT License |
| Last Updated | 2023/11/21 |
| Links | |
| Download | |
| Website | |
| Source | |
A Python tool for converting asset files for use with ONScripter for PSP. It is designed as a successor to the C&D Tools Win GUI.
This only works with games made with NScripter, see list of tested games
Installation
Follow the readme and download the required files.
Extract and move the downloaded files to the appropriate locations.
In a directory with path access:
- ffmpeg.exe
- ffprobe.exe
- pngquant.exe
In a directory designated for the tool:
|-NSC2ONS4PSP.exe
|-tools\
| |-nsaed.exe
| |-smjpeg_encode.exe
| |-Garbro_console\
| | |-GARbro.Console.exe
| | |-{Other numerous files}
| | |-{Several additional directories}
User guide
How to use
In the input directory field (入力先), use the browse button to select the directory containing the game files.
In the output directory field (出力先), use the browse button to choose a destination directory for the converted files. Files will be saved in a subfolder named "PSP_[input directory name]" within the selected directory. (if there are directory name conflicts conflicts, files maybe overwritten)
Configure the desired settings, then click the convert button to start the conversion process. Wait a few seconds to minutes until "Processing complete" appears.
Prepare the EBOOT.PBP and default.ttf for ONScripter for PSP and transfer them to a PSP with CFW/LCFW or a PS Vita with Adrenaline.
Options
Image settings (画像):
- Width adjustment - Adjusts the image width to avoid display issues like vertical lines. Default is set to a multiple of 2.
- JPG quality - Sets the quality for images converted to JPG. Lower settings reduce file size but also image quality.
- Resolution setting (Width) - Sets the resolution for the converted game. Usually, a setting of "360" is fine..
- BMP to JPG conversion & Extension spoofing - Converts non-transparent BMP files to JPG.
- PNG color reduction - Reduces the color depth of PNG files to decrease file size.
Audio settings (音源):
- OGG compression - Converts all game audio to OGG format using FFmpeg. You can set different options for background music (BGM) and sound effects (SE). BGM and SE are identified based on file paths and references in the scenario files.
Other settings (その他):
- Font loading - Keeps the font in RAM to speed up text display on the PSP. Not recommended for PSP-1000 due to higher RAM usage. This setting modifies the ons.ini file’s "FONTMEMORY" option.
- Compress files with nsaed.exe - After converting images and audio, compresses them into multiple "arc.nsa" files.
- Force text size adjustment - Increase text that is too small to read on the PSP. This only affects text defined with the
setwindowcommand.
At the bottom is the setting for the PSP screen size, relevant to the ons.ini's "SURFACE" and "ASPECT" settings.
Notes
- The tool supports only four resolutions: 800x600, 640x480, 400x300, and 320x240 (the last two are unstable).
- Games may not work properly even if they support these resolutions due to ONScripter’s limitations (e.g., DLL or Lua dependencies).
- To use the CD audio mapping feature of ONScripter, prepare the extracted WAV files beforehand. The tool will convert them to OGG.
Screenshots
Known issues
- MIDI files are not supported as the author has not tested MIDI-based games.
- The tool does not handle nbz files outside of nsa/sar/ns2 archives.
- Batch replacement of ".nbz" with ".wav" in scenario files may cause unexpected behavior.