hxwi1structures

Mod

An NBT structure generator for modpack makers. Visual GUI config, four placement modes, biome tags, dimensions, Y range, chance, min distance. High‑performance, no Mixin, good compatibility. For 1.20.1 Forge / 1.21.1 NeoForge.

Type

Mod

Modrinth Downloads

475

Modrinth ID

wjsGWBKQ

Last Updated

Nov 7, 2026

Description

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 .nbt files into config/hxwi1structures/structures/ (subfolders supported).
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.