SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedWorld generation

CubicStruct

by Abstrusle · for Minecraft

Implement custom structures into world gen, using nbt files and simple json parameters.

2.1KDownloads
23 mo agoLast updated
MITLicense
ForgeLoaders

About CubicStruct

From Modrinth

Implement 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, and nitwit. 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 be block {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, 0 results in spawning from the bottom of the structure, while the reverse is true of ceiling. 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. block and force ignore 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 by block placement type. Enable this if placement type is surface, 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 by block placement 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, or ceiling.
  • force will generate the structure anywhere and everywhere blocks can be placed, adhering to other spawn rules.
  • block will generate the structure within the block defined in replaced.
  • surface will generate the structure onto a flat walkable surface. This includes underwater/liquid surfaces if airspawn is not set to true.

Read the full description on Modrinth →

Highlights

From source data

Game 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

LoaderGame versionsNewest
Forge1.12.21.12.2

From 5 recorded builds of CubicStruct.

Recent builds

BuildReleasedGame versionsLoaders
1.3.22024-12-201.12.2Forge
1.3.12024-12-201.12.2Forge
1.3.02024-12-171.12.2Forge
1.2.32024-07-041.12.2Forge
1.2.22023-04-271.12.2Forge

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 catalog
Listed on Modrinth as “Mods”

World generation

Changes or adds to how new terrain, biomes and structures are created.

Runs on your server

From source side support

Modrinth 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

CubicStruct, answered

Generated from the mod’s own source data.

Do my players need to install CubicStruct?

Modrinth lists CubicStruct as required on the server. Check its Modrinth page to see whether players need it too.

Which loaders does it support?

Forge.

Is it free?

Yes. CubicStruct is free to download from Modrinth. Its license is MIT.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run CubicStruct on a Minecraft server.

Deploy in about a minute from $4.20 a month, then add CubicStruct in one click.