Installation

Requirements

• A Hytale server with plugin support
• Java 17 or higher

Optional Dependencies

• WiFlowPlaceholderAPI — Enables placeholder support in messages

Install Steps

1. Download HTSkyBlock.jar and place it in your server's mods/ folder
2. Start the server once — the plugin will generate default config files in plugins/HTSkyBlock/
3. Stop the server
4. Edit plugins/HTSkyBlock/config.json to configure the plugin (see Configuration)
5. Optionally add schematics to plugins/HTSkyBlock/schematics/ or prefabs to server/prefabs/
6. Start the server

First-Time Setup Checklist

• [ ] Choose island mode: per_world (each player gets their own world) or single_world (all islands in one shared world)
• [ ] Choose island generation type: schematic or prefab
• [ ] Set spawn coordinates in the spawn config section
• [ ] Configure economy settings (built-in or external provider)
• [ ] Set up starter items for normal and hardcore modes
• [ ] Add shop categories and items using /htshop commands
• [ ] Configure block worth values in blockworth.json for island scoring
• [ ] Set up permissions for your player ranks

File Structure

After first run, the plugin creates these files in plugins/HTSkyBlock/:

plugins/HTSkyBlock/
  config.json           # Main configuration
  islands.json          # Island data
  economy.json          # Player balances (self economy)
  shop.json             # Shop items and categories
  blockworth.json       # Block worth values for scoring
  challenges.json       # Challenge definitions
  challenge_data.json   # Player challenge progress
  ahlist.json           # Auction house listings
  stacked_blocks.json   # Stacked block data
  npcs.json             # NPC data
  homes.json            # Player home points
  cinematics.json       # Cinematic sequences
  flytime_data.json     # Timed fly balances
  lang/
    en.json             # English language file
  schematics/           # Schematic files for island generation