Starter Structure

Starter Structure

Starter Structure is a powerful mod that allows you to automatically generate structures at the spawn point upon world creation. The mod reads schematic files from the config folder and places them at the designated world spawn location.

Both structure block schematics (SBS, .nbt files) and WorldEdit schematics (WES, .schem/.schematic files) are supported. SBS files contain entity data, which allows for spawning saved entities directly. WES files do not save entity data, but you can define where entities should spawn by placing signs within the schematic. Both formats support custom NBT data. Notably, you do not need WorldEdit installed for the mod to function; it is only required for creating the schematic file, after which you may remove it. You can create schematics in a separate instance and copy the file into your modpack.

Additionally, the mod offers comprehensive configuration options, allowing you to precisely control player spawn locations, structure generation positions, and placement parameters.

Configuration Options Detailed

Here are the details for all available configuration options:

shouldGenerateStructure (Default: true) Determines whether a schematic located in './config/starterstructure/schematics/...' should be generated.

forceExactSpawn (Default: true) Player spawns are usually randomized. With this enabled, players will always spawn at the set coordinates (at the nearest air pocket).

ignoreTreesDuringStructurePlacement (Default: true) Prevents structures from being placed on top of trees by ignoring leaf and log blocks during placement.

generationIgnoreJigsawAndStructureBlocks (Default: true) By default, jigsaw or structure blocks within schematic files are ignored during generation.

protectStructureBlocks (Default: true) Determines whether the blocks of the generated structure are protected from breaking or griefing.

protectSpawnedEntities (Default: true) Determines whether entities spawned inside the generated structure are protected from damage.

playersInCreativeModeIgnoreProtection (Default: true) If enabled, players in creative mode can break and place structure blocks.

playersInCreativeModeIgnoreEntityProtection (Default: false) If enabled, players in creative mode can damage protected entities spawned within structures.

preventSpawnedEntityMovement (Default: false) If enabled, prevents spawned entities from moving away from the block where they spawned. Default is false.

spawnNonSignEntitiesFromSupportedSchematics (Default: true) Determines whether entities found in (structure block) schematic files should be spawned. These are entities not created via signs.

shouldUseStructurePosition (Default: false) Determines whether custom structure generation position options should be used.

generatedStructureXPosition (Default: 0, Range: -10000000 to 10000000) The exact X coordinate for the generated structure. Requires shouldUseStructurePosition.

generatedStructureYPosition (Default: 0, Range: -1000 to 1000) The exact Y coordinate for the generated structure. Requires shouldUseStructurePosition.

generatedStructureZPosition (Default: 0, Range: -10000000 to 10000000) The exact Z coordinate for the generated structure. Requires shouldUseStructurePosition.

shouldUseStructureOffset (Default: false) Determines whether custom structure generation offset options should be used.

generatedStructureXOffset (Default: 0, Range: -1000 to 1000) The X offset for the generated structure. Requires shouldUseStructureOffset.

generatedStructureYOffset (Default: 0, Range: -1000 to 1000) The Y offset for the generated structure. For example, set to -1 if a building spawns one block too high. Requires shouldUseStructureOffset.

generatedStructureZOffset (Default: 0, Range: -1000 to 1000) The Z offset for the generated structure. Requires shouldUseStructureOffset.

shouldUseSpawnCoordinates (Default: false) Determines whether custom spawn coordinate options should be used.

spawnXCoordinate (Default: 0, Range: -10000000 to 10000000) The new X coordinate for spawn when shouldUseSpawnCoordinates is enabled.

spawnYCoordinate (Default: 0, Range: -1000 to 1000) The new Y coordinate for spawn when shouldUseSpawnCoordinates is enabled.

spawnZCoordinate (Default: 0, Range: -10000000 to 10000000) The new Z coordinate for spawn when shouldUseSpawnCoordinates is enabled.

shouldUseSpawnCoordOffsets (Default: false) Determines whether custom spawn coordinate offset options should be used.

spawnXCoordOffset (Default: 0, Range: -1000 to 1000) The X coordinate offset for spawn when shouldUseSpawnCoordOffsets is enabled.

spawnYCoordOffset (Default: 0, Range: -1000 to 1000) The Y coordinate offset for spawn when shouldUseSpawnCoordOffsets is enabled.

spawnZCoordOffset (Default: 0, Range: -1000 to 1000) The Z coordinate offset for spawn when shouldUseSpawnCoordOffsets is enabled.

Config Folders and Guides

Schematics are stored in ./config/starterstructure/schematics. You can place .nbt, .schem, or .schematic files here. If multiple files are present, the mod will pick one at random.

Custom sign data is stored in ./config/starterstructure/signdata. By placing a .txt file containing a /summon command in this folder and referencing it with a sign inside the schematic, you can spawn entities upon generation.

How to generate a WorldEdit schematic

1. Use the //wand command to receive the selection tool.
2. Left-Click the first block to determine the bottom corner of the schematic.
3. Right-Click the opposite corner to set the area (remember to break temporary blocks afterwards), or use the //pos2 command.
4. Stand where you want the player to spawn when the structure generates, and enter the //copy command.
5. Use //schematic save <schematic-name> to create the file.
6. The file is saved in ./config/worldedit/schematics.
7. Copy it to the Starter Structure config folder: ./config/starterstructure/schematics.

Starter Structure will automatically load and generate the building when a new world is created.

Signs and Entity Spawning

You can easily spawn entities within the generated structure by placing signs:

Simple Entity Spawning: On the sign, enter: [Entity] modid:entityid (New lines are ignored. This format will spawn the corresponding entity, such as a villager, at that location upon generation.)

Custom NBT Data Spawning: For more complex entities (e.g., custom names, items, or effects), reference a .txt file: Enter [NBT] on the first line of the sign and the filename on the second. Example: [NBT] filename

The system will look for entity data in ./config/starterstructure/signdata/filename.txt. The content should be a standard /summon command (you can use tools like MCStacker to generate this). Starter Structure will automatically strip the /summon prefix and generate the entity with the correct NBT data.