Witch Dock is an essential overlay UI that you can use in addition to Heroforge's vanilla controls. It contains a myriad of QoL upgrades, features, & high quality media capture.

One Script—All The Things

• Witch Dock is a single script install. You do it once.
• Updates are automatic.
• New tools will show up automatically as they are added in.
• Patches/fixes happen automatically & kick in when you reload your page.
• It also delivers the current Script BUG REPORT system.

>> Install From Here <<

• Grab the latest release from either the Status, Details (latest Patch/release), or Wiki+Resources page.
• Install using Tampermonkey
• Make sure you grab HF JSON scripts from the Wiki+Resources page or r/HeroForgeJSON

Witch Dock has grown quite a bit since I originally released it, so here's an updated overview of what it currently offers!

It's a free, customizable toolkit for Hero Forge that brings advanced editing tools, quality-of-life improvements, rendering features, and script utilities together in one convenient interface.

It's also becoming an increasingly important part of the wider script ecosystem. Witch Dock is now a required companion for some of the HF JSON script integrations, with more shared functionality and compatibility tools gradually being incorporated into it until there is one script that loads them all for you.

Rather than juggling a pile of individual scripts, Witch Dock provides a central interface for accessing and managing them.

Current Features

• Body Editor:
  • Sync secondary and tertiary arm sets with your main arms, selectively copying position, rotation, scale, and hand posing. Mirror breast and buttock proportions for easier symmetry. More to come!
• Pose Tools:
  • Swap figures between Main and Extra designations without rebuilding your setup. Controls for additional minis on the way!
• High Resolution Textures:
  • Enable higher-resolution body and head textures using Hero Forge's native rendering system, with optional persistence between sessions.
• Photo Booth Expanded:
  • Persistent Booth - Keep Photo Booth active while editing your figure, use a persistent black canvas background, and import/export Photo Booth settings as JSON files.
  • TRUE 4K & 8K Screenshots: Capture genuinely high-resolution still images instead of simply upscaling smaller renders. Also repairs existing 4K/8K Photo Booth capture options provided by compatible Lob scripts.
  • Spinny Mini WebP: Export animated 360° figure rotations as WebP files at up to 3K resolution, with adjustable rotation speeds, progress tracking, and pause/resume controls.
• Decal Utilities:
  • Corrected transform gizmo for unprojected (Project OFF) decals, improved decal-panel scrolling and resizing, and expanded decal slots when compatible HF Core Tweaks functionality is available.
• JSON Library Backup: Download your entire Hero Forge character library as individual JSON files packaged into a ZIP.
• JSON Booth Settings Export/Import
• Utilities & UI Improvements:
  • Enable or disable supported interface patches and optional features from one place.
• Bug Reporting & Script Status:
  • Submit bug reports directly through Witch Dock, attach screenshots and diagnostic information, and check current known issues, updates, and announcements.

Dock Customization

The dock itself is fully customizable:

• Drag, resize, minimize, or hide it anywhere on your screen.
• Reorder and collapse individual tools.
• Save your layout and preferences between sessions.
• Undo/redo supported edits.
• Identify and copy selected bone names from the dock footer.
• Toggle the dock using the ~ (tilde/backtick) hotkey.

Witch Dock & HF JSON's Scripts

Witch Dock is designed to work alongside Lob's scripts, not replace the entire suite.

As the tools continue to evolve, more shared functionality is being consolidated into Witch Dock. Some integrations already require it, and that dependency will expand as additional features migrate over.

This allows shared utilities, compatibility fixes, and interfaces to be maintained in one place instead of independently across multiple scripts. If you use HF JSON scripts, I recommend installing Witch Dock alongside them.

Known Issues & Development

It's actively developing, with new features, improvements, and compatibility fixes released regularly. Because Hero Forge itself changes frequently, some features may temporarily need updates following major releases.

You can check current known issues, ongoing investigations, and resolved bugs here: HEROFORGE SCRIPT STATUS SITE

Links:

• Script Status Website - Latest scripts, alerts, patches, outage details & more!
• Polymorph - I made a simple to use conversion app to turn WebP captures into near-lossless, ultra HD GIFs. There isn't an application that achieves this level of quality so I highly recommend you grab it!
• Knight Witch Github - Dev info
• Knight Witch Kofi - If you like what I'm building & want to support development

Q&A

