ProtectionBlocks

🎉 v1.0.6 — In-game admin GUI & item tooltips

Quality-of-life release focused on configuration UX: admins can now edit the entire server config from a clean in-game GUI without touching the TOML, and players see at a glance how big each protection block actually is by hovering over it in the inventory.

🆕 In-game admin configuration GUI

The whole protectionblocks-server.toml is now editable from inside Minecraft. No more uploading files to your host or restarting the world for a 1-line tweak.

• 4 tabs: General, Tiers, Behavior, Bot — all 20 server options grouped logically.
• Two ways to open it:
  • 🎯 New keybind with its own category "Protection Blocks" in Options → Controls. Unbound by default to avoid clashing with other mods — pick whatever key suits you.
  • 🖱️ New button ⛨ Protect in the top-left of the pause menu (Esc), 70×16 to align with other admin-mod buttons (HeadRoles, etc.). Auto-detects neighbours and places itself after them — never overlaps.
• OP-gated: the button only appears for players with permission level 2+. The packet handler validates again server-side, so a modified client can't bypass it.
• Hot-reload: every option except crafting recipes applies instantly, no restart. Radii, tier toggles, anti-bypass, bot endpoint, audit log — all live. The only field with a "⚠ Requires /reload" badge is enableProtectionBlockRecipes, because Forge only refreshes recipes at data-manager startup.
• Range validation client- AND server-side: out-of-range values get clamped, and the server replies with the real applied state.

🆕 Item tooltips on hover

Hover any protection block in your inventory, hotbar, creative tab or recipe book and the tooltip now shows:

• Radius in blocks (pastel mint — #A8E6CF)
• Full protected area: side × side × side + total volume in blocks (pastel sky — #AED6F1)

The values are read from the live config on every render, so if an admin tweaks basicProtectionRadius in the new GUI, every player's tooltip updates instantly without restarting their client.

🌐 Languages

Everything new is fully translated to the 5 mod languages:

• 🇪🇸 Spanish
• 🇬🇧 English
• 🇩🇪 German
• 🇫🇷 French
• 🇮🇹 Italian

🔧 Under the hood

• 3 new network packets for the config flow: RequestConfigPacket, SyncConfigPacket, UpdateConfigPacket. The snapshot POJO (ConfigSnapshot) is the single source of truth for adding new options — one field, one widget.
• ItemTooltipEvent client-side handler with no caching, so config changes propagate instantly.
• Keybind registration moved to the correct event bus (Forge MOD bus, not FORGE bus — was a silent no-op in a beta build, fixed before release).

📦 Compatibility

• Minecraft 1.20.1
• Forge 47.x
• Client & Server

© 2026 Vicxelcode — MIT License