ResourceToggle
A client-side Minecraft 26.2 mod that lets you instantly toggle all non-vanilla resource packs in-game for testing/debugging.
Features
- Toggle button on the title screen and pause screen (top-right corner).
- Hotkey in Controls → Misc (unbound by default).
- Action bar feedback on switch.
- Server never sees the switch: packs are always accepted, downloaded and reported as applied to the server (including required server packs); only the rendered resource stack switches. No packets are sent, no repository selection is changed.
- Three switch modes, configurable in
config/resourcetoggle.json:
| mode | behaviour |
|---|---|
gpu |
Both resource stacks are pre-loaded; the switch keeps the alternate stack warm in memory and only re-uploads to the GPU. |
ram (default) |
Both stacks are cached in RAM; switching never touches disk/zip/network again after the first warm-up. |
on_demand |
A regular vanilla-style reload on every switch (lowest memory use). |
In ram/gpu mode the first switch in a session is still a full load; every
following switch is served from memory and should be noticeably faster than a normal
F3+T reload.
Note on "instant": 26.2's new render pipeline (Vulkan/GL render graph,
RenderPipeline, atlas re-upload on apply) re-uploads textures during the reload's apply phase regardless of what the mod does. Keeping two fully live render graphs simultaneously is not practical, so thegpumode provides the warm-stack + minimal-GPU-work switch rather than a true zero-cost pointer swap.
Config
config/resourcetoggle.json (created on first run):
{
"mode": "ram",
"keepLoaderPacks": true,
"toastOnToggle": true,
"extraKeepPacks": [],
"extraExcludePacks": []
}
mode:"gpu","ram"or"on_demand".keepLoaderPacks: keep mod-provided assets in vanilla-only mode (required for most mods to render).extraKeepPacks/extraExcludePacks: force packs in or out of the vanilla-only stack by pack id.toastOnToggle: show the action-bar message on switch.
Building
Requires JDK 25.
./gradlew build
Output: build/libs/ResourceToggle-1.0.jar — works on both Fabric and
NeoForge clients. Drop it into the mods folder. No Fabric API or other mods required.
