System3 for SDL2

This is an SDL2 port of System3 for Win32 by Takeda Toshiya. It supports multiple platforms, including Android and Emscripten.

Installing

For Windows and Android, you can download pre-built binaries from the Releases page.

For other platforms, you need to build the program from source. See the Building section for instructions.

Note for Windows:

• The 64-bit version supports Windows 10 or later. For older versions of Windows, please use the 32-bit version.

Running

• Windows: Copy system3.exe to the game folder and double-click it.
• Android: Install the APK file and follow the on-screen instructions.
• Other platforms: Run system3 from within the game directory.

Options

system3 supports the following command line options:

-noantialias

Disables text anti-aliasing.

-fontfile filename

Specifies the font file used for rendering text. Both .ttf and .otf files are supported.

-playlist filename

filename is a text file that lists the audio files to play in lieu of CD audio tracks, one per line. For example:

# This line is ignored
BGM/track02.mp3
BGM/track03.mp3
...

The first line is not used because track 1 on a game CD is usually a data track.

-fm

By default, system3-sdl2 uses MIDI sound if available. This option forces FM tone generator emulation.

-mididevice number

Specifies the MIDI device number to use. If not specified, the first available device is used.

-texthook mode

Specifies the text hook mode. This option is used for capturing in-game text for translation or other purposes. The available modes are:

• none: Disable text hooking.
• print: Print the captured text to the console.
• copy: Copy the captured text to the clipboard.

-texthook_suppress list

Suppress text hook on specified scenario pages. list is a comma-separated list of page numbers.

-trace

Enables trace mode, which prints debug information to the console.

-game game_id

As System1-3 have slight variations depending on the game, system3 uses the fingerprint of the scenario file (ADISK.DAT) to identify the game being played. This option allows you to override this detection, which is useful when running patched games.

Here is a list of available game IDs and their corresponding titles:

game_id	Title	Notes
ambivalenz_cd	AmbivalenZ −二律背反− (CD)
ambivalenz_fd	AmbivalenZ −二律背反− (FD)
ayumi_cd	あゆみちゃん物語 (CD)
ayumi_fd	あゆみちゃん物語
ayumi_hint	あゆみちゃん物語 ヒントディスク
ayumi_live_256	あゆみちゃん物語 実写版
ayumi_live_full	あゆみちゃん物語 フルカラー実写版	Unsupported
ayumi_proto	あゆみちゃん物語 PROTO
bunkasai	あぶない文化祭前夜
crescent	クレセントムーンがぁる
dalk	DALK	Unsupported
dalk_hint	DALK ヒントディスク	零式 does not work
dps	D.P.S - Dream Program System
dps_sg_fahren	D.P.S SG - Fahren Fliegen
dps_sg_katei	D.P.S SG - 家庭教師はステキなお仕事
dps_sg_nobunaga	D.P.S SG - 信長の淫謀
dps_sg2_akai	D.P.S SG set2 - 朱い夜
dps_sg2_antique	D.P.S SG set2 - ANTIQUE HOUSE
dps_sg2_ikenai	D.P.S SG set2 - いけない内科検診再び
dps_sg3_rabbit	D.P.S SG set3 - Rabbit P4P
dps_sg3_shinkon	D.P.S SG set3 - しんこんさんものがたり
dps_sg3_sotsugyou	D.P.S SG set3 - 卒業
dps_all	D.P.S. 全部
drstop	Dr. STOP!
fukei	婦警さんＶＸ
funnybee_cd	宇宙快盗ファニーBee (CD)
funnybee_fd	宇宙快盗ファニーBee (FD)
gakuen_king	学園KING -日出彦 学校をつくる-	Unsupported
hashirionna2	走り女2
intruder	Intruder -桜屋敷の探索-
little_vampire	Little Vampire
mugen	夢幻泡影
ningyo	人魚 -蘿子-
nise_naguri	にせなぐりまくりたわあ	Unsupported
onlyyou	Only You −世紀末のジュリエット達−
onlyyou_demo	Only You −世紀末のジュリエット達− デモ版
otome	乙女戦記
prog_cd	Prostudent G (CD)
prog_fd	Prostudent G (FD)
prog_omake	Prostudent G おまけ
rance	Rance -光をもとめて-	Unsupported
rance2	Rance 2 -反逆の少女たち-	Unsupported
rance2_hint	Rance 2 ヒントディスク
rance3	Rance 3 -リーザス陥落-	Unsupported
rance3_hint	Rance3 ヒントディスク	走り女 does not work
rance4	Rance 4 教団の遺産	Unsupported
rance4_opt	Rance 4 オプションディスク	Unsupported
rance41	ランス 4.1 〜お薬工場を救え！〜
rance42	ランス 4.2 〜エンジェル組〜
sdps_kaizoku	Super D.P.S - うれしたのし海賊稼業
sdps_maria	Super D.P.S - マリアとカンパン
sdps_tono	Super D.P.S - 遠野の森
tengu	あぶないてんぐ伝説
toushin	闘神都市	Unsupported
toushin_hint	闘神都市 ヒントディスク	"ランス外伝 －闘神都市－" does not work
toushin2	闘神都市II	Unsupported
toushin2_gd	闘神都市2 グラフィックディスク
toushin2_sp	闘神都市2 そして、それから…
yakata	ALICEの館
yakata2	ALICEの館II	殴りまくりたわぁ and おかゆの逆襲 do not work
yakata3_cd	アリスの館3 (CD)
yakata3_fd	アリスの館3 (FD)

Configuration File system3.ini

Every option that can be set via command line flags can also be configured through the system3.ini file located in the game folder. Refer to system3.ini.example for the file format and available options. Options specified on the command line will override those in system3.ini.

Debugging

system3-sdl2 has a built-in debugger that allows you to step through the game and examine or modify game variables. There are two ways to use the debugger:

• Through Visual Studio Code (recommended): The vscode-system3x extension provides a graphical debugging interface for System 1-3.
• Using the CLI Debugger: Running system3 with the -debugger cli option will launch the debugger with a console interface. Type help to see a list of available commands.

Localizing a Game

While the original System 1-3 only supported Shift_JIS (a Japanese character encoding), system3-sdl2 supports Unicode and can run games translated into languages other than Japanese and English.

For instructions on how to build a game with Unicode support, see the sys3c documentation.

When running a modified (translated) game, system3 cannot automatically detect the game ID. You need to specify the game option in system3.ini.

Building from Source

Linux (Debian, Ubuntu)

$ git submodule update --init
$ sudo apt install g++ cmake libsdl2-dev libsdl2-ttf-dev libsdl2-mixer-dev librtmidi-dev nlohmann-json3-dev
$ mkdir -p out/debug
$ cd out/debug
$ cmake -DCMAKE_BUILD_TYPE=Debug ../../
$ make
$ sudo make install

MacOS

$ git submodule update --init
$ brew install cmake pkg-config sdl2 sdl2_ttf sdl2_mixer rtmidi nlohmann-json
$ mkdir -p out/debug
$ cd out/debug
$ cmake -DCMAKE_BUILD_TYPE=Debug ../../
$ make
$ sudo make install

Windows (MSYS2)

$ git submodule update --init
$ pacman -S make mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-cmake mingw-w64-ucrt-x86_64-SDL2 mingw-w64-ucrt-x86_64-SDL2_ttf mingw-w64-ucrt-x86_64-rtmidi mingw-w64-x86_64-nlohmann-json
$ mkdir -p out/debug
$ cd out/debug
$ cmake -G"MSYS Makefiles" -DCMAKE_BUILD_TYPE=Debug ../../
$ make

Windows (Microsoft Visual Studio)

• Visual Studio 2022 can be used to clone this repository and will automatically clone submodules as well.
• Install CMake. (The CMake integration in Visual Studio does not work.)
• In the CMake GUI, press the "Browse Source..." button and select the root folder of this repository.
• Press the "Browse Build..." button. Create a new folder (e.g., out) under the top-level directory of the repository and select it.
• Press the "Configure" button. Specify the generator for your version of Visual Studio and click "Finish."
• Press the "Generate" button.
• A System3.sln file should be generated in the build folder. Open it with Visual Studio.

Emscripten

$ git submodule update --init
$ mkdir -p out/wasm
$ cd out/wasm
$ emcmake cmake -DCMAKE_BUILD_TYPE=Release ../../
$ make

Android

See android/README.md.

Nintendo Switch

See switch/README.md.