About CubicStruct
From ModrinthImplement custom structures into world gen, using nbt files and simple json parameters.
About
CubicStruct is a mod intended to implement custom structures (nbt files) into world generation, with compatibility for Cubic World Gen. For each structure, it offers settings for biome, maximum decay, placement, and more through their respective .json files. If you're creative, perhaps you'll never need another structure mod. Additionally, for a means to implement custom loot tables into said structures without creating a mod or pasting into every world, see Iloot.
Usage
Vanilla/CC Compatibility Warnings
- If using Cubic Chunks without Cubic World Gen, minX and minY settings must be adjusted, or worldgen will attempt to spawn structures by tracing from the absurd top of the world.
- While not a required dependency, this mod was developed specifically for structure compatibility with Cubic World Gen; regular worlds with or without Cubic Chunks may produce unintended effects (such as failed spawns). For ideal results without CWG, set minX and minY to structure-appropriate values.
Acquiring structure .nbt
To acquire any structure with .nbt format, simply save it using Minecraft's vanilla structure block. The new file will be found within the save's 'structures' directory, which you can then paste into the generated 'cubic_structures' folder, located in the base Minecraft directory.
Data Blocks
CubicStruct implements additional features for data blocks, which manifest on natural worldgen (unimplemented for manual loading) which are listed below (<<>> - required; <> - optional):
villager <(profession (string/int))> <(career (int))>- spawns a random villager with the given profession and career.- Professions available are
farmer,librarian,cleric,blacksmith,butcher, andnitwit. Alternatively, use id. spawner- generates a random monster spawner, from the dungeon pool.block <<{blocks:[{<<id: (string)>>,<data: (int)>,<nbt: (nbt string)>}]}>> <(seed ((int))>- generates a random block from the provided list. Providing a seed allows multiple blocks within a structure to generate similarly (only the blocks themselves, not for any nbt associated). A formatting example would beblock {blocks:[{id:"minecraft:gravel"},{id:"minecraft:chest",data:1,nbt:{LootTable:"iloot:chests/fish"}}]} 7.
Initializing the structure
General
The .nbt will be initialized on game/mod reload, and a new directory will be produced from it. The new directory will contain a .json which can be modified at will to alter how the structure spawns. The values are all preset, and determine spawn as follows:
- file - (default: filename, required) - the only required parameter which isn't auto-assumed (will still be auto-generated). Do not modify this unless missing, moving the .nbt into a group, or also altering the filename of whatever is being edit.
- name - (default: filename) - name for the structure.
- description - (default: "No description provided.") - brief description for the structure.
- spawnChance - (default: 1.0) - percent chance that an attempt will be made to spawn the structure within a chunk. Note that this value is relative, and may be impacted by generation failures; structures which are very likely to fail generating should be provided a higher value.
- surfaceLevel - (default: 0) - the Y level offset relative to the structure's height to begin spawning onto a surface/ceiling. When placementType is set to
surface,0results in spawning from the bottom of the structure, while the reverse is true ofceiling. For example, if a structure extends 8 blocks into the ground ('ground' being whatever surface/ceiling it latches onto), this should be set to-8.blockandforceignore this. - dimensions - (default: [0]) - list of all dimensions this structure can spawn in (-1 = nether, 0 = overworld, 1 = end). This feature is currently nonfunctional in CWG worlds; use biome lists instead.
- biomeWhiteList - (default: false) (conflicts with blacklist) - whether or not the structure is limited to specific biomes.
- biomeBlackList - (default: false) (conflicts with whitelist) - whether or not the structure is restricted from spawning within specific biomes.
- biomes - (default: minecraft:plains) - biomes to spawn in, if whitelist/blacklist is enabled.
- maxDecay - (default: 0) - percent value denoting the amount of possible integrity loss when spawning the structure. Higher values will increase missing blocks.
- airSpawn - (default: false) - whether or not the structure will only attempt spawning in air (as opposed to liquid). Conflicts with
liquidSpawn, and ignored byblockplacement type. Enable this if placement type issurface, or structure will also spawn in liquids. - liquidSpawn - (default: false) - whether or not the structure will only attempt spawning in liquids. Conflicts with
airSpawn, and ignored byblockplacement type. - rotate - (default: true) - if the structure will spawn with a random horizontal rotation.
- mirror - (default: true) - if the structure will spawn with a random horizontal mirror.
- minY - (default: -2147483648) - minimum Y to spawn the structure.
- maxY - (default: 2147483647) - maximum Y to spawn the structure.
- minXZ - (default: 0) - absolute value of minimum X OR Z coordinates, rounded by chunk.
- maxXZ - (default: 2147483647) - absolute value of maximum X OR Z coordinates, rounded by chunk.
- placementType - (default: surface) - Can either be
force,block,surface,liquidsurface, orceiling. forcewill generate the structure anywhere and everywhere blocks can be placed, adhering to other spawn rules.blockwill generate the structure within the block defined inreplaced.surfacewill generate the structure onto a flat walkable surface. This includes underwater/liquid surfaces ifairspawnis not set to true.
Highlights
From source dataGame versions
Built for Minecraft 1.12.2.
Loaders
Runs on Forge.
Footprint
Rated a light load on a server.
CubicStruct on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers. We download it from Modrinth, place it, and restart the server.
- Server side
- Required on the server
- Server type needed
- Forge
- Server load
- light
- Smallest plan we suggest
- Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 1.3.2, released 2024-12-20
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Forge | 1.12.2 | 1.12.2 |
From 5 recorded builds of CubicStruct.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 1.3.2 | 2024-12-20 | 1.12.2 | Forge |
| 1.3.1 | 2024-12-20 | 1.12.2 | Forge |
| 1.3.0 | 2024-12-17 | 1.12.2 | Forge |
| 1.2.3 | 2024-07-04 | 1.12.2 | Forge |
| 1.2.2 | 2023-04-27 | 1.12.2 | Forge |
Dependencies
- Optional: modrinth project ONVu3r1l (modrinth, not in our catalogue)
- Optional: modrinth project 8Tb4j8xo (modrinth, not in our catalogue)
Declared by the newest build that lists any. Required ones are installed with it on one-click installs.
Run CubicStruct on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogWorld generation
Changes or adds to how new terrain, biomes and structures are created.
Runs on your server
From source side supportModrinth lists CubicStruct as required on the server. Check its Modrinth page to see whether players need it too.
Compatibility
- Game
- Minecraft
- Loaders
- Forge
- Runs on
- Serverrequired on the server
- Game versions
- 1.12.2
Verified at the source
- ✓ModrinthOfficial listing, checked 2026-10-17Open ↗
- ✓AuthorAbstrusle, as published on Modrinth
- ✓LicenseMITFree











