Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

ONScripter Multi Converter PSP

From GameBrew
Revision as of 06:47, 29 August 2024 by HydeWing (talk | contribs) (Created page with " {{Infobox PSP Homebrews |title=ONScripter Multi Converter |image=onscriptermulticonverter.png |description=Image, audio and scenario converter for ONSforPSP. |author=Prince-of-sea, PC-CNT |lastupdated=2023/11/21 |type=File Operation |format= |version=1.4.8 |license=MIT |download=https://dlhb.gamebrew.org/psphomebrew/onscriptermulticonverter.7z |website=https://github.com/Prince-of-sea/ONScripter_Multi_Converter |source=https://github.com/Prince-of-sea/ONScripter_Multi_C...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
ONScripter Multi Converter
Onscriptermulticonverter.png
General
AuthorPrince-of-sea, PC-CNT
TypeFile Operation
Version1.4.8
LicenseMIT License
Last Updated2023/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 setwindow command.

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

onscriptermulticonverter.png

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.

External links

Advertising: