TheMoonPeople/Chronicle

A decompilation project and modern port of Dark Cloud for the PlayStation 2.

Overview

Chronicle is a decompilation project and port of Dark Cloud for the PlayStation 2.

The project aims to produce 100% matching text and data sections for:

The main executable of the NTSC 1.02 release.
The main executable of the PAL review version.
The TITLE.BIN and DUN.BIN overlays.

Building and Running

Prerequisites

A copy of Dark Cloud (ideally the PAL version).

1. Clone the repository

git clone --recurse-submodules https://github.com/TheMoonPeople/Chronicle.git
cd Chronicle

2. Provide a disc image

Place your disc image in the corresponding region directory:

Region	Path
PAL	`rom/pal/Dark Cloud (PAL).iso`
NTSC 1.02	`rom/ntsc/Dark Cloud (NTSC).iso`

3. Build the project

Linux / macOS

./build.sh <configuration>

Windows

build.bat <configuration>

4. Run the project

./run.sh <configuration> [arguments]

Native runs through run.bat or run.sh keep runtime files in the ignored port/run/ directory: extracted data in data/, saves and settings in save/, and soundtrack files, icons and relative screenshot output alongside them. Relative input and output arguments resolve from port/run/; use absolute paths for files elsewhere. Build output stays in port/build/.

Build Configurations

Configuration / task	Platform	Build
`ps2-pal`	PlayStation 2	PAL executable and disc image
`ps2-ntsc`	PlayStation 2	NTSC 1.02 executable and disc image
`linux-x64-release`	Linux x64	Release
`linux-x64`	Linux x64	Debug
`macos-arm64-release`	macOS ARM64	Release
`macos-arm64`	macOS ARM64	Debug
`windows-x64-release`	Windows x64	Release
`windows-x64`	Windows x64	Debug
`switch`	Nintendo Switch	Homebrew `.nro` (see `docs/SWITCH.md`)
`assembleDebug`	Android	Debug APK (experimental)
`assembleProfile`	Android	Profile APK (experimental)

Run Android Gradle tasks from port/android with gradlew.bat <task> on Windows; see the Android build documentation.

Build Options

The root build scripts accept these environment variables:

Variable	Description
`CLEAN=1`	Removes the selected configuration's build directory before building.
`JOBS=N`	Sets the number of parallel build jobs.

For example:

CLEAN=1 JOBS=8 ./build.sh linux-x64-release