DeltaruneVita
Deltarune (Chapters 1 to 5) Port to PSVita.
| Type | Filename | Size |
|---|---|---|
| DIR | artifacts | — |
| DIR | Assets | — |
| DIR | config | — |
| DIR | data | — |
| DIR | docs | — |
| DIR | experiments | — |
| DIR | mods | — |
| DIR | scripts | — |
| DIR | src | — |
| DIR | tests | — |
| DIR | third_party | — |
| DIR | tools | — |
| FILE | .gitignore | 931 B |
| FILE | CHANGELOG.md | 5583 B |
| FILE | FUTURE_IDEAS.txt | 2058 B |
| FILE | LICENSE | 16726 B |
| FILE | README.md | 32802 B |
| FILE | run_build.cmd | 328 B |
| FILE | run_chapter.bat | 52 B |
README
An unofficial port of DELTARUNE Chapters 1–5 for the PlayStation Vita.
DeltaruneVita runs the official Windows/Steam GameMaker data through a Vita-focused implementation of Butterscotch, using VitaGL for graphics and OpenAL for audio. It adds Vita controls, optional touch input, configurable graphics and audio, console borders, language/mod support, trophies, native video playback, diagnostics, and dedicated patchers that generate the required Vita data from a legally obtained copy of the game.
[!IMPORTANT] This repository and its releases do not include DELTARUNE's commercial game data. A legitimate Steam copy is required. You can purchase the game at deltarune.com.
| Chapter | Status | Details | Reviewed |
|---|---|---|---|
|
Chapter 1 |
Playable | Everything works perfectly. | 100% |
|
[image: Chapter 2]
Chapter 2 |
Playable | Minor performance drops in some rooms. | 100% |
|
Chapter 3 |
Playable |
Some mini-game rooms lag on first load. Generally 30+ FPS afterward. Smooth final battle. |
95% |
|
Chapter 4 |
Playable |
Some rooms need more optimization. Choppy climbing sequence, but smooth final battle. |
85% |
|
Chapter 5 |
Playable |
Smooth final battle, but optimization is incomplete. Possible FPS drops Full completion not yet verified. |
80% |
For release-specific changes, screenshots, and the complete changelog, check out the Latest Release.
- A homebrew-enabled PlayStation Vita;
- kubridge;
- FdFix, unless rePatch already provides equivalent file-descriptor handling;
libshacccg.suprx, installed using the Vita shader compiler guide;- an official, unmodified DELTARUNE Steam v0.0.253 installation.
Optional: PSVshell can be used for overclocking. To enable native PS Vita trophies, follow the NoTrpDrm setup below.
Add the required kernel plugins under *KERNEL in taiHEN's config.txt:
*KERNEL
ux0:tai/kubridge.skprx
ux0:tai/fd_fix.skprx
[!NOTE] Do not load
fd_fix.skprxtogether with a setup where rePatch already provides the same functionality.
- Purchase and install DELTARUNE for PC through Steam.
- Confirm that the installation is v0.0.253 and unmodified.
- Download
Deltarune-v0.81.vpkand the patcher for your PC architecture from the latest release. - Generate the Vita data using DeltaruneVita Patcher, Seam's Patcher or the Web Patcher.
- Copy the generated
deltarunefolder toux0:data/on the Vita. - Install
Deltarune-v0.81.vpkusing VitaShell.
The final path must be:
ux0:data/deltarune/deltarunevita/
- Extract either
Deltarune.Vita.Patcher.v0.81.64bits.ziporDeltarune.Vita.Patcher.v0.81.32bits.zip. - Copy the complete Steam
DELTARUNEfolder intoSteamFiles/DELTARUNE. - Run the included
DeltaruneVitaPatcher_*bit.exe. - Select optional language packages when offered.
- The finished data is written to
VitaFiles/deltarune.
Seam's Patcher uses the authentic Seam-shop interface and is available in three forms:
- Seam's Patcher Lite (Recommended, ~220 MB): Extract
Seam.s.Patcher.v0.81.64bits.zipor32bits.zipand runSeamsPatcher_Lite_*bit.exe. Features the full Edge App mode GUI with all 55 animated borders embedded, downloading only selected translation packs on demand with local caching incache/. - Web Patcher (Browser or Mobile): Run directly in your browser at wolffsroom.github.io/DeltaruneVita with DEFLATE streaming support and mobile compatibility.
- Run your chosen Seam's Patcher edition.
- Select a clean DELTARUNE Steam folder when prompted.
- Select any optional languages/mods (including Animated Borders and PT-BR v0.81).
- Generate the Vita package, then copy its
deltarunefolder toux0:data/.
[!NOTE] On iOS/iPadOS, provide the DELTARUNE folder as a ZIP when the browser cannot select a directory directly.
The layout is based on the official PlayStation-style controls with Vita-specific shortcuts for Game Settings and touch features.
DeltaruneVita includes a 30-entry trophy system. Trophy progress is mirrored to the port's local trophy database and can be viewed at Game Settings → System → Trophies.
Local progress is stored in:
ux0:data/deltarune_saves/trophies.ini
The local trophy interface, unlock notifications and persistence work without any additional plugin. Native PS Vita system trophies are optional.
[!NOTE] DeltaruneVita does not require NoTrpDrm to run. If the plugin, trophy pack or supported native environment is unavailable, the game falls back to the local in-game trophy system.
NoTrpDrm allows homebrew applications to use trophy packs through sceNpTrophy by bypassing the NP Communication and TRP signature checks.
- Download
NoTrpDrm.suprxfrom the NoTrpDrm Releases. - Copy
NoTrpDrm.suprxto the taiHEN directory used by your Vita.ur0:tai/is recommended whenur0:tai/config.txtis your active configuration; useux0:tai/only if that is where your activeconfig.txtis stored. - Add NoTrpDrm under
*mainin the activeconfig.txt:
*main
ur0:tai/NoTrpDrm.suprx
If your active taiHEN configuration is on ux0:tai/, use:
*main
ux0:tai/NoTrpDrm.suprx
- Reboot the Vita or reload the taiHEN configuration.
- Launch DeltaruneVita. Newly earned trophies will continue to be recorded in
trophies.iniand, when NoTrpDrm/native trophy initialization is available, will also be mirrored to the Vita trophy system.
[!IMPORTANT] The NoTrpDrm implementation used by this project targets retail firmware 3.60 through 3.68. Firmware spoofing does not change the console's underlying firmware. Treat this custom trophy set as homebrew/local data and do not attempt to synchronize it with PSN.
| Core Features | System and Graphics |
|---|---|
| • Chapter selector for all five chapters | • Dual Graphics API: VitaGL (Experimental, Legacy, Modern) and native VitaGXM |
| • Direct loading of official Steam GameMaker data | • Hardware VSync at locked 30 FPS synchronized to display VBlank |
| • Physical Vita controls and optional touch controls | • Native C fastpaths for heavy rooms in Chapters 4 & 5 (saving up to 35 ms/frame) |
| • Chapter 4 Mike's Room mouse simulation (right stick/touch) & mic input | • Animated Borders mod with 24 px feathering and < 768 KiB VRAM footprint |
| • Vita-native Game Settings menu & enhanced DEV tools | • New CRT filter suite (Soft, Medium, Aggressive) and display filters |
| • Independent volume controls and streamed music | • Authentic Chapter 5 diagonal petal transition (shd_petalcut) |
| • Language/mod packages with isolated data/cache layouts (PT-BR v0.81) | • Room-aware Texture Page loading, cache and eviction |
| • Local and native trophy integration (NoTrpDrm) | • Native SceAvPlayer video playback & universal cold-boot audio |
| • Interactive Prologue with plugin detection (NoTrpDrm / CapUnlocker) | • Official DualShock 4 / PS4 button glyphs in menus and battle prompts |
A 2048×2048 GameMaker atlas stored as RGBA8888 occupies 16 MiB of raw texture memory. DeltaruneVita reduces pressure by using rebuilt Texture Pages and prepared GPU-friendly caches:
- BC3/DXT5: approximately 4 MiB for a 2048×2048 atlas, including alpha;
- RGBA4444: approximately 8 MiB and used where the higher-fidelity prepared path is safer;
- embedded game texture: source/fallback used for cache generation and compatibility.
The runner resolves prepared textures in this order:
BC3 → RGBA4444 → generated/embedded compatibility path
Language packages keep their own matching caches whenever their data.win changes Texture Page contents or indices.
| Chapter | Rebuilt pages |
|---|---|
| Chapter 1 | 192 |
| Chapter 2 | 414 |
| Chapter 3 | 397 |
| Chapter 4 | 838 |
| Chapter 5 | 1,017 |
The higher page count is intentional: smaller, more targeted pages can produce a lower per-room working set than a few oversized atlases.
A v0.81 patcher generates the following base layout:
ux0:data/deltarune/
├── config.ini
└── deltarunevita/
├── borders/ # static console border assets
├── chapter0/
├── chapter1/
├── chapter2/
├── chapter3/
├── chapter4/
├── chapter5/
├── mods/
│ ├── bordersanim/ # animated borders (.bani) assets
│ ├── Borders/ # Standard borders assets
│ └── Lang/
│ └── <Language>/ # isolated translation/mod data
├── music/ # external/shared music assets
├── sounds/ # Vita/frontend sound assets
├── ui/ # Vita-native interface assets
├── vid/ # shared/native MP4 assets
├── first_load.mp4 # first-launch video
└── patcher-report.json # generation report
Each chapter can contain its own GameMaker data and prepared texture assets. For example:
chapter3/
├── data.win
├── lang/
├── pvr/ # validated BC3/DXT5 prepared pages
├── texture-cache/ # RGBA4444/other prepared cache pages
├── vid/ # chapter-local video files, when required
├── texture_manifest.json
└── ... # chapter-specific audio/configuration assets
Language/mod packages mirror only the paths they replace under mods/Lang/<Language>/. See Mods and Language Packs for a complete example.
Save data is kept separately so replacing/regenerating ux0:data/deltarune/ does not require deleting normal progress:
ux0:data/deltarune_saves/
├── trophies.ini # DeltaruneVita local trophy progress
├── true_config.ini # when created by the game/runtime
├── dr.ini # when created by the game/runtime
└── DLTR00000/ # chapter/save data created by the game
└── ...
Actual save files vary according to the chapters/slots that have been used.
When Dev Mode logging is enabled, the primary diagnostic log is:
ux0:data/deltarune/deltarunevita/butterscotch-probe.log
When reporting a reproducible issue, include the relevant log together with the Chapter/Room, selected language, renderer, texture-compression mode, FPS limit and a screenshot/video when applicable.
- Chapter 3's heaviest TV/video/battle transitions can still expose first-use frame drops or memory pressure.
- Chapter 4 and 5's heaviest battle scenes remain under observation for memory pressure.
- Windows 10 or 11;
- PowerShell 5.1 or newer;
- Docker Desktop with Linux containers enabled;
- Git with submodule support;
- an official and unmodified DELTARUNE Steam installation.
Prepare the game data:
powershell -ExecutionPolicy Bypass -File .\scripts\prepare-windows-data.ps1
Build the VPK using VitaSDK through Docker:
powershell -ExecutionPolicy Bypass -File .\scripts\build-butterscotch-probe.ps1
Build the Windows patchers from:
artifacts/Patcher/Build_Patch/Build_Patcher.bat
[!IMPORTANT] Commercial DELTARUNE files must never be committed or redistributed. Releases should contain only the VPK, legal patch data/tools and user-generated output instructions.
DELTARUNE Vita does not emulate Windows and does not execute the original PC executable. It reads the official GameMaker data and runs it through a customized native runner:
Official Steam files
↓
Per-chapter data.win
↓
Customized Butterscotch runner
↓
GameMaker rooms, objects, scripts and events
↓
VitaGL + OpenAL + Vita platform services
↓
PS Vita display, audio, controls and storage
The Vita-specific layer provides Game Settings, physical/touch input, console borders, native video, trophies, loading/cache screens and diagnostics without replacing the game's normal GameMaker logic.
DeltaruneVita supports alternate game data and external assets through the deltarunevita/mods tree. In v0.81, this includes both the language-pack pipeline and the Animated Borders mod:
- Animated Borders Mod (
mods/bordersanim/): A PS Vita-exclusive mod providing smooth animated side strips (frames_side.bani) for 55 rooms, featuring a 24-pixel linear transparency gradient (feathering) over the static full-screen border with minimal memory footprint (< 768 KiB VRAM). - Language Packs (
mods/Lang/): English and the game's native Japanese mode use the original data. Optional v0.81 language packages are available for: - Portuguese (Brazil) — updated with Chapter 5 translation by TEIARRUMA
- Spanish
- French
- German
- Russian
- Turkish
Both DeltaruneVita Patcher and Seam's Patcher use the same language catalog and validate downloaded packages by file size and SHA-256 before applying them. The packages are kept separate from the GitHub Release assets and are served through the project's gh-pages catalog.
[!IMPORTANT] A translated
data.wincan have a different Texture Page layout from the original game. Keep each translation together with its matching v0.81 texture cache. Do not copy an original-language cache over a translated chapter unless its TXTR layout is known to match.
Language packages are installed under:
ux0:data/deltarune/deltarunevita/mods/Lang/<Language>/
A language only needs to contain the chapters/assets that it overrides. A representative package can look like this:
mods/
├── bordersanim/ # animated border frames (.bani)
└── Lang/
└── Portuguese-BR/
├── chapter1/
│ ├── data.win # translated GameMaker data, when replaced
│ ├── lang/ # chapter-local string assets, when used
│ ├── pvr/ # prepared BC3/DXT5 pages
│ ├── texture-cache/ # prepared RGBA4444/cache pages
│ └── texture_manifest.json # cache/TXTR metadata
├── chapter2/
│ ├── data.win
│ ├── pvr/
│ ├── texture-cache/
│ └── texture_manifest.json
├── chapter3/
│ ├── data.win
│ ├── pvr/
│ ├── texture-cache/
│ ├── vid/ # language-specific videos, when supplied
│ └── texture_manifest.json
├── chapter4/
├── chapter5/
├── lang/ # package-wide language assets, if required
└── music/ # language/mod-specific music overrides, if required
The exact contents differ between translations. Some packages replace a full data.win; others provide strings, music, video or selected chapter assets. The patchers preserve this per-language separation so incompatible atlas indices and caches are not mixed.
For development/preparation work, source translations can be staged under data/prepared/deltarune/deltarunevita/mods/Lang/<Language> and processed with the project's preparation scripts. End users should normally let a v0.81 patcher install the matching language package automatically.
| Version | Key changes |
|---|---|
| v0.69 | Adopted validated BC3/DXT5 prepared pages, improved room/audio transitions, fixed multiple Chapter 2/3/5 softlocks/crashes, compressed borders and introduced broader language-pack support. |
| v0.70 | Added the trophy system and initial 60 FPS compatibility work, corrected Spanish language handling and expanded PT-BR atlas optimization. |
| v0.71 | Introduced the room-aware Texture Page rebuild, DeltaCache-based prepared pipeline, local BC3 fallback generation, expanded Game Settings and additional rendering/audio/memory fixes. |
| v0.72 | Added the native SceAvPlayer video backend, embedded first-launch video, further translation compatibility and Chapter 3/5 video/memory work. |
| v0.73 | Public release consolidating v0.70-v0.72 work with DeltaRepack + DeltaCache, the optional loading mini-game, updated patchers/language packs, trophy refinements, room-aware memory improvements, native video/audio fixes and broader Chapter 3/5 stabilization. |
| v0.80 | Major architectural milestone introducing the native VitaGXM (libgxm) renderer backend, rewritten Texture Page pipeline, memory management overhaul and initial C engine fastpaths. |
| v0.81 | Hardware VSync at locked 30 FPS (eliminating the 15 FPS pacer delay), native C fastpaths for Chapters 4 & 5 (floortex, cliffs, tower), animated borders mod with feathering, Soft/Medium/Aggressive CRT filters, Mike mouse & mic controls (Ch4), resolved duplicate TP bar & diagonal petal transition (Ch5), interactive Prologue, DualShock 4 glyphs, and new Seam's Patcher Lite/Offline. |
For the development history and individual internal builds, see docs/ and the repository's Releases.
- Butterscotch — open-source GameMaker runner used as the foundation of the port.
- VitaGL — hardware-accelerated rendering on PS Vita.
- VitaSDK — Vita homebrew toolchain.
- UndertaleModTool — GameMaker data inspection, patching and validation.
- Butterscotch DataWin — GameMaker data-format reference.
- FFmpeg — media inspection/conversion during development.
- PVRTexTool — texture-format preparation and validation.
- PSDevWiki — Vita platform documentation.
- DELTARUNE by Toby Fox and the DELTARUNE team — official website.
- Butterscotch and its contributors.
- VitaGL by Rinnegatamante.
- VitaSDK and the PlayStation Vita homebrew community.
- DELTARUNE PT-BR Translation by TEIARRUMA and contributors.
- Community localization teams responsible for the optional language packages.
- Niccbilac for additional controller artwork used by Game Settings.
- MrPowerGamerBR for technical references shared with the GameMaker porting community.
GPT-5.6 Sol through Codex was used as a development assistant for diagnostics, implementation support, project organization and technical documentation. Gemini was used during development of Seam's Patcher. All changes remain subject to project review and real-hardware testing.
Butterscotch is distributed under the Mozilla Public License 2.0. Modified MPL-covered source files in this project remain available under the same license, with their copyright and license notices preserved. See LICENSE and the corresponding source files for details.
DELTARUNE, its characters, music and assets belong to their respective owners. This project does not distribute the commercial files required to play the game.
DELTARUNE © Toby Fox 2018–2026. All rights reserved.
Steam and the Steam logo are trademarks and/or registered trademarks of Valve Corporation.
PlayStation and the PlayStation family marks are trademarks of Sony Interactive Entertainment LLC.