Main Setup

Setting World Type on Single Player as Default

See Default World Type. Use skyblockbuilder:skyblock as config value.

Alternatively, you can manually create the forge-common.toml file in the config directory with the above content.

Setting World Type on Server as Default

For servers, you can provide a custom server.properties file by setting the level-type to skyblockbuilder:skyblock. The rest of the setup is the same as in single player.

Creating a Custom Skyblock Island

1. Build an island.
2. Use the custom item Structure Saver from the vanilla Tools tab in the creative inventory. The output directory for this will be <minecraft>/skyblock_exports/<name>.nbt. Alternatively, use the vanilla Structure Block, noting it can only save islands up to 48x48x48 blocks. The output for this will be in <minecraft>/saves/<world>/generated/minecraft/structures/<name>.nbt.
3. Copy the generated file to config/skyblockbuilder/templates/<name>.nbt.
4. Configure the template with a readable name and spawns in config/skyblockbuilder/templates.json5. Multiple spawns can be defined as arrays with [x, y, z] coordinates relative to the template structure's origin (0, 0, 0). You can also modify existing spawns and export them using /skyblock spawns EXPORT. Note: These commands require the world type Skyblock.
5. View current spawns by running /skyblock spawns debug.
6. Apply the new spawn points by copying them into the config/skyblockbuilder/templates.json5 file.

Setting a Default Spawn Island

To set a default spawn island for new worlds, use the spawn setting. If spawn is set to null, the default team template will be used instead.

For more details on how to configure spawn, see Configuring Templates.

Setting Multiple Templates

To enable multiple schematics, place them in config/skyblockbuilder/templates/. Users can select these templates by pressing the Customize button in the world options screen or by changing the schematic with the /skyblock manage islandShape <template> command, where <template> is the name specified in the next chapter. IMPORTANT: Do not name any schematic files template.nbt to avoid overwriting the default schematic.

Configuring Templates

To set up templates and spawn points, you’ll need to edit the config/skyblockbuilder/templates.json5 file. This guide helps you configure it step by step.

Spawns

The spawns section specifies spawn point sets. For example:

{
   "spawns": {
      "default": [
         [ 6, 3, 5 ]
      ]
   }
}

Here, "default" is the key, and it contains a list of coordinates ([x, y, z]) that define spawn points. You can configure multiple spawn sets, but each key must be unique.

Surrounding Blocks

The surroundingBlocks section determines the blocks that will surround the template. For example:

{
  "surroundingBlocks": {
    "default": [
      "minecraft:stone",
      "minecraft:bedrock"
    ]
  }
}

• The key (e.g., "default") must be unique and is linked to the templates option in the next section.
• The value is a list of block identifiers (resource locations). These blocks will randomly surround the template.
• Thickness of this surrounding area is determined by surroundingMargin (explained below).

Templates

The templates section defines the actual templates, connecting them with spawn points and block settings. Here's an example:

{
   "templates": [
      {
         "name": "default",
         "desc": "Default template",
         "file": "default.nbt",
         "spawns": "default",
         "direction": "south",
         "offset": [ 0, 0 ],
         "offsetY": 0,
         "surroundingBlocks": "default",
         "surroundingMargin": 0
      }
   ]
}

Key	Default Value	Description
name	❌	The name displayed on the Customize screen.
desc	❌	A description shown on the Customize screen when selecting the world preset.
file	❌	The filename of the template.
spawns	❌	The name of the spawn configuration, taken from the spawns option.
direction	south	The direction the user will face when using this template.
offset	[ 0, 0 ]	The positional offset for this template. Learn more about offsets here.
offsetY	0	Vertical (Y-axis) offset for this template. From version 1.20, this will merge with offset.
surroundingBlocks	"" (empty string)	The configuration name for surrounding blocks, taken from the surroundingBlocks option.
surroundingMargin	0	The thickness of the border around the template.

info

Settings with default values are optional.

You can differentiate multiple configurations with the same file and spawns using unique names. Additionally, you can set an icon for each template by placing it in config/skyblockbuilder/templates/icon/<name>.png, where <name> must be in lowercase.

note

If spawning inside a block, add the block to the #skyblockbuilder:additional_valid_spawns block tag.

Loot Chests on Island

To add a loot chest to an island, set the NBT data to the chest with the command:

/data merge block <x y z> {LootTable: modid:path/to/loot_table}

warning

Do not open the chest after merging this data.

Converting .nbt Templates to .snbt

To convert your existing .nbt templates to .snbt, use the command:
/skyblock templates_to_snbt.

This command will convert all templates located in the config/skyblockbuilder/templates/ folder into .snbt files. The original .nbt files will remain unchanged.