Island Schematics

Island schematics define the default structures players can choose when creating their islands. SuperiorSkyblock2 supports multiple schematic formats and versions.

Schematic Files Location

Schematics are stored in the schematics/ directory:

plugins/SuperiorSkyblock2/schematics/
├── normal.schematic          # Default island (MC 1.12)
├── normal1_16.schematic      # Default island (MC 1.16+)
├── mycel.schematic           # Mycelium island (MC 1.12)
├── mycel1_16.schematic       # Mycelium island (MC 1.16+)
├── desert.schematic          # Desert island (MC 1.12)
├── desert1_16.schematic      # Desert island (MC 1.16+)
├── normal_nether.schematic   # Nether dimension
├── normal_the_end.schematic  # End dimension (MC 1.12)
└── normal_the_end1_16.schematic  # End dimension (MC 1.16+)

The plugin automatically selects the correct schematic version based on your server’s Minecraft version.

Schematic Versioning

SuperiorSkyblock2 supports version-specific schematics:

No suffix - Minecraft 1.12 and earlier
1_13 - Minecraft 1.13-1.15
1_16 - Minecraft 1.16-1.19
1_20 - Minecraft 1.20+

The island creation menu (menus/island-creation.yml) defines which schematics players can select:

menus/island-creation.yml

title: '&lCreate a new island...'
previous-menu: true

pattern:
  - '~ ~ ~ ~ ~ ~ ~ ~ ~'
  - '# @ # # ^ # # $ #'
  - '~ ~ ~ ~ ~ ~ ~ ~ ~'

items:
  '@':
    schematic: 'normal'
    biome: PLAINS
    spawn-offset: '0, 0, 0'
    access:
      type: SKULL_ITEM
      data: 3
      skull: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYzk1ZDM3OTkzZTU5NDA4MjY3ODQ3MmJmOWQ4NjgyMzQxM2MyNTBkNDMzMmEyYzdkOGM1MmRlNDk3NmIzNjIifX19'
      name: '&eNormal Island &a(Available)'
      lore:
        - '&7Simple island with trees and a mining area!'
        - '&7 '
        - '&7&o(( &f&oRight-Click &7&oto preview the island. ))'
    no-access:
      type: SKULL_ITEM
      data: 3
      skull: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYzk1ZDM3OTkzZTU5NDA4MjY3ODQ3MmJmOWQ4NjgyMzQxM2MyNTBkNDMzMmEyYzdkOGM1MmRlNDk3NmIzNjIifX19'
      name: '&eNormal Island &c(Unavailable)'
      lore:
        - '&7Simple island with trees and a mining area!'
  
  '^':
    schematic: 'mycel'
    biome: MUSHROOM_ISLAND
    spawn-offset: '0, 0, 0'
    access:
      type: SKULL_ITEM
      data: 3
      skull: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZWE0NWQxYjQxN2NiZGRjMjE3NjdiMDYwNDRlODk5YjI2NmJmNzhhNjZlMjE4NzZiZTNjMDUxNWFiNTVkNzEifX19'
      name: '&eMycelium Island &a(Available)'
      lore:
        - '&7Customized island with lots of mycelium!'

Schematic Configuration Options

schematic

string

required

The name of the schematic file (without .schematic extension)

biome

string

required

The default biome for this island type (e.g., PLAINS, DESERT, MUSHROOM_ISLAND)

spawn-offset

string

default:"0, 0, 0"

Offset from the schematic center where players spawn (x, y, z)

access

object

required

Item displayed when the player has access to this schematic

no-access

object

required

Item displayed when the player doesn’t have access to this schematic

Adding Custom Schematics

Create the Schematic

Use WorldEdit or similar plugin to create and save your schematic:

//copy
//schematic save myisland

Copy to Schematics Folder

Copy the .schematic file to plugins/SuperiorSkyblock2/schematics/:

myisland.schematic

For version-specific schematics:

myisland1_16.schematic
myisland1_20.schematic

Add to Creation Menu

Edit menus/island-creation.yml and add a new item:

'%':
  schematic: 'myisland'
  biome: PLAINS
  spawn-offset: '0, 2, 0'
  access:
    type: GRASS_BLOCK
    name: '&eMy Custom Island &a(Available)'
    lore:
      - '&7A custom island schematic!'
  no-access:
    type: DIRT
    name: '&eMy Custom Island &c(Unavailable)'

Update Menu Pattern

Add your new item to the pattern:

pattern:
  - '~ ~ ~ ~ ~ ~ ~ ~ ~'
  - '# @ # ^ # $ # % #'
  - '~ ~ ~ ~ ~ ~ ~ ~ ~'

Reload Configuration

Reload the plugin:

/is admin reload

Schematic Permissions

Control which schematics players can access using permissions:

superior.island.create.<schematic-name>

Examples:

superior.island.create.normal - Access to normal island
superior.island.create.mycel - Access to mycelium island
superior.island.create.desert - Access to desert island

If a player doesn’t have permission for a schematic, the no-access item will be displayed instead.

Island Preview System

Players can preview schematics before selecting them by right-clicking the item.

Configure Preview Locations

config.yml

