Structural Safety

**Protect Minecraft's structures from being stripped, blown up, or burned to the ground — without breaking exploration.** Structural Safety is a **server-side mod** that automatically switches players into Adventure mode whenever they enter a configured structure (Strongholds, Trial Chambers, Mansions, Bastions, modded dungeons …). The mod still lets players interact with the dungeon naturally — break decorative weak blocks, place torches, use redstone, brush suspicious sand — while preventing wholesale destruction of the build. ✅ **Vanilla clients can connect** — the mod only needs to be on the server. ✅ **Works with modded structures** — any structure registered in your data packs can be protected. ✅ **No client mod required.** --- ## Features - 🛡 **Automatic Adventure mode** when a player enters a protected structure, restored to their previous mode (Survival or Creative) when they leave. - 💥 **Explosion protection** — TNT, creepers, ghasts, end crystals can't damage protected blocks. - 🔥 **Fire protection** — fire cannot start inside protected structures, removing burn-down griefing. - 🌋 **Lava protection** — flowing lava is stopped at the structure border. - 🧟 **Mob spawning preserved** — protected structures spawn mobs even in well-lit areas (ideal for dungeons). - ⛏ **Smart "weak block" breaking** — sneak + right-click with the right tool to remove decorative blocks (cobwebs, mossy bricks, iron bars, vines, dripstones, decorated pots …). - 💡 **Temporary placement** — drop torches, lanterns, hay or slime blocks that auto-despawn after a configurable time. - 🪜 **Permanent placement** — ladders, scaffolding, ender eyes can be placed without breaking adventure restrictions. - 🔁 **Block interaction whitelist** — repeaters, comparators, and brushable blocks (suspicious sand/gravel) work in adventure mode. - 🚪 **`/structuralsafety escape`** — teleport to a safe spot if you ever get stuck. Cooldown is bypassed if you're inside a protected area. - 🔧 **Op-bypass toggle** — admins can opt themselves out of the adventure-mode switch (default ON). - 📜 **Audit log** — every break/place inside a protected structure is recorded with timestamp, player, position, and structure ID. - 🌍 **Bilingual UI** — English + German, automatically picked from each player's client language. - 💾 **Live-editable** — manage everything via in-game commands without restarting. --- ## How It Works When a player walks into a structure marked as protected, the mod switches them to Adventure mode and shows a small action-bar notice (`⚠ Protected Area — Adventure mode active`) plus a sound cue. Adventure prevents normal block breaking, but Structural Safety re-enables four explicit categories: | Category | Default contents | How to use | |---|---|---| | **Breakable weak blocks** | cracked/mossy stone bricks, mossy cobblestone, cobweb, iron bars, decorated pot, pointed dripstone, vines, cave vines, big/small dripleaf, hanging roots, glow lichen | **Sneak + right-click** with the correct tool. Blocks that don't require a specific tool in vanilla can be broken with bare hands. | | **Temporary placement** | torch, soul torch, lantern, soul lantern, hay block, slime block | Right-click to place. Despawns automatically after `tempMinutes` (default 10 min). Saves you from fall damage in dungeon shafts. | | **Permanent placement** | ender eye, ladder, scaffolding | Right-click to place. Stays forever. Use ladders/scaffolding to escape pits. | | **Adventure-mode interaction** | repeater, comparator, suspicious sand, suspicious gravel + any `BrushableBlock` | Right-click without sneaking. The mod momentarily lifts the adventure restriction for that one click. | When the player exits the protected area, the mod restores their previous game mode (so creative builders stay in creative). --- ## Commands All commands are under `/structuralsafety`. ### Player commands | Command | What it does | |---|---| | `/structuralsafety info` | Shows current settings, lists, and the adventure-mode rules | | `/structuralsafety escape` | Teleports you to a safe surface position. Cooldown ignored inside protected areas. | ### Admin commands (permission level ≥ 2) | Command | What it does | |---|---| | `/structuralsafety admin opbypass ` | Toggle the op-bypass for adventure mode | | `/structuralsafety admin time escapetime ` | Set the escape cooldown | | `/structuralsafety admin time temptime ` | Set the lifetime of temporary blocks | | `/structuralsafety admin block destroy {list\|add\|remove}` | Manage breakable weak blocks | | `/structuralsafety admin block interact {list\|add\|remove}` | Manage adventure-interactable blocks | | `/structuralsafety admin block place temp {list\|add\|remove}` | Manage temporary-placement items | | `/structuralsafety admin block place perm {list\|add\|remove}` | Manage permanent-placement items | | `/structuralsafety admin structure {list\|enableall\|disableall\|add\|remove}` | Manage which structures are protected | All `list` subcommands are paginated with clickable [REMOVE] / page navigation buttons. --- ## Default Protected Structures Vanilla structures protected out of the box: - Abandoned Mineshaft, Simple Dungeon, Pillager Outpost - Desert/Jungle Pyramid, Mansion, Ocean Monument - Stronghold, Trial Chambers, Ancient City - Nether Fortress, Bastion Remnant, Nether Fossil, End City Modded structures are auto-detected on first server start and added as **disabled** — enable them with `/structuralsafety admin structure add ` or via the in-game list. You can also tag custom structures with the `#structuralsafety:protected` data pack tag for permanent protection. --- ## Configuration Settings are stored in `config/structuralsafety_settings.json` and updated live whenever you use admin commands. You can also edit the file directly while the server is offline. When new versions add default entries (e.g. additional weak blocks), they are merged into your existing config without overwriting your customizations. --- ## Audit Log Every break or place inside a protected structure is appended to `config/structuralsafety_audit.log`: ``` [2026-05-08 14:23:11] BREAK_WEAK player=Steve uuid=… world=minecraft:overworld pos=12,64,-45 target=minecraft:cobweb structure=minecraft:stronghold ``` Easy to grep, easy to import into log analyzers. --- ## Server-Only Mode Set `"environment": "server"` in `fabric.mod.json` (or just install on the server only) — vanilla clients can connect freely. All UI uses vanilla packets (action bar, sounds, chat) so nothing breaks.