ResourceToggle

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 the gpu mode 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.