VanillaPlusAdditions

56 small fixes and additions that keep Minecraft feeling like Minecraft. Nothing here adds a new dimension or a tech tree. Each module scratches one itch: the lodestone compass stops forgetting its target, a fed cat guards your base, and a minecart on the chunk-loading rail keeps going while you are somewhere else.

Every module can be switched off, and most can be installed on their own. Take the all-in-one jar and disable what you do not want, or take just the two module jars you came for.

🤖 AI collaboration notice: this project was built together with AI coding assistants. The ideas and direction are human; the AI helped with implementation, documentation and structure. We would rather say so than not.

🚀 Install

1. Install NeoForge for Minecraft 1.21.1.
2. Take either the all-in-one jar or the individual module jars you want, never both. They are declared incompatible on purpose, because installing both registers everything twice.
3. Drop the jars into mods/ and start the game. A config file appears on first launch; see the Configuration Guide.

Every module jar also needs vpa_core.jar, and a few need one more module jar; the table says which.

🧩 Modules

Requires is what the module cannot work without; anything under better with is optional, and the module runs without it.

Module	Docs	Download	Requires
Vanilla Plus Additions — every module in one jar	All modules	vanillaplusadditions.jar	NeoForge 21.1+ · Minecraft 1.21.1
🐾 Companions & Guardians
Axolotl Guardian axolotl_guardian	Docs	vpa_axolotl_guardian.jar + vpa_debug_overlay	— better with: Sable, JEI, Create
Battle Dogs battle_dogs	Docs	vpa_battle_dogs.jar	— better with: JEI, Quark
Cat Guardian cat_guardian	Docs	vpa_cat_guardian.jar + vpa_debug_overlay, vpa_flying_fish	— better with: Sable, Create, JEI
Pet Potions pet_potions	Docs	vpa_pet_potions.jar	—
Wolf Mount wolf_mount	Docs	vpa_wolf_mount.jar	— better with: Grim Kingdoms: structures & ruins, Creeper Overhaul, Quark
👹 Mobs & Spawning
Better Mobs better_mobs	Docs	vpa_better_mobs.jar	—
Enhanced AI Leader Loot enhanced_ai_leader_loot	Docs	vpa_enhanced_ai_leader_loot.jar	Enhanced AI
Haunted House haunted_house	Docs	vpa_haunted_house.jar	Dungeons and Taverns better with: Alex's Mobs, nova_structures
Hostile Endermen hostile_endermen	Docs	vpa_hostile_endermen.jar	— better with: Enderman Overhaul, Enhanced AI
Hostile Zombified Piglins hostile_zombified_piglins	Docs	vpa_hostile_zombified_piglins.jar	—
Mob Drops mob_drops	Docs	vpa_mob_drops.jar	—
Mob Glow Command mob_glow	Docs	vpa_mob_glow.jar	—
Trial Spawner Glow trial_spawner_glow	Docs	vpa_trial_spawner_glow.jar	—
Wither Skeleton Enforcer wither_skeleton	Docs	vpa_wither_skeleton.jar	— better with: YUNG's Better Nether Fortresses
🧱 Blocks, Rails & Create Companions
Conduit Attack Range conduit_attack_range	Docs	vpa_conduit_attack_range.jar	—
Copycat Pathfinding copycat_pathfinding	Docs	vpa_copycat_pathfinding.jar	Create 6.0+
Create Redstone Link Rebinder create_redstone_link_rebinder	Docs	vpa_create_redstone_link_rebinder.jar	Create 6.0+
Create Stock Link Keepalive create_stock_link_keepalive	Docs	vpa_create_stock_link_keepalive.jar	Create 6.0+
Create Water Wheel Unstucker create_water_wheel_unstucker	Docs	vpa_create_water_wheel_unstucker.jar	Create 6.0+
End Conduit end_conduit	Docs	vpa_end_conduit.jar	—
Minecart Chunk Loading minecart_chunk_loading	Docs	vpa_minecart_chunk_loading.jar + vpa_debug_overlay	— better with: Create, Create Aeronautics
Mob Cart Loader mob_cart_loader	Docs	vpa_mob_cart_loader.jar	— better with: Create, Create Aeronautics
Stationary Chunk Loader stationary_chunk_loader	Docs	vpa_stationary_chunk_loader.jar + vpa_debug_overlay	— better with: Create, Create Aeronautics
Train Chunk Loading train_chunk_loading	Docs	vpa_train_chunk_loading.jar + vpa_debug_overlay	Create 6.0+
🛠️ Items & Crafting
Compass Overhaul compass_overhaul	Docs	vpa_compass_overhaul.jar	— better with: Sable, Quark
Custom Crafting Recipes custom_crafting_recipes	Docs	vpa_custom_crafting_recipes.jar	— better with: Create, Overpacked
Dispenser Bucket Guard dispenser_bucket_guard	Docs	vpa_dispenser_bucket_guard.jar	—
Flying Fish flying_fish	Docs	vpa_flying_fish.jar	—
Free Anvil Repair free_anvil_repair	Docs	vpa_free_anvil_repair.jar	— better with: JEI, Create, Quark
Glow Mushroom glow_mushroom	Docs	vpa_glow_mushroom.jar	—
Mo' Arrows mo_arrows	Docs	vpa_mo_arrows.jar	—
Pathfinder Quills pathfinder_quills	Docs	vpa_pathfinder_quills.jar	Quark 4.1-482+
Pocket Crafting pocket_crafting	Docs	vpa_pocket_crafting.jar	—
Special Gemstones special_gemstones	Docs	vpa_special_gemstones.jar	— better with: Quark
Stackables stackables	Docs	vpa_stackables.jar	— better with: Tough As Nails, Create
Tipped Arrows from Potions tipped_arrows	Docs	vpa_tipped_arrows.jar	— better with: JEI
Waystone Amethyst Repair waystone_amethyst_repair	Docs	vpa_waystone_amethyst_repair.jar	— better with: Waystones
🌍 World & Environment
Chunk Reset Command chunk_reset	Docs	vpa_chunk_reset.jar	—
End Oxygen end_oxygen	Docs	vpa_end_oxygen.jar	— better with: Create
Food Effects food_effects	Docs	vpa_food_effects.jar	— better with: Tough As Nails, Create, rottencreatures
Glider Water Repair glider_water_repair	Docs	vpa_glider_water_repair.jar	Gliders
Idle Gamerule Pause idle_gamerules	Docs	vpa_idle_gamerules.jar	—
🥽 Overlays, HUD & Quality-of-Life
Arm Target Overlay arm_target_overlay	Docs	vpa_arm_target_overlay.jar	— better with: Create, Create Aeronautics, Curios API
Block Glow block_glow	Docs	vpa_block_glow.jar	— better with: Sable
Death Coordinates Announcer death_coordinates	Docs	vpa_death_coordinates.jar	—
Debug Overlay debug_overlay	Docs	vpa_debug_overlay.jar	— better with: Create, Create Aeronautics
Item Vault Viewer item_vault_viewer	Docs	vpa_item_vault_viewer.jar	Create 6.0+
Mob Spawn Overlay mob_spawn_overlay	Docs	vpa_mob_spawn_overlay.jar	—
VPA Options options	Docs	vpa_options.jar	—
Overpacked Extensions overpacked_extensions	Docs	vpa_overpacked_extensions.jar	— better with: Overpacked, Curios API, Quark
Static FOV static_fov	Docs	vpa_static_fov.jar	—
🔌 Integrations & Utility
BlueMap Signs bluemap_signs	Docs	vpa_bluemap_signs.jar	— better with: BlueMap
Freecam Sub-Level Noclip freecam_sublevel_noclip	Docs	vpa_freecam_sublevel_noclip.jar	— better with: freecam, Sable
Kill Items kill_items	Docs	vpa_kill_items.jar	—
Quark Fresh Animations quark_fresh_animations	Docs	vpa_quark_fresh_animations.jar	— better with: Quark, entity_model_features
Texture Kill texture_kill	Docs	vpa_texture_kill.jar	—

