hxwi1structures

Hxwi1Structures

NBT structure generation mod designed for modpack authors – visual config, high performance, ready to use.

📦 Overview

Tired of manually writing JSON to configure structure generation? Hxwi1Structures lets you manage all your NBT structure generation rules through a visual GUI. Drop your buildings, click a few times, and the world will generate them automatically.

| Feature | Description |
| :— | :— |
| 🎮 Visual Config | /hxwi1 config – dual-panel GUI, left pane auto‑scans NBT files, right pane editable fields |
| 🔄 Hot‑Reload | Configuration reloads automatically after saving – no need to restart |
| 🌍 Four Placement Modes | Snap to Surface, Snap to Water Surface, Dock Mode, Underwater Mode |
| 🎲 Fine‑Grained Control | Biomes (tag support), dimensions, Y range, chance, conflict ratio, min chunk distance, rotations, Y offset, etc. |
| 🪓 Extra Block Removal | clear_blocks – manually specify blocks to remove (solves compatibility with Dynamic Trees and similar mods) |
| ⛏️ Flatten Ground | flatten_ground + ground_block – automatically fills gaps under the structure |
| 💬 Debug Commands | /hxwi1 biomeinfo – shows current biome and spawnable structures, /hxwi1 spawn for manual testing |
| ⚡ High Performance | Chunk post‑processing + tick throttling + LRU cache, negligible TPS impact |
| 🔌 Excellent Compatibility | No Mixin – works with major terrain/optimisation mods (verified with Better MC / ATM10) |

📥 Installation

1. Download the JAR for your game version (1.20.1 Forge or 1.21.1 NeoForge).
2. Put it into the mods/ folder.
3. Start the game – config files will be generated in config/hxwi1structures/.
4. Place your structure‑block exported .nbt files into config/hxwi1structures/structures/ (subfolders supported).
5. Run /hxwi1 config to set up generation rules.

🛠️ Quick Start

• Add structures: Drop .nbt files into the structures/ folder – the mod auto‑detects them.
• Configure rules: Pick an NBT file in the GUI, set biomes, chance, Y range, etc.
• Test: Use /hxwi1 spawn <filename> to spawn a structure at your current position.
• Debug: /hxwi1 biomeinfo shows which structures can generate in your current biome.

📖 Documentation

An in‑game multi‑language tutorial file is auto‑generated at: config/hxwi1structures/readme.txt
It contains a complete field reference, workflow examples, and FAQ.

⚠️ Current Version Status

• v0.3.1-alpha – core features stable, above‑ground generation has been validated in large modpacks.
• Known issue: Underground generation does not have collision detection and may overlap with other mods‘ dungeons. Mitigate by adjusting Y range or increasing min_chunk_distance.
• Semi‑compatible with Dynamic Trees: may require manually adding Dynamic Trees’ blocks to clear_blocks for complete removal.

🧪 Compatibility

• ✅ Better MC v58 (BMC4)
• ✅ All the Mods 10 – 7.0
• ✅ C2ME, TerraForged, Terralith, Biomes O’ Plenty, etc.
• ⚠️ Dynamic Trees (semi‑compatible, may need extra clear_blocks configuration)

📝 License & Open Source

• Code: MIT License
• NBT structure assets: Copyright retained by their creators. Redistribution of extracted NBT files for other mods is prohibited. They may be distributed as part of an entire modpack together with this mod.

🔗 Links

• GitHub: https://github.com/hxwi1/hxwi1structures
• Feedback: [email protected]

If you like this mod, recommend it to your favourite modpack authors!