island-previews:
  # Game mode when entering preview
  game-mode: SPECTATOR
  
  # Maximum distance before canceling preview
  max-distance: 100
  
  # Commands blocked in preview mode
  blocked-commands: []
  
  # Preview locations for schematics
  locations:
    normal: world, 0, 100, 0
    mycel: world, 0, 100, 0
    desert: world, 0, 100, 0

Setting Preview Locations

Use the admin command to set preview locations:

/is admin setislandpreview <schematic> <world> <x> <y> <z>

Example:

/is admin setislandpreview normal world 1000 100 1000

Default Containers

Populate chests and containers in schematics with default items:

config.yml

default-containers:
  enabled: false
  containers:
    chest:
      '0':
        type: ICE
        amount: 2
      '1':
        type: MELON
      '2':
        type: TORCH
        amount: 2
      '3':
        type: BONE
      '4':
        type: LAVA_BUCKET
      '5':
        type: PUMPKIN_SEEDS
      '10':
        type: BREAD
      '12':
        type: LEATHER_BOOTS
      '13':
        type: LEATHER_LEGGINGS
      '14':
        type: LEATHER_CHESTPLATE
      '15':
        type: LEATHER_HELMET

Container items use slot indices (0-26 for single chest). Items will replace any existing items in those slots.

Default Signs

Customize signs placed in schematics:

config.yml

# Available placeholders:
# {player} - Island owner's name
# {island} - Island's name (or owner's name if no island name)
default-signs:
  - '&6Welcome to'
  - '&b{island}'
  - ''
  - '&7Owner: {player}'

Set to empty list to disable:

default-signs: []

Schematic Offset

Control whether schematic blocks count toward island worth/level:

config.yml

worlds:
  normal:
    # Exclude schematic blocks from worth/level calculations
    schematic-offset: true
  nether:
    schematic-offset: true
  end:
    schematic-offset: true

When enabled, only blocks placed/removed by players affect the island’s worth and level, not the initial schematic blocks.

Schematic Pasting Settings

config.yml

# Update liquids when pasting schematics?
liquid-update: false

# Update lights when pasting schematics?
lights-update: true

Performance Considerations

liquid-update: Set to false for better performance. Liquids will update naturally over time.
lights-update: Set to true to prevent lighting glitches. May impact performance during paste.

Creating Admin Schematics

Admins can create and save schematics directly:

/is admin schematic <schematic-name>

This command enters schematic creation mode. Build your island, then save it:

/is admin schematic <schematic-name> save

Multi-World Schematics

Create separate schematics for each dimension:

plugins/SuperiorSkyblock2/schematics/
├── normal.schematic          # Normal world
├── normal_nether.schematic   # Nether dimension
└── normal_the_end.schematic  # End dimension

Nether and End schematics are optional. If not provided, those dimensions will be empty when unlocked.

Best Practices

Schematic Size

Keep schematics smaller than your default island size
Default island size is 20 blocks, so schematics should be ~15-18 blocks
Larger schematics may extend beyond island borders

Schematic Center

Place the spawn point at the center of your schematic
The plugin pastes schematics from the center outward
Use spawn-offset to adjust player spawn location

Performance

Avoid excessive entities (item frames, armor stands)
Minimize redstone contraptions in default schematics
Test schematic pasting speed before adding to production

Version Compatibility

Always create version-specific schematics for major updates
Test schematics on each supported Minecraft version
Use 1_16 format for modern versions (1.16+)

Troubleshooting

Schematic Not Loading

Verify file name matches exactly (case-sensitive)
Check file is in .schematic format
Ensure version suffix is correct for your server
Check console for error messages

Items Not Appearing in Chests

Enable default-containers in config.yml
Verify material names are valid
Check slot indices are within range (0-26)

Wrong Spawn Location

Adjust spawn-offset in island-creation.yml
Format: ‘x, y, z’ (relative to schematic center)
Positive Y moves spawn upward

Getting Started

Core Concepts

Configuration

Features

Integrations

Schematic Files Location

Schematic Versioning

Island Creation Menu

Schematic Configuration Options

Adding Custom Schematics

Schematic Permissions

Island Preview System

Configure Preview Locations

Default Containers

Default Signs

Schematic Offset

Schematic Pasting Settings

Creating Admin Schematics

Multi-World Schematics

Best Practices

Troubleshooting

Build docs developers (and LLMs) love

Getting Started

Core Concepts

Configuration

Features

Integrations

Documentation Index

​Schematic Files Location

​Schematic Versioning

​Island Creation Menu

​Schematic Configuration Options

​Adding Custom Schematics

​Schematic Permissions

​Island Preview System

​Configure Preview Locations

​Default Containers

​Default Signs

​Schematic Offset

​Schematic Pasting Settings

​Creating Admin Schematics

​Multi-World Schematics

​Best Practices

​Troubleshooting

Build docs developers (and LLMs) love

Schematic Files Location

Schematic Versioning

Island Creation Menu

Schematic Configuration Options

Adding Custom Schematics

Schematic Permissions

Island Preview System

Configure Preview Locations

Default Containers

Default Signs

Schematic Offset

Schematic Pasting Settings

Creating Admin Schematics

Multi-World Schematics

Best Practices

Troubleshooting