SmartPlots

📥 Installation

Requirements

• Hytale Server (Early Access)
• LuckPerms (required)
• Economy Plugin (optional)

Setup

1. Download SmartPlots.jar from your purchase
2. Copy the JAR to Hytale/UserData/Mods/
3. Install LuckPerms for permission management
4. (Optional) Install an economy plugin for plot costs
5. Start your Hytale server — config is auto-generated

🚀 Quick Start

For Players

1. Join the server and enter the plot world
2. Type /plot auto to find and claim a free plot
3. Start building! Your first 4 plots are free
4. Invite friends with /plot trust <name>
5. Customize your plot border with /plot rand <block>

For Admins

1. Edit config.json to customize plot sizes, costs, and features
2. Set up LuckPerms groups for VIP tiers
3. Configure economy provider (or use free mode)

✨ Features

🎮 Commands

Plot Management

Navigation

Customization

Confirmation

🤝 Trust System

Control who can interact with your plot using the trust system. There are three access levels:

🔗 Plot Merging

Combine adjacent plots to create massive building areas. You must own both plots to merge them.

🏳️ Plot Flags

Customize individual plot behavior with flags.

🎨 Plot Customization

Wall & Border Blocks

Players can personalize their plots by changing wall and border blocks:

• Border — Top layer at Y=floorY+1 (e.g., Y=65). Changed with /plot rand
• Wall — Blocks from Y=1 to floorY below the border. Changed with /plot wall

# Examples
/plot wall stone
/plot wall plank_tropical
/plot rand rock_gold_brick_half
/plot rand glass

Plot Aliases

Give your plot a memorable name instead of coordinates:

/plot alias my-castle       # Set alias
/plot home my-castle        # Navigate by alias
/plot alias remove           # Remove alias

Aliases are max 25 characters, alphanumeric + underscore/dash. A blacklist prevents inappropriate names.

💰 Economy System

How It Works

Players receive a configurable number of free plots (default: 4). After that, each additional plot costs money.

# Example flow: Player claims their 5th plot
Player: /plot claim
System: "This will cost: 1000$"
System: "Use /plot confirm to proceed or /plot cancel to abort"

Player: /plot confirm
System: "Successfully claimed plot 5;3! Cost: 1000$"

Pricing Modes

🏦 Economy Providers

SmartPlots supports 5 economy providers. Set your preference in config.json:

"preferredEconomyProvider": "auto"
// Options: "auto", "economysystem", "vaultunlocked", "ecotale", "hyvault", "none"

With "auto", SmartPlots detects providers in this order: EconomySystem → VaultUnlocked → HyVault → Ecotale → None

🎁 Free Plot Tiers

Reward players and VIP ranks with different amounts of free plots:

# LuckPerms setup examples
/lp group vip permission set plot.claim.free.10 true
/lp group premium permission set plot.claim.free.25 true
/lp group admin permission set plot.claim.free.unlimited true

🔐 Permissions

Player Permissions

Admin Bypass Permissions

Wildcards

Example LuckPerms Setup

# Default players — all basic commands
/lp group default permission set plot.player.* true

# VIP — 10 free plots, all blocks
/lp group vip permission set plot.player.* true
/lp group vip permission set plot.claim.free.10 true
/lp group vip permission set plot.wallblock.* true
/lp group vip permission set plot.borderblock.* true

# Moderator — bypass for other plots
/lp group mod permission set plot.admin.bypass.* true
/lp group mod permission set smartplots.admin true

# Administrator — everything
/lp group admin permission set plot.* true
/lp group admin permission set smartplots.admin true

⚙️ Configuration

The config.json is auto-generated on first start. Here are the key settings:

Economy Settings

Plot Settings

Teleport Settings

Other Settings

Full Example

{
  "plotSize": 32,
  "roadWidth": 3,
  "borderWidth": 1,
  "floorY": 64,
  "economyPlotCost": 1000.0,
  "economyProgressiveCosts": false,
  "economyDefaultFreePlots": 4,
  "economyMergeCost": 10000.0,
  "preferredEconomyProvider": "auto",
  "teleportWarmupSeconds": 3,
  "cancelTeleportOnDamage": true,
  "language": "en",
  "storageType": "H2"
}

💾 Database

Storage Options

MySQL Configuration

{
  "storageType": "MySQL",
  "mysqlHost": "localhost",
  "mysqlPort": 3306,
  "mysqlDatabase": "plots",
  "mysqlUsername": "root",
  "mysqlPassword": "password"
}

Database Migration

Migrate between storage backends with the admin command:

/plot port sqlite    # Migrate to SQLite

🛠️ Admin Commands

🛡️ Protection System

SmartPlots provides comprehensive protection for all plots:

📋 Changelog

❓ FAQ & Troubleshooting

"No free plots found in search radius!"

The /plot auto search area is limited. Move to a different area or use /plot claim manually on an unclaimed plot.

"This plot is already claimed!"

Someone owns this plot. Use /plot info to see the owner, or find another plot.

"Insufficient funds!"

You've used all your free plots and don't have enough money. Earn more or ask an admin about VIP ranks with more free plots.

"You are denied access to this plot!"

The plot owner has denied you. Contact them to be removed from the deny list.

Teleport gets cancelled

Stand still for the warmup period (default 3 seconds). Don't move or take damage.

Black sky in plot world

Update to v1.1.0+. The PlotEnvironmentFixer automatically sets the correct environment for proper sky rendering.

📞 Support