VH Accelerator

VH Accelerator

Spend less time waiting for a large Vault Hunters client or server to start,
and give your server back gigabytes of memory.

VH Accelerator is a performance mod for Minecraft 1.18.2 Forge. On clients it
reduces launch and multiplayer-login work in large Vault Hunters Third Edition,
Remastered and Wolds Vaults packs. On dedicated servers it cuts startup time and
memory use. The same jar works on both, and each side works without the other.

New in 1.2.0: dedicated servers. In paired tests, server startup was 24%
faster on a large production pack and 32% faster on Wolds Vaults 0.34.3, with
39% and 23% less memory used after starting. Before release it ran on five live
servers through many restarts with no crashes. 1.2.0 also fixes rare
startup crashes and hangs, and adds an operator-only Server tab to the
settings screen. See the
1.2.0 release notes
for test conditions and limits.

It builds on guarded deferred model loading, lower menu memory use, faster warm
launches and world joins, and targeted fixes for JEI and model compatibility. It
has been exercised with Remastered, Asgard and Wolds Vaults 0.34.1 and 0.34.3.

It does not remove recipes, models, or gameplay content. Independent work is
prepared in parallel, deterministic results are cached behind strict
fingerprints, and completed data is published back to the game on the correct
thread. Dynamic models and other unsafe work stay on their normal path.

What it improves on servers

• Dedicated-server startup time, through indexed registry and recipe-removal
  work (KubeJS, CraftTweaker, LootJS), parallel resource indexing and
  on-demand setup of data the server may never need.
• Server memory: Vault loot tables, Building Gadgets templates and WorldZones
  memberships are stored compactly, equal AE2Things disk strings are shared,
  and finished Mixin class data is compressed.
• Startup stability: guards against races between mods loading in parallel
  (registry writes, Forge holders, the EventBus listener cache) and a reload
  race that could hang startup.
• A Server settings tab for operators (permission level 4), checked by the
  server on every request.

What it improves on clients

• Client startup, including model, blockstate, texture-atlas, and resource
  preparation.
• Multiplayer login and server/world transfers, including JEI search and
  recipe preparation.
• Repeated launches and connections through validated caches.
• Faster repeated JEI recipe preparation without trusting stale category or
  incomplete recipe-list results.
• Automatic targeted repair when a cached JEI recipe no longer matches the
  live category or output identity.
• Post-login responsiveness by keeping unfinished background work away from
  the first playable world frame.
• Testing and troubleshooting through a compact main-menu launch timer and
  optional login, transfer, post-login, and disconnect measurements.
• Main-menu update notices with occasional clickable CurseForge reminders.
• Critical update notices are shown by default. Players can opt into all
  update notices through the client config or /vha updates all.
• An immediate opt-out for update checks through the client config or
  /vha updates off.
• In-world JEI recovery when a synchronized recipe or ingredient is missing
  only from JEI’s visible lists.
• Large-pack model loading through guarded CTM, generated-model,
  voxel-shape, Vault loot, and optional FerriteCore improvements.
• Deferred baking for eligible plain models and validated warm graph skipping;
  custom and dynamic models retain their guarded loading path.
• Reduced menu memory from compact JEI indexes and version-gated model caches.

The mod includes targeted compatibility for Vault Hunters, Wolds Vaults, JEI, JEITweaker,
CraftTweaker, JER, Powah, Thermal, Iron Furnaces, Industrial Foregoing, Xaero’s
maps, Sophisticated Storage, Every Compat, and ModernFix. Optional integrations
activate only when the matching mod and supported class layout are present.

Improvements since 1.0.0

• Expanded the universal jar to newer official and Remastered Vault versions,
  both supported JEI generations, and Wolds Vaults 0.32.2, 0.33.0 and 0.34.1.
• Hardened dynamic model and texture handling for Vault gear, Sophisticated
  Storage placeholders, Vault workstations, Curios, Comforts, and generated
  Every Compat content.
• Added /vha reload_jei so players can rebuild JEI from the currently
  synchronized recipes and tags without disconnecting.
• Corrected persistent JEI recipe caching so late recipe batches cannot hide
  normal crafting-table recipes, while keeping the warm-login speedup.
• Added live category and output checks that repair only affected cached JEI
  recipes, including transient Sophisticated Storage wood identities.
• Added an off-by-default JEI recipe audit command for troubleshooting cache
  repairs without enabling all debug profiling.
• Hardened early startup mixins against unusual class-loading order and added
  build checks that prevent the same startup failure class from returning.
• Reduced repeated CTM, model-registry, voxel-shape, asset-fingerprint, and
  recipe preparation work in large packs.
• Reduced speculative client data-migration warm-up, accelerated Vault’s
  tiered-loot setup, and added safe learned table sizing when FerriteCore is
  installed.
