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

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

World Creation

Automatic Creation

The plugin automatically creates the skygrid world on server startup:

On first server start with the plugin installed, a world named "skyworld" is created
The world uses the custom "Skygrid" world generator
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

Command	Description	Permission
`/skygrid`	Teleport to a random location in the skygrid world	`skygrid.teleport`

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

Permission	Description
`skygrid.teleport`	Allows the player to use the `/skygrid` command

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

Option	Default	Description
`WorldName`	`"skyworld"`	Name of the skygrid world
`Environment`	`"Surface"`	World environment type
`GridSpacing`	`4`	Distance between blocks (4 = block at 0,4,8,12…)
`MinY`	`64`	Lowest Y level for block generation
`MaxY`	`192`	Highest Y level for block generation
`TeleportMinX/MaxX`	`-1000`/`1000`	X bounds for random teleport
`TeleportMinZ/MaxZ`	`-1000`/`1000`	Z bounds for random teleport
`TeleportCooldownSeconds`	`30`	Cooldown between `/skygrid` uses
`Blocks`	200 blocks	List of block types for random selection

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!

SouzaSkygrid