The exact combination this is played on — “compatible” means tested, and this is what was tested

Minecraft 1.21.1 · NeoForge 21.1.248 · Java 21

Mod	Version
BlueMap	5.7
Bobo Lib	1.1
Create	6.0.10
create-aeronautics-bundled	1.3.1
Curios API	9.5.1
Enderman Overhaul	2.0.3
Enhanced AI	4.2.2.1
Dungeons and Taverns	4.4.4
Overpacked	2.0.1
Quark	4.1-482
Sable	2.0.5
Tough As Nails	10.1.0.13
Gliders	1.1.8
Waystones	21.1.41
waystonessable	1.0.7
zeta	1.1-40

Recipe viewer: EMI 1.1.24 with TooManyRecipeViewers 0.9.0. There is no JEI in this pack — the JEI integrations are compiled against the JEI API and reach the screen through that bridge, so JEI itself is supported but untested here.

Anything older than the floors in the table above is simply unknown, not known to be broken. If you run a different combination and it works, say so in an issue and it goes in this list.

✨ A few highlights

	Compass Overhaul Vanilla drops a lodestone binding whenever its lookup comes back empty, including for a chunk that simply is not loaded. This keeps the binding unless the lodestone is provably gone, fixes the needle aboard a turning airship, and adds a second compass that always points to world north.
	Cat Guardian & Axolotl Guardian Feed a tamed cat and it patrols and hunts hostile mobs around your base; the same for axolotls underwater. Both get armour, a bowl, and a feeding station with a few dozen skins.
	Mob Cart Loader Two blocks that load a mob into a passing minecart and unload it again at the other end, keeping its UUID, so nothing is duplicated or lost.
	Chunk loading that follows you A rail and a Create track that carry a rolling window of loaded chunks with the cart or the train, plus a standing anchor block that holds a fixed square around itself. What you left running keeps running when nobody is watching.
	Flying Fish A fish that leaps out of the water, and boots made from it that let you run across the surface.
	Wolf Mount & Battle Dogs Armour your wolf in four tiers, and if it is big enough, saddle up and fight from its back.

🔧 Configuration

One TOML file, one section per module, every key commented in place.

• Configuration Guide: where the file is and how it works
• Configuration Reference: every key of every module, generated
• Debug Logging: per-module log control

📚 Documentation

• Every module: one page each, from a one-line summary down to the implementation
• Module System: how a module is built, for contributors
• Companion Armor: the armour tiers shared by wolves and cats
• Testing: test server and client

🔨 Development

Requires JDK 21 and Git; the Gradle wrapper handles the rest.

git clone https://github.com/GeraldHofbauerWeb/vanillaplusadditions.git
cd vanillaplusadditions
./gradlew build        # includes Checkstyle and SpotBugs
./gradlew moduleJars   # the standalone module jars, into build/libs/modules/

The build needs four third-party jars in libs/ that are not redistributed here; CI fetches them in .github/workflows/build.yml, and the same URLs work locally.

Documentation is generated and checked:

python3 scripts/docgen/check_docs.py        # completeness, dead links, stale generated blocks
python3 scripts/docgen/gen_meta.py          # rebuild the fact boxes and config tables
python3 scripts/docgen/gen_readme.py        # rebuild the table above
python3 scripts/docgen/render_models.py     # rebuild the item and block images

🤝 Contributing

Contributions are welcome; please read the Contributing Guidelines first.

📝 License

MIT, see LICENSE. The code is ours throughout. The artwork is a mixed bag:

• Several textures (wolf armour, flying fish, End Conduit, station skins and a few more) are recoloured from vanilla Minecraft sprites. They are derived Mojang assets and not covered by the MIT licence.
• The four Foxhound armour textures are recoloured from Quark's foxhound_armor.png, with Vazkii's permission (see Credits).
• The two Quark x Fresh Animations packs (resourcepacks/vpa_quark_fresh_animations and resourcepacks/vpa_quark_toretoise) are Quark's entity models re-exported, with our animations on top. Quark is CC BY-NC-SA 3.0, so these two folders are CC BY-NC-SA 3.0 as well, not MIT; each carries its own LICENSE, inside the jar and in the standalone zip. The module's Java code is ours and stays MIT.
• The world_compass needle and the Chunk Loader Track ship no pixels at all: they are painted at load time from the compass and Create track textures already installed, so they also follow your resource pack.

🌟 Credits

Developer: Gerald Hofbauer · Framework: NeoForge · Built with: Claude Code as a pair programmer

• Vazkii / Quark: the Foxhound armour textures are recolours of Quark's own, used with permission (2026-09-24), and the two Quark x Fresh Animations packs are Quark's entity models re-exported, with Vazkii's OK (2026-10-11; CC BY-NC-SA 3.0, see License).
• Fresh Animations by FreshLX: the Quark mob animations in quark_fresh_animations are modelled after Fresh Animations' style. No Fresh Animations file is included; the add-on only works alongside it.

🔗 Links

• Releases
• Issue Tracker
• Changelog