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
- Download the JAR for your game version (1.20.1 Forge or 1.21.1 NeoForge).
- Put it into the
mods/folder. - Start the game – config files will be generated in
config/hxwi1structures/. - Place your structure‑block exported
.nbtfiles intoconfig/hxwi1structures/structures/(subfolders supported). - Run
/hxwi1 configto set up generation rules.
🛠️ Quick Start
- Add structures: Drop
.nbtfiles into thestructures/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 biomeinfoshows 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_blocksfor 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_blocksconfiguration)
📝 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!
