Tool HTML TwineForge/TwineHacker Updated

[ErDrago]

TwineForge — MV3 Tool for Twine (SugarCube)​

TwineForge is a browser extension for inspecting and editing SugarCube/Twine variables in-page. It is an updated and improved version of the old TwineHacker tool that no longer works. It has new UI, built in search system, cleaner desing and with more updates coming soon!

Github link -

You must be registered to see the links

What it does

• Injects a small inspector UI into pages running Twine/SugarCube so you can view and edit State.variables / globals easily.
• Provides a helper to list custom globals.
• Works with local Twine HTML files (enable file access) and sites hosted on localhost.
• Minimal permissions — it uses activeTab + limited host permissions (file and localhost). You must click the toolbar icon (or use the keyboard shortcut) to inject the tool into an arbitrary page.

Installation (Chromium-based browsers: Chrome/Edge/Brave)

1. Open chrome://extensions/.
2. Turn Developer mode ON.
3. Click Load unpacked and select the extension folder (the folder that contains manifest.json).
4. After adding it, click the extension entry → Details → Allow access to file URLs (if you want it to work on file:/// Twine files).
5. Optionally pin the extension to the toolbar for quick access.

How to use

• Open your Twine/SugarCube HTML file in Chrome
• Click the TwineHacker icon in the toolbar (this gives the extension temporary activeTab access and injects the UI).
• Or use the keyboard shortcuts:
  • Ctrl+Shift+H — inject TwineHacker UI into the active tab
  • Ctrl+Shift+R — reset position if stuck off screen
• After injection, an inspector UI will appear (or the UI will create a small overlay) where you can view and edit variables. Editing is immediate; be careful — changing variables can break game logic.

If the game is embedded in an <iframe> (e.g. some itch.io embeds): Right-click the game → Open frame in new tab and run the extension there.

Permissions & Privacy

• Permissions used:activeTab, scripting, storage. Host permissions limited to:
  • file:///* (optional, disabled unless you toggle it in extension details)
  • -http://localhost/*
  • -http://127.0.0.1/*
• Privacy: The extension runs entirely in your browser. It does not send any data to external servers. It only reads/modifies variables in the page where you run it. If you are uncomfortable granting file access, run your Twine locally through a small local server (e.g. python -m http.server) and use -http://localhost instead.
• Why limited hosts? To reduce privacy concerns and make the extension acceptable for users — the extension will not automatically inject into every site; it injects when you click the icon or use the shortcut, and only on local files or localhost by default.

Troubleshooting

• Icon is grayed out / doesn’t inject: Make sure you clicked the extension icon at least once to grant activeTab permission. If using file:///, enable Allow access to file URLs in extension details.

Credits
I did not make this all fully by myself. It is heavily based on the one from here https://f95zone.to/threads/how-to-debug-or-cheat-twine-sugarcube-variables.6553/post-314996 because it is no longer working on MV3. Though not that much is still in common with that version cause almost anything was rebuilt/upgraded.

Download here:

TwineForge (Updated, cleaner version with better UI, more functions, skins, resizing, easy updater and active development. More updates on the way!) -

You must be registered to see the links

TwineForge Skins​

Spoiler: TwineHacker Updated (Obsolete)

You don't have permission to view the spoiler content. Log in or register now.

 

[Rezzbin]

looks like it works for light use in my case as the minimum, shortcuts don't seem to work for me, but clicking the extension did.

but....uh.....how are you supposed to get RID of it? after trying various random things, the ONLY thing that seemed to work for me, would be to just refresh the page, which in my case wasn't a big deal, but a number of HTML games could have saving issues that would make this kind of really annoying to deal with if you can't close the window?

think the other Twinehacker works well for this, since even if you didn't get rid of it, you could easily minimize it to the corner so it wasn't in the way.

i've only used this for like, 5 minutes, but wanted to give this feedback so far of what worked and what didn't.

 

[ErDrago]

looks like it works for light use in my case as the minimum, shortcuts don't seem to work for me, but clicking the extension did.

but....uh.....how are you supposed to get RID of it? after trying various random things, the ONLY thing that seemed to work for me, would be to just refresh the page, which in my case wasn't a big deal, but a number of HTML games could have saving issues that would make this kind of really annoying to deal with if you can't close the window?

think the other Twinehacker works well for this, since even if you didn't get rid of it, you could easily minimize it to the corner so it wasn't in the way.

i've only used this for like, 5 minutes, but wanted to give this feedback so far of what worked and what didn't.

Thanks very much for your feedback! I guess I was making this mostly for what I needed and I never thought minimalizing it will be useful so that's why I haven't added it. But now I see that it might be indeed useful for some people so I will gladly add it.

And regarding buttons is that Google doesn't really like to allow buttons to be programmed by creator if extensions isn't released on Chrome Web Store because of safety reasons and I had many problem with trying to manually implement them... Sometimes they work and sometimes not. If they don't work they need to be set manually.

If you had any other ideas or feedback feel free to share cause I guess I added all I needed so I would gladly add more options that others will find useful!

Update - added min/max option as requested, should work but in case something buggs please tell me ;p

 

[Rezzbin]

currently, only the minimize/close option, and the shortcut come to mind. I believe you already had a search function, a pin function which would be the other things I can see helping here.

you already explained that the shortcut is more of a browser safety limitation, so unless it ends up on the webstore, not a big deal either way.

the ONLY other thing that comes to mind, and this is entirely people's personal preference, I've seen a number of text box selections where you have an input, where on the 1st click on them, will highlight the existing field, so this way you can remove a step or two of select all, then overwrite them.

not sure if this is worth thinking about? or the extra effort of creating a settings menu to enable this function as a checkbox?

it's entirely peoples personal preference without effecting the core function/mechanics of the program, but it's the only other thing that comes to mind so far. otherwise, I personally don't believe that HTML games require all that much function for cheat plugins like this, since really you just have to be able to find and edit a few key variables, like stats and money. trying too hard on flags and events.....will probably just ruin things for like, 90% of users, so I don't feel would even be worth considering more advanced functions like that, so it does what it needs to well, and that's the key part IMO.

 

[Your Friendly Bros]

I can't edit the values on the pinned field, but I can do it fine in the gamestate field. Can you fix it?

 

[Rattley]

Are there any plans to make this for FireFox too? And if not, is there a way I could manually convert it myself? I have no real programming experience but I am good at following instructions/a tutorial. I am not asking for you to tell me how to do it, but if you know somewhere online that could explain how, that would be great.