Souza Skygrid

A Hytale server mod that generates a Skygrid world - a challenging survival experience where single blocks are scattered in a 3D grid pattern floating in the void. Players must carefully navigate between blocks to survive!

Features

• Skygrid World Generation - Automatically generates a world with blocks placed in a 3D grid pattern
• 200 Different Blocks - Includes rocks, ores, soil, and wood for variety and resources. The block list is configurable.
• /skygrid Command - Teleports players to a random location in the skygrid world
• Fully Configurable - Customize grid spacing, Y range, block list, and more
• Teleport Cooldown - Prevents command spam with configurable cooldown

How It Works

World Generation

The plugin generates a unique world called "skyworld" where individual blocks are placed in a 3D grid pattern with empty space (void) between them.

Grid Pattern (Top View, spacing=4):

X:  0   4   8   12  16  20 ...
    █   █   █   █   █   █

    █   █   █   █   █   █

    █   █   █   █   █   █
Z:  0   4   8   12  16  20 ...

█ = Random block from configured list
(empty) = Air/Void

The same pattern extends vertically from Y=64 to Y=192 (configurable), creating a true 3D grid of floating blocks.

Block Selection

Each block position gets a random block from the configured list of 200 blocks. The randomization is deterministic based on position, meaning the same coordinates will always have the same block type.

Default block categories:

• Rock Blocks (70) - Stone, Basalt, Marble, Sandstone, and more
• Ore Blocks (58) - Iron, Copper, Gold, Silver, Cobalt, Mithril, Adamantite, etc.
• Soil Blocks (32) - Dirt, Grass, Sand, Clay, Gravel, Snow
• Wood Blocks (40) - Various tree trunks and planks

Installation

1. Download the latest souza-skygrid-X.X.X.jar file
2. Place it in your Hytale server's Mods folder
3. Start (or restart) your server
4. The plugin will automatically create the "skyworld" world

World Creation

Automatic Creation

The plugin automatically creates the skygrid world on server startup:

1. On first server start with the plugin installed, a world named "skyworld" is created
2. The world uses the custom "Skygrid" world generator
3. Players can immediately use /skygrid to teleport there

Manual World Creation

If you want to create additional skygrid worlds or customize the world settings, you can create a world configuration file:

Example: worlds/my-skygrid/world.json

{
  "WorldGen": {
    "Type": "Skygrid",
    "GridSpacing": 4,
    "MinY": 64,
    "MaxY": 192,
    "Environment": "Surface",
    "Blocks": [
      "Rock_Stone",
      "Ore_Iron_Stone",
      "Wood_Oak_Trunk_Full",
      "Soil_Grass"
    ]
  }
}

Commands

When using /skygrid:

• Requires skygrid.teleport permission
• Player is teleported to a random grid position within configured bounds
• Player spawns on top of a block
• A 30-second cooldown prevents spam (configurable)
• Players already in the skygrid world cannot use the command

Permissions

Configuration

The plugin creates a configuration file at plugins/Hytale/Skygrid/config.json:

{
  "WorldName": "skyworld",
  "Environment": "Surface",
  "GridSpacing": 4,
  "MinY": 64,
  "MaxY": 192,
  "TeleportMinX": -1000,
  "TeleportMaxX": 1000,
  "TeleportMinZ": -1000,
  "TeleportMaxZ": 1000,
  "TeleportCooldownSeconds": 30,
  "Blocks": [
    "Rock_Stone",
    "Rock_Basalt",
    "Ore_Iron_Stone",
    ...
  ],
  "Messages": {
    "Prefix": "[Skygrid] ",
    "PlayerOnly": "This command can only be used by players.",
    "NoPermission": "You don't have permission to use this command.",
    "AlreadyInSkygrid": "You are already in the skygrid world.",
    "WorldNotReady": "The skygrid world is not ready yet.",
    "Cooldown": "You must wait %d seconds before using this command again.",
    "Teleported": "Teleported to skygrid at (%d, %d, %d)"
  }
}

Configuration Options

Customizing the Block List

You can modify the Blocks array to include any valid Hytale block types. For example, to create an ore-only skygrid:

{
  "Blocks": [
    "Ore_Iron_Stone",
    "Ore_Gold_Stone",
    "Ore_Copper_Stone",
    "Ore_Silver_Stone",
    "Ore_Cobalt_Stone",
    "Ore_Mithril_Stone",
    "Ore_Adamantite_Stone"
  ]
}

Support

If you encounter issues or have suggestions:

• Report bugs on GitHub Issues
• Discord

License

This plugin is open source under MIT LICENSE.

Enjoy your skygrid adventure!