Skip to content

Repository files navigation

Plots

Grid-based plot management for Hytale.
A generated world of roads and parcels, a claim every player fully controls, and protection that holds even against BuilderTools.

Documentation Latest release Hytale server plugin

multi-world BuilderTools-safe protection TaleGuard optional i18n en_us | pt_br | es_es | ru_ru

📖 Read the full documentation →


Overview

Plots turns a Hytale world into a plot server. It generates a grid of parcels separated by roads, hands each player a claim they own outright, and keeps everything outside that claim protected — roads, neighbours, and the rest of the world.

The protection is the part that matters. Plots enforces it across the packet, mask and chunk-accessor paths, so a builder with BuilderTools cannot extrude or brush their way past a plot border — the flow most plot plugins leave open.

  • Grid world generation — configurable plot and road sizes, borders, and prefab-driven terrain
  • Full claim workflow — claim, auto-claim, rename, transfer (offline players included), trust, merge/unmerge
  • BuilderTools-safe protection — break, place, interact, liquid, mobs and item flow, with staff bypass permissions
  • Multi-world — several plot worlds side by side, each with its own grid and rules
  • In-game menu & HUD — the everyday actions without memorising commands, plus per-plot warps and spawn points
  • Integrations — all optional: TaleGuard for the mixin-only flags, economy charging, Hylograms ownership signs, PlaceholderAPI, SQL persistence
  • Public API — query plots and hook claim/unclaim/trust/rename events from your own plugin

Quick start

  1. Drop Plots-<version>.jar from the latest release into your server's mods/ folder.
  2. Start the server once to generate config.json and the language files.
  3. Run /plot worlds and create your first plot world (or follow the setup prompt shown on join).
  4. Head into that world and run /plot auto to claim a plot and start building.

Aliases /plots, /plotme and /p all work. The Getting Started guide covers this in full, including plot/road sizing and economy setup.


Documentation

Everything lives on the docs site — mechanics, every config key, and the full command reference:

🚀 Getting Started Install to first claimed plot
🧱 World Generation · Multi-World · Protection · Flags How it works
⚙️ Config Reference · Prefabs · Translations Configuration
🔌 TaleGuard · Hylograms · PlaceholderAPI · Developer API Integrations & API
📖 Commands · Permissions Reference
📝 Changelog What changed in each release

Building from source

./gradlew jar        # → build/libs/Plots-<version>.jar

The build compiles against HytaleServer.jar from your Hytale install; point it elsewhere with -Phytale_home=/path/to/Hytale. The docs live in docs/ (VitePress) and deploy to GitHub Pages automatically on push to main.


Built for Hytale by Gustavo Will · Stoshe Labs · MIT
Also on CurseForge · Discord · help translate on Crowdin

About

Grid-based plot management for Hytale: player-owned claims across multiple plot worlds, with flags, merging and protection that holds even against BuilderTools.

Resources

Stars

Watchers

Forks

Releases

Contributors

Languages