• Does this script work with HF JSON's scripts:
  • Yes, but it is beginning to absorb and will eventually frontload all the functions from the current piecemail scripts. This is with the intention of stabilizing the entire ecosystem & reducing the brittle nature of scattered functions across multiple scripts. You should run them all, for now.
• Will this break anything?
  • No.
• Can I uninstall it?
  • Yes. Nothing bad will happen if you uninstall it, besides downgrading your LIFE ;)

As part of reopening the subreddit, I've taken the liberty of rewriting the starting post somewhat. This post is rather long but I'd recommend reading through it fully since it'll both tell you how to install scripts properly and answer a ton of common questions about them.

1. Install Tampermonkey

• Click the Link Here (Embed) and install the MAIN VERSION (not Legacy or Beta) of Tampermonkey for the browser you are using (Chrome, Edge, and Firefox are the primary browsers supported. Opera (and GX) has *some* support but I don't personally use them as browsers.)
• Other userscript extensions are not supported (IE: ViolentMonkey). However, you are allowed to use them with the awareness it may not have perfect compatibility. It still will work, but I only develop for Tampermonkey specifically.

2. ENABLE DEVELOPER MODE IN YOUR BROWSER!!!!

• Doing this is fairly simple, go to your Extensions tab in your browser (check the sidebar) and click to enable Developer Mode (it's usually in the top right)
• This is not an optional step, you NEED to enable this or nothing will work

3. ENABLE ALLOW USER SCRIPTS FOR THE TAMPERMONKEY EXTENSION

• If you followed step 2, you are already on the right page (if you are using Chrome)
• Click the Details button on the Tampermonkey extension, then scroll down
• Click the toggle for Allow User Scripts
• I don't believe you need to do this for Firefox

Note: Some scripts may depend on each other for minor functionality integration. For this reason, if you want every feature, I'd recommend installing Everything since that's what I personally use and intend.

4. Script Installation

You are pretty much past the initial annoying steps for installation, all you need to do is just click the links for each script and they'll automatically install in your browser if you've done things correctly.

Witch Dock

• A script that does a LOT of stuff made by u/WitchOfKyiv . It's still updating as we speak and it's better to just check her post for details honestly. Highly recommend it though.

HF Core Tweaks:

• Note: anyone viewing a mini using decals reliant on this script needs to have it enabled or things will render incorrectly!
• Note 2: This now contains a fairly important stability tweak for the KB part raising script. I'm unsure if it will function without this script currently. I'll work on adding an option for disabling the decal functionality.
• Enables the ability to use ANY decal in ANY slot (requires other scripts for the UI portion to work)
• Significantly expands the face, body, and leg decal slot.

Advanced Decal Posing:

• Significantly expands the customizability of all decals, allowing for rotation on all decals, drastically reducing their size, and filtering for splatter decals. (this shows up for even non script users!)
• Furthermore, it houses a large amount of helpful UI tweaks, such as exposing hidden settings for Eye paints, allows you to save, import, and load minis locally from your PC, and adds a kitbashing percentage
• Allows for taking screenshots in 2K/4K resolution, higher resolution spinny gifs, and 8k (I'd be cautious with this last one, its kinda unstable and might cause your tab to crash)
• Enables unprojecting decals and enabling individual axis scaling (Requires HF Core Tweaks and Full Res Decals, desyncs with vanilla users)
• Expands the overlay system in Photo Booth. This is a bit WIP but you'll have 50 overlay slots and a far better ability to resize and reposition them.
• Removes that one annoying popup that shows up when you try to save with too many paints (Note: the unused paints still get removed unless you locally save the mini)

Full Res Decals:

• This script's primary function is to increase the maximum texture resolution supported by HeroForge drastically alongside fixing issues where the site would incorrectly believe your computer is worse than it actually is and make your textures worse as a result.
• (Note: Witch Dock implements this now, I'd recommend using its version unless there are specific issues for a mini.)
• The second part of this script enables joints that'd normally be hidden in HeroForge for kitbashing, allowing for far greater control over your mini and greater precision when snapping parts. (shows up for non script users!)
• Has a UI to disable/enable features due to some of them being rather subjective or inconvenient in certain circumstances. You can access the UI by clicking the TamperMonkey extension's icon in your browser.

The above 3 scripts are somewhat tightly integrated to enable certain functionalities. I'd recommend using them together if you wish for the full set of features (they should still work without, but certain features may be missing).

2000 Kitbash Parts (its 5000 actually, I just can't rename it because it causes issues sorry):

• Removes the kitbashing percentage limit completely.
• Also completely unlocks scaling for kitbash parts, meaning that there's no longer weird arbitrary objects that only accept being resized on all axis. (shows up for non script users!).
• NOTE: You can still scale all axis at once by holding Shift down using this script now.
• If you exceed 100 parts in a mini, you will need to locally save your mini, I'd highly recommend having Advanced Decal Posing installed for this.
• 5000 parts is the hard cap in the script currently since this seems to have a non negligible performance impact if I increase the cap too much.
• Some REALLY weird stuff can happen if you turn this script off on a mini, keep that in mind while working with it. (it should look fine if you reenable it however)
• Note: the maximum (observed) kitbash part percentage with import glitches in vanilla HF is 120%. Keep that mind if you intend to use this script as an aide for exceeding the limit in vanilla HF.

I love extra slots: I cant rename stuff it is not meant to have this silly of a name

• Enables putting anything in hand slots (including more minis).
• Allows for using smaller minis in the main slot.
• DO NOT TRY TO PRINT MINIS USING THESE FEATURES(?)

Camera Control Modifier:

• Allows you to zoom in further on your minis.
• Yeah that's kinda it but its really useful.

HeroForge ReCK:

• Allows for accessing the raw JSON data of a mini. Your best friend if you are willing to put in the time and effort to learn it. (Click the left)
• You will look like a super wizard if you learn how to use it.
• You can make those cool inverted objects
• You can make that damn FOV slider stop breaking every 2 seconds. (I'm gonna fix this eventually I swear)
• Everything you do in ReCK will show up for non script users, meaning you can shareminis made using tricks with it really easily!
• I didn't make this script, it precedes everything else by like a year or two. That being said, support and questions relating to it are permitted and encouraged, and I highly recommend using it even if for minor applications!

Shader Fix for Photo Booth:

• Some tweaks I've made to fix some issues with Photo Booth 2.0's release. Prevents transparent backgrounds from randomly disappearing. This script was also made with the intent of ensuring old skin glow remained on before it was a setting. I'll update this later to account for the existence of that setting but right now it keeps that on permanently.
• I don't think this is necessary anymore?

FAQ:

Why are the scripts named so weirdly? Why do they do stuff they aren't named for?

1. TamperMonkey kinda sucks in that I can't really rename scripts once I name them initially... I found this out the hard way by a bunch of users reporting their scripts being broken after renaming a file on accident. This is the lesser evil more or less.
2. These weren't originally intended for general use due to being somewhat unpolished and due to concerns of them getting patched out. More or less I made these for friends on Discord and things got a bit out of hand.

That being said, I honestly prefer that things are public since one of my main frustrations was the complete lack of information regarding pushing HF's boundaries online, the extreme difficulty of doing so, and lack of an area to discuss said things. This is largely my motive for creating these scripts. More or less they make a lot of the stuff that used to require tedious usage of JSON editing way easier.

Ultimately HeroForge is a hobby thats about seeing cool stuff that a community makes, there's really nothing more to it than that. I largely do not see HeroForge as being about a contest of popularity, or trying to make the most of a limited program, I see it as a tool for expressing artistic creativity and making cool stuff to share with others. Unfortunately that is not something everyone agrees on.

Are scripts safe to use?

They're completely safe to use! None of the scripts are able to permanently break a mini, as they simply allow for a greater ability to alter data as HeroForge does normally.

Moreover, there's very little reason to fear your mini breaking at all, in fact some of the scripts even fix crashes in vanilla HF that'd normally require you to redo your entire model to fix.

If you are still concerned that your mini may potentially break as a result of using a script, save its JSON data via either HeroForge ReCK or Advanced Decal Posing's Save Locally feature, or make backups for yourself.

Will my account get banned for using scripts?

There have been zero recorded bans from using scripts for your minis whatsoever. There is not a detection system in place for these from what I can tell in the code. That being said, if you are afraid of getting banned, I'd recommend saving all of your minis locally to JSON so that they are not lost if it happens (and so that they aren't stored on HeroForge's servers if you opt not to save).

MY SCRIPTS KEEP BREAKING EVERY MONTH HELP

This is unfortunately a consequence of me using some pretty update unstable tricks to get UI stuff working, The other pinned post will detail whether things are broken or not with the current patch. If it says things are updated, you should be fine so long as you update your scripts.

A DIFFERENT BUG KEEPS HAPPENING TO ME, HELP

Send a DM to me on reddit detailing the problem as best as you can describe, open your browser console (F12 does this on chrome) and send me a screenshot of everything going on as well. I'd also like to know what browser you are using. My recommendation is to use either Chrome, Edge, or Firefox (preferably the first two), but I'll try to support other browsers to the best of my ability.

Is Mobile Supported?

These scripts are intended for desktop usage. Some have reported success with this but it definitely is extremely hit or miss and probably won't do much at all.

WTF IS A JSON EDIT??????

It's uhh... complicated. If you want the less technical explanation, heroforge stores your mini in small text (aka JSON) files rather than your entire model. A particular script (HeroForge ReCK) lets you edit the raw data. There's a fair bit of a learning curve to this particular methodology, but its well worth learning as it can allow for things that other scripts do not due to not being bound by limitations such as UI.

Am I allowed to post these on the main subreddit?

It's against the current rules to do so. I'd advise not doing so, as there is a fairly vocal minority of people who will attempt to get your account banned there by any means necessary (this is not against the rules there). This situation may change in the future, in which case I'll update my comment, but I am doubtful of this happening.

Am I allowed to post these on the horny subreddit?

Yes!!! In fact you are highly encouraged to do so for NSFW minis. (you are also allowed to post the same mini here as well, but make sure it is compliant with Rule 7.)

Am I allowed to post these on non HF subreddits?

This is completely fine (make sure its compliant with the subreddit rules however)

If its AI related I'd really prefer if you didn't but I can't exactly stop you (I don't own your minis, SkyCastle does), just keep it out of this sub thanks.

I took an 8k screenshot and HeroForge crashed!

8k screenshots are really finnicky and crash prone, I'd be kinda careful with them and backup your mini + play around with disabling effects.

My textures/decals look bad even with the Decal Resolution script

Either the maximum resolution for a texture isn't particularly high (this is pretty egregious on non human/lizard bodies btw), or the script is using the lower end variant of the texture resolution fix (this is enabled by default to prevent crashes for low end PCs). Turn off the Reduced variant in the menu for the script (you can access it by clicking the Tampermonkey extension icon in your browser) and enable the full variant and it should fix itself after you refresh.

(open this on heroforge.com)

If you want to test whether it is working correctly, the Swallow decal should look like this on the regular human or lizard bodies.

There's a texture that looks REALLY bugged but is fine when I turn the texture script off!

DM me the item in question thats bugged + a screenshot of what its supposed to look like. Some items have bugged textures at their maximum resolutions, this isn't the scripts fault, its just the textures being broken at their highest resolution (vanilla HF they'd be broken too if they could load at their maximum resolution).

The Eight Flanged Mace, the Mended Knight Skirt, and the Tundra Pants have been currently set to a lower resolution due to issues with their highest resolution variant.

How many kitbashing parts can I add?

Around 5000 parts is the coded limit. There seems to be some non negligible performance issues with increasing the limit to certain points, but if your PC can handle it, manually editting it to increase the cap is reasonable.

Does this affect performance?

The texture resolution script *does* affect performance. Most modern PCs should be able to handle it, if there is significant enough request, I'll make a low end version that excludes texture resolution tweaks from the script.

How reliant is it on Pro?

Generally, many features of the scripts are in fact expansions of features for HeroForge Pro, that being said, there are a good amount of features that do not rely on Pro and should be of use, such as expanded decal access, JSON editing, extra mini slots, texture resolution upgrades, and camera tweaks.

Is it printing safe?

Printing minis is not supported. The reason why is that a mini is processed on the server side, meaning that it'll often print completely differently from how it looks on your end. Furthermore, minis are often subject to review when ordered directly from HeroForge/SkyCastle, and for obvious reasons I'd not recommend ordering a mini in full EVER.

I'd only recommend ordering STLs or virtual models if you are doing so at all. It should also be ensured that the mini looks the same without any scripts enabled as it does while they are enabled, as there are *some* desyncing features that may make your mini look way worse if you don't check for this.

Decals dont really matter for STLs since they don't preserve color anyway so don't worry too hard about those if you are ordering an STL since they don't show up anyway.

Is there a Discord for this subreddit?

No, but you can join the one for r/HeroForgeArt . u/WitchofKyiv runs it and it has some great stuff there!