GitHub Vita Lite - Wolff's Store
Code / README | Releases | Issues
WolffsRoom/DeltaruneVita

README.md

32802 bytes · Original / download


DELTARUNE PS Vita

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.


PROJECT STATUS

DOWNLOADS10K RELEASEV0.81
OVERALL PROGRESS81% SOURCEPC/STEAM STATEPLAYABLE


Chapter Status Details Reviewed
Chapter 1
Chapter 1
Playable Everything works perfectly. 100%
[image: Chapter 2]
Chapter 2
Playable Minor performance drops in some rooms. 100%
Chapter 3
Chapter 3
Playable Some mini-game rooms lag on first load.
Generally 30+ FPS afterward. Smooth final battle.
95%
Chapter 4
Chapter 4
Playable Some rooms need more optimization.
Choppy climbing sequence, but smooth final battle.
85%
Chapter 5
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.

SUPPORT THIS AND OTHER PROJECTS _If you enjoy my work, consider supporting the development!_ [[image: Buy Me A Coffee]](https://www.buymeacoffee.com/5rsrt7j4z8f)

INSTALLATION GUIDE

REQUIREMENTS

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.skprx together with a setup where rePatch already provides the same functionality.


HOW TO INSTALL THE GAME

  1. Purchase and install DELTARUNE for PC through Steam.
  2. Confirm that the installation is v0.0.253 and unmodified.
  3. Download Deltarune-v0.81.vpk and the patcher for your PC architecture from the latest release.
  4. Generate the Vita data using DeltaruneVita Patcher, Seam's Patcher or the Web Patcher.
  5. Copy the generated deltarune folder to ux0:data/ on the Vita.
  6. Install Deltarune-v0.81.vpk using VitaShell.

The final path must be:

ux0:data/deltarune/deltarunevita/

DELTARUNEVITA PATCHER

  1. Extract either Deltarune.Vita.Patcher.v0.81.64bits.zip or Deltarune.Vita.Patcher.v0.81.32bits.zip.
  2. Copy the complete Steam DELTARUNE folder into SteamFiles/DELTARUNE.
  3. Run the included DeltaruneVitaPatcher_*bit.exe.
  4. Select optional language packages when offered.
  5. The finished data is written to VitaFiles/deltarune.

SEAM'S PATCHER

Seam's Patcher uses the authentic Seam-shop interface and is available in three forms:

  1. Run your chosen Seam's Patcher edition.
  2. Select a clean DELTARUNE Steam folder when prompted.
  3. Select any optional languages/mods (including Animated Borders and PT-BR v0.81).
  4. Generate the Vita package, then copy its deltarune folder to ux0:data/.

[!NOTE] On iOS/iPadOS, provide the DELTARUNE folder as a ZIP when the browser cannot select a directory directly.


CONTROL LAYOUT

The layout is based on the official PlayStation-style controls with Vita-specific shortcuts for Game Settings and touch features.

DELTARUNE Vita control layout


SCREENSHOTS (PS VITA)

DELTARUNE Vita DELTARUNE Vita chapter selection

DELTARUNE Vita gameplay DELTARUNE Vita gameplay DELTARUNE Vita gameplay

DELTARUNE Vita gameplay DELTARUNE Vita gameplay DELTARUNE Vita gameplay

GAME SETTINGS

Screen settings Audio settings Control settings

System settings Touch settings Developer settings


TROPHIES

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.

NATIVE PS VITA TROPHIES WITH NOTRPDRM

NoTrpDrm allows homebrew applications to use trophy packs through sceNpTrophy by bypassing the NP Communication and TRP signature checks.

  1. Download NoTrpDrm.suprx from the NoTrpDrm Releases.
  2. Copy NoTrpDrm.suprx to the taiHEN directory used by your Vita. ur0:tai/ is recommended when ur0:tai/config.txt is your active configuration; use ux0:tai/ only if that is where your active config.txt is stored.
  3. Add NoTrpDrm under *main in the active config.txt:
*main
ur0:tai/NoTrpDrm.suprx

If your active taiHEN configuration is on ux0:tai/, use:

*main
ux0:tai/NoTrpDrm.suprx
  1. Reboot the Vita or reload the taiHEN configuration.
  2. Launch DeltaruneVita. Newly earned trophies will continue to be recorded in trophies.ini and, 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.


WHAT ALREADY WORKS

Core FeaturesSystem 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

TEXTURE COMPRESSION AND EXTERNAL ASSETS

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:

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.

REBUILT TEXTURE PAGE REFERENCE TOTALS

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.


FOLDER STRUCTURE

GAME DATA

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 AND TROPHY DATA

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.

LOGS AND DIAGNOSTICS

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.


KNOWN ISSUES


BUILDING FROM SOURCE


REQUIREMENTS

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.


BUTTERSCOTCH + VITAGL: HOW IT WORKS

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.


MODS AND LANGUAGE PACKS

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:

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.win can 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/MOD FOLDER LAYOUT

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.


RECENT CHANGELOG

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.


DEVELOPMENT TOOLS AND REFERENCES


CREDITS


AI NOTICE

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.


LICENSE AND GAME DATA

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 official key art

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.