SouzaSkygrid

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!