SugarSplicer

Free & open-source (MIT). Pay what you want — or nothing at all.

---

Most mod patchers for Twine games are like using a sledgehammer to hang a picture frame: messy, prone to breaking things, and all too happy to corrupt your multi-megabyte HTML file because they rewrote the whole thing from scratch just to change one line.

I built SugarSplicer because I wanted a scalpel instead.

---

What makes it different

SugarSplicer never re-saves your game. It builds a one-pass byte-offset index to find exactly where a passage lives, snips out the old code, and splices in the new — leaving every other byte untouched. Your original file is never modified; the app always writes a fresh, patched copy, so you can’t accidentally ruin your install.

---

Key features

• Fail-loud by design. If a mod would break your game, SugarSplicer tells you before it writes a single byte. It flags crossed macro nesting, unclosed macros, and the classic one-bracket typo (<<if> instead of <<if>>).
• Smarter matching. Whitespace-flexible matching plus full regex support means a mod won’t shatter just because a game update added a space or a newline.
• Conflict reports. Stacking a pile of mods? The Dry Run produces a full report of exactly where mods step on each other — overlapping edits, load order, missing dependencies — before you apply anything.
• Deep JavaScript support. Go beyond text: hook into existing functions with before/after logic, inject new ones, replace whole functions, or edit code inside them — all without clobbering the original.
• Legacy-friendly. Reads modern JSON mod manifests and most legacy .mod directives — and clearly flags anything it can’t apply instead of failing silently, so nothing breaks behind your back.
• Nothing to trust blindly. It ships as plain, readable Python — no compiled .exe, nothing to make your antivirus panic. Read every line before you run it.

---

Requirements

• Windows
• Python 3 — free from python.org. During setup, tick “Add Python to PATH.”
• Your own copy of the game’s HTML file (any SugarCube / Twine game).

SugarSplicer includes no game content — bring your own.

---

How to use it

1. Install — double-click Install Dependencies.bat once to grab the libraries it needs.
2. Launch — open Launch SugarSplicer.bat to bring up the dashboard.
3. Patch — pick your game’s HTML, load your mods, hit Dry Run to check for issues, then Apply to write your patched copy.

A full mod-template.json (showing every supported operation) and sample mods live in the Examples/ folder.

---

Created by Bean. Released under the MIT License — permissive, open, and built for the community. If it saves you a headache, a tip is appreciated but never expected. Created after a ton of back and forth with myself, Gemini, and Claude, started as a personal project.