Friend Ship Union: Worldedit

Map generation and terrain tools for the Friend Ship Union (FSU) Hytale server. FSU is a frontier experiment in an RP setting, and Worldedit is the toolkit used to build and shape its worlds.

Features

Heightmap Import (/heightmap)

Import heightmap images as terrain, ready to paste into the world.

• File formats: PNG, BMP, JPEG, TGA (8/16-bit), raw F32 and F16 binary
• Import modes:
  • Heightmap -- solid terrain columns from pixel brightness
  • Surface -- single block per column at the derived height (hollow)
  • Colormap -- flat image-to-block colour matching
  • Normal Map -- surface shape derived from a normal-map image
• Controls: height scale (1--320), max size cap (1--1024), channel selection (luminance/R/G/B/alpha), origin positioning, invert, smooth pass
• Block patterns: single block or weighted random (e.g. 50%Rock_Stone,50%Rock_Basalt)
• File browser: browse files from the asset pack's Server/Imports/Heightmaps directory
• Auto paste: switches to the paste tool after import

Fill/Surface Utility (/fsu)

Terrain manipulation commands that operate on the current builder selection or specified coordinates.

Command	Description
/fsu filldown <depth> [--block Rock_Stone]	Fill below topmost blocks in selection down to Y depth
/fsu fillup <layers> [--block Soil_Grass]	Add layers on top of topmost blocks in selection
/fsu extrudedown <x1> <z1> <x2> <z2> <depth> [--block Rock_Stone]	Same as filldown but copies result to clipboard
/fsu layerbrush	Give yourself the Layer Brush custom builder tool

Layer Brush Tool

A custom builder tool that paints layers of a selected material on top of existing terrain. Configure shape, size, material, and layer count (1--10) from the standard builder tool UI.

World Generation (Asset Pack)

Included world generation configs for the FSU Season 0 map:

• Biomes: custom terrain layering (rock, sand, grass/dirt, water)
• Density functions: heightmap-driven terrain with world bounds
• World structure: HeightmapWorld -- ties together base heights, terrain, and biomes
• Instance: FSU-S0 -- ready-to-use world instance with spawn at (0, 150, 0)
• Textures: 11 heightmap/region textures for the Season 0 map

Installation

1. Build the mod: ./gradlew shadowJar
2. Copy build/libs/FSU-Worldedit-1.0.0.jar to your server's mods/ directory
3. Restart the Hytale server

Or use the deploy task: ./gradlew deployToServer

Development

Building

./gradlew shadowJar

Deploying to local server

./gradlew deployToServer

Shared reference docs

API, worldgen, UI, and modding reference docs live in ../hytale-docs/. See that project's README for regeneration instructions.

Project Structure

src/main/
  java/
    fsu/worldedit/              Main plugin + UI pages
    fsu/worldedit/commands/     Command handlers
    com/hypixel/.../             LayerBrush tool operation (engine namespace)
  resources/
    manifest.json               Mod manifest (Group: fsu, Name: Worldedit)
    Common/
      UI/Custom/Pages/          HeightmapImportPage.ui
      Textures/                 Season 0 heightmap textures
    Server/
      Languages/en-US/          worldedit.lang localization
      Item/Items/EditorTool/    LayerBrush.json item definition
      HytaleGenerator/          World gen configs (Biomes, Density, WorldStructure)
      Instances/                FSU-S0.bson world instance

License

MIT