Schematics¶

HTSkyBlock supports two island structure formats: Sponge Schematics (.schem) and Hytale Prefabs (.prefab.json). Use these to create custom island designs for players.

Supported Formats¶

Sponge Schematics (.schem)¶

Standard schematic format used by WorldEdit and other tools.

Features: - Portable across different Minecraft-like games - Support for blocks, entities, and tile entities - Version 2 and Version 3 supported - Block palette for efficient storage

Location: plugins/HTSkyBlock/schematics/

Hytale Prefabs (.prefab.json)¶

Native Hytale structure format.

Features: - Native Hytale format, no conversion needed - Full support for all Hytale blocks and entities - JSON-based, human-readable - Can be exported from Hytale's builder tools

Location: server/prefabs/

Configuration¶

Set the default island structure in config.json:

{
  "island": {
    "creationType": "schematic",
    "defaultSchematic": "starter_island.schem",
    "defaultPrefab": "island.prefab.json"
  }
}

Options:

Option	Values	Description
`creationType`	`schematic`, `prefab`	Default format to use
`defaultSchematic`	Filename	Schematic used for new islands
`defaultPrefab`	Filename	Prefab used for new islands

Selection Tool¶

The /selection command collection (aliases: /select, /sel, /wsel) provides WorldEdit-style selection and export tools.

Commands¶

pos1¶

Set corner 1 of your selection at your current position.

Usage: /select pos1

Example:

# Stand at one corner of your build
/select pos1

pos2¶

Set corner 2 of your selection at your current position.

Usage: /select pos2

Example:

# Walk to opposite corner
/select pos2

After setting both corners, you'll see the selection size and a visual boundary.

info¶

Display information about your current selection.

Usage: /select info

Shows: - Selection mode status (enabled/disabled) - Position 1 coordinates - Position 2 coordinates - Selection dimensions (width x height x depth) - Block count - Entity count

clear¶

Clear your current selection.

Usage: /select clear

Removes both position markers and hides the visual boundary.

export¶

Export your selection as a Sponge schematic file.

Usage: /select export <name>

Example:

# Select your island build with pos1 and pos2, then:
/select export my_custom_island

Output: plugins/HTSkyBlock/schematics/my_custom_island.schem

The exported schematic includes: - All blocks in the selection - Block metadata (rotation, properties) - Entities within the selection - Tile entity data (chests, signs, etc.)

paste¶

Paste a schematic at your current location.

Usage: /select paste <name>

Example:

# Stand where you want the schematic pasted, then:
/select paste my_custom_island

The schematic is pasted with its origin at your feet.

list¶

List all available schematic files.

Usage: /select list

Shows all .schem files in the schematics folder.

help¶

Display selection command help.

Usage: /select help

Creating Custom Islands¶

Method 1: Using Selection Tool¶

Build your island in-game at a convenient location
Stand at one corner of your build
Set position 1: /select pos1
Walk to opposite corner (diagonal)
Set position 2: /select pos2
Verify selection: /select info
Export schematic: /select export my_island

The schematic is saved to plugins/HTSkyBlock/schematics/my_island.schem

Method 2: Using External Tools¶

Create island in WorldEdit or another tool that exports Sponge Schematics
Export as .schem (Sponge Schematic v2 or v3)
Copy file to plugins/HTSkyBlock/schematics/
Test: /isdev create my_island.schem "Test Island" YourName

Method 3: Using Hytale Prefabs¶

Create structure in Hytale's builder tools
Export as prefab (.prefab.json)
Copy to server/prefabs/
Test: /isdev create island.prefab "Test Island" YourName

Island Structure Guidelines¶

Spawn Point¶

The first chest found in the structure is used as the home spawn point. If no chest exists, the center of the structure is used.

Best Practice: - Place a chest where you want players to spawn - Position it on the main platform - Ensure there's solid ground beneath

Size Recommendations¶

Island Type	Dimensions	Block Count	Description
Starter	5x5x3	~75	Minimal starting platform
Basic	9x9x5	~400	Small island with tree
Standard	15x15x10	~2,000	Medium island with features
Large	25x25x15	~9,000	Large custom island
Massive	50x50x20	~50,000	Complex detailed island

Performance

Very large schematics (>100,000 blocks) may cause lag when generating. Test performance before deploying to production.

Essential Elements¶

Include these elements in your island designs:

Starting platform - Solid ground to spawn on
Chest - Marks home spawn, can contain starter items
Tree - Source of wood (optional but recommended)
Water source - For cobblestone generation (optional)
Lava source - For cobblestone generation (optional)