• Reduced repeated Forge registry, resource-pack, language, ingredient,
  world-generation, and allocation work through guarded ModernFix-derived
  backports.
• Lowered normal-play diagnostic overhead by omitting diagnostic-only mixins
  when debug mode is disabled at startup.
• Corrected unsafe Target Dummy dispenser registration for the supported
  1.18-1.5.2 build without affecting packs where that mod is absent.

Compatibility

• Minecraft: 1.18.2
• Mod loader: Forge 40.3.11 or newer in the Forge 40.x line
• Environment: Clients and dedicated servers; pack-specific checks and limits in the 1.2.0 release notes
• Vault Hunters: Remastered 20.0.3-remastered, .6872, and .6883;
  official 3.21.5.6882 and
  3.21.6.6884; Wolds Vaults 0.32.2 (3.21.5.6573), 0.33.0, 0.34.1 and
  0.34.3 (3.21.6.6884);
  custom MVP 3.21.62
• JEI: 9.7.2.1001, 10.2.1.1006, and 10.2.1.1009

The Vault and JEI versions above are tested compatibility baselines, not hard
dependencies. One VH Accelerator jar contains guarded support for both JEI
generations and all listed Vault layouts.

VH Accelerator supports clients and dedicated servers. Dedicated-server
checks cover startup, heap, recipe reload equality and selected save/restart
paths in the tested packs; no general loaded-server TPS gain is claimed.
Clients can use it without installing it on the remote server, and servers
can use it without players installing it.

If you run Wolds Vaults, update Wolds to a release with its own Rampage fix;
VH Accelerator’s old workaround for it was removed in 1.2.0.

Installation

1. Stop Minecraft.
2. Disable or remove older VH Accelerator jars.
3. Disable LaunchFaster, Lightspeed, and VHClientOptimize because
   their loading changes overlap VH Accelerator.
4. Put VH-Accelerator-1.2.0.jar in the instance’s or server’s mods folder.
5. Launch once to create the configuration and cold caches.
6. Use later launches and connections when judging warm-cache performance.

ModernFix is optional. If it is installed, VH Accelerator detects overlapping
features and selects one owner. Its guarded model pipeline can take ownership
of ModernFix dynamic resources when that option is enabled.

Settings screen

With Cloth Config (Forge 6.5.102 or
newer) installed, every VH Accelerator setting can be changed in game. Bind Open VH Accelerator
settings in Options > Controls; it is unbound by default. Settings are grouped into tabs with a
plain-English explanation for each, and a (restart) badge on the ones that need a restart. Cloth
Config is optional: without it VH Accelerator works as before and the settings stay in the
config files.

Server operators with permission level 4 also get a Server tab that reads and changes the
connected server’s settings. The server checks the player’s permission and every value on each
request, and logs each change. Other players do not see server controls. Servers and clients
without the matching VHA version still connect normally; the tab then explains that server
settings are not available.

Timers and commands

The compact main-menu launch timer remains visible by default. Routine chat
timers and detailed debug profiling are disabled by default.

Each setting also accepts status, and /vha compare, /vha timers,
/vha debug, /vha jei_audit, or /vha updates reports that setting without
changing it.

These are client commands in multiplayer and do not require the mod on the
remote server. Server operators can also run /vha dump blockshape to export
block-shape diagnostics. /vha reload_jei requires an active world or server connection
and may pause the client briefly while JEI rebuilds.

First-run expectations

The first launch or first connection after a relevant mod, resource-pack,
configuration, registry, recipe, or server change may be slower because VH
Accelerator must validate or rebuild affected caches. Invalid cache data is
never trusted; the original loading path is used and the cache is replaced.

For a useful comparison, run at least three warm launches or connections and
compare the median. Login time also includes network delay and server tick
load.

Credits and source

VH Accelerator was independently implemented by
HoYin1600p. Early discovery was inspired by
LaunchFaster by DogV2 and
VHClientOptimize by
JustAHuman.

Just Enough Threads, Lightspeed, ModernFix, DashLoader, newer Minecraft model
pipelines, BuildScape, Loading Profiler, FerriteCore, ImmediatelyFast, C2ME,
Krypton, Fastload, Ksyxis, Forge, Mixin, JEI, and compatibility-target projects
also informed research and testing. The
complete credits
explain each influence.

• Source code and issue tracker
• Full installation guide
• Configuration reference
• License: LGPL-3.0-or-later for post-1.0.13 development. Releases through
  1.0.13 retain their originally published MIT terms.

No third-party mod jar is bundled. ModernFix-derived backports retain their
required license, copyright, source, and commit references in the public
repository. Minecraft is a trademark of Microsoft. Vault Hunters belongs to
its respective authors. This independent project is not affiliated with
Mojang, Microsoft, Forge, Iskallia, JEI, or the credited projects.

The project icon is original AI-assisted branding and is not an in-game
screenshot or a modified official Vault Hunters logo.