Automatic Replacement Mod – Singleplayer Overview

This mod is designed for Minecraft 1.20.x (1.20.1 – 1.20.6) and has been fully tested on 1.20.1. It adds two major features for singleplayer: auto totem refill and extended world height.
Please read the “Known Issues” section before using.

✨ Features

1. Auto Totem Refill

• When your totem of undying in the offhand (or main hand, depending on configuration) is used, the mod automatically takes another totem from your inventory and places it into your offhand.
• Commands (available in singleplayer or as operator):
  • /auto true – enable auto refill
  • /auto false – disable auto refill
  • /auto toggle – toggle the feature
  • /auto status – show current state
• Convenient buttons are added to:
  • Inventory screen (top‑left corner)
  • Creative inventory screen (top‑left corner)
  • Options screen (bottom‑right corner)

2. Extended World Height

• The world height limit is expanded:
  • Minimum Y = -128 (was -64)
  • Maximum Y = 1024 (was 319)
• This gives you much more vertical building space and deeper underground exploration.

⚠️ Known Issues (Singleplayer)

• Multiplayer compatibility
  The mod is not guaranteed to work on multiplayer servers (unless the server also runs the exact same version of the mod). When connecting to a server without the mod, you may see registry synchronization errors (e.g., raw biome data printed on screen).
  → For singleplayer / local worlds only.

• World height extension
  Generated worlds that use the new height range may not load correctly if you downgrade to an older Minecraft version or remove the mod.
  → Backup your worlds before creating them with the extended height.

• Auto refill button
  In some rare cases, the button text may not refresh immediately after toggling the feature via command. Re‑opening the inventory screen fixes it.

📦 Requirements

• Fabric API (latest version for 1.20.x)
• Minecraft 1.20.1 – 1.20.6

🧪 How to Use (Singleplayer)

1. Install the mod and Fabric API.
2. Start a singleplayer world (or create a new one to benefit from the extended height).
3. Use /auto toggle to enable/disable totem refill, or click the button in your inventory/options screen.
4. Enjoy automatic totem replacement and a taller world!

📜 License

MIT – free to use, modify, and redistribute.

🙏 Credits

Developed by Monkey. Totem refill inspired by classic “auto totem” utilities; world height extension made possible by Fabric API.