Block Mapping¶

When importing schematics from other games/tools, HTSkyBlock attempts to map blocks to Hytale equivalents:

Schematic Block	Hytale Block
`minecraft:dirt`	`Soil_Dirt`
`minecraft:grass_block`	`Soil_Grass_Lush`
`minecraft:stone`	`Rock_Stone`
`minecraft:cobblestone`	`Rock_Cobblestone`
`minecraft:oak_log`	`Wood_Oak_Trunk`
`minecraft:oak_leaves`	`Plant_Leaves_Oak`
`minecraft:chest`	`Furniture_Crude_Chest_Small`
`minecraft:water`	`Liquid_Water`
`minecraft:lava`	`Liquid_Lava`

Unknown Blocks

Blocks without a mapping are skipped during import. Check console logs for unmapped block warnings.

Using Schematics with Commands¶

Create Island with Specific Schematic¶

/isdev create starter.schem "Starter Island" PlayerName

Create Island with Prefab¶

/isdev create island.prefab "Custom Island" PlayerName

Using Prefab Keyword¶

If you don't specify a file extension, add .schem or use the prefab keyword:

# Uses schematic
/isdev create starter "Test Island" PlayerName

# Uses default prefab
/isdev create prefab "Test Island" PlayerName

File Management¶

Organizing Schematics¶

Create subdirectories for organization:

plugins/HTSkyBlock/schematics/
├── starter/
│   ├── basic.schem
│   ├── forest.schem
│   └── desert.schem
├── premium/
│   ├── castle.schem
│   └── mansion.schem
└── event/
    └── holiday.schem

Reference with path: /isdev create starter/basic.schem "Island" Player

Backup Recommendations¶

Regularly backup your schematic files:

# Copy schematics folder
cp -r plugins/HTSkyBlock/schematics/ backups/schematics-2024-01-15/

# Copy prefabs folder
cp -r server/prefabs/ backups/prefabs-2024-01-15/

Troubleshooting¶

"Schematic not found" Error¶

Possible Causes: - File doesn't exist in the correct folder - Incorrect filename or path - File extension missing

Solutions: - Check plugins/HTSkyBlock/schematics/ for .schem files - Check server/prefabs/ for .prefab.json files - Include full filename with extension - Verify file permissions (readable by server)

"Failed to import schematic" Error¶

Possible Causes: - Corrupted schematic file - Unsupported schematic version - Invalid JSON in prefab file

Solutions: - Re-export the schematic from source - Verify file is Sponge Schematic v2 or v3 - Validate JSON in prefab files - Check console for specific error messages

Blocks Not Placing¶

Possible Causes: - Block mapping failed - Unknown block types - Chunk not loaded

Solutions: - Check console for unmapped block warnings - Use Hytale prefabs for 100% compatibility - Wait for chunks to load before importing large structures

Structure Spawns in Wrong Location¶

The structure spawns with its origin (0,0,0 in the schematic) at the specified coordinates.

Solutions: - Adjust your schematic's origin point - Use the center of your structure as origin - Test with /select paste first to verify placement

Advanced: Schematic Analysis¶

Use the schematic analyzer commands (if available):

/schematicanalyze my_island.schem

Displays: - Block count and types - Entity count - Dimensions - Estimated generation time - Memory usage

Permissions¶

Command	Permission
/select *	No permission required (available to all admins)
Selection commands	Should be restricted to trusted staff

Recommended permissions:

permissions:
  htskyblock.admin.selection

Best Practices¶

Test schematics on a test server before using in production
Keep originals of all custom schematics in version control
Document structures with comments in JSON or README files
Use prefabs when possible for best Hytale compatibility
Optimize sizes - remove unnecessary blocks in hidden areas
Include starter items in chests for new players
Version your schematics - name them with version numbers (island_v1.schem, island_v2.schem)

Example Workflow¶

Creating and deploying a new island design:

# 1. Build the island in creative mode
/gamemode creative

# 2. Select the build
/select pos1
# (walk to opposite corner)
/select pos2

# 3. Verify selection
/select info

# 4. Export
/select export premium_island_v1

# 5. Test on alt account
/isdev create premium_island_v1.schem "Test Premium" AltAccount

# 6. If good, set as default for premium players
# Edit config.json or create custom creation logic

# 7. Backup
cp plugins/HTSkyBlock/schematics/premium_island_v1.schem backups/

Resources¶

Sponge Schematic Specification
WorldEdit Documentation
HTSkyBlock includes schematic import/export compatible with standard tools