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: djyelylyeys2022@outlook.com

---

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