🛡 Secure Plots

Minecraft 1.21.1 — Fabric
Territory protection mod with menus, roles, upgrades, rank-based permissions, ambient effects, and a fully configurable visual border system.

Requirements

Minecraft 1.21.1
Fabric Loader ≥ 0.15.0
Fabric API
Java 21+

Installation

Drop the .jar into your mods/ folder on both server and client.
Start the server once to generate config files in config/.
Edit secure_plots.json (server behaviour) and secure_plots_client.json (visual settings).

How it works

Place a Plot Block to claim that area. The block’s tier determines how large the protected zone is. Right-click the block or use the Plot Blueprint item to open the management menu.

Plot tiers (all configurable)

| Tier | Name | Default radius |
|——|——|—————-|
| 0 | Bronze | 15 × 15 |
| 1 | Gold | 30 × 30 |
| 2 | Emerald | 50 × 50 |
| 3 | Diamond | 75 × 75 |
| 4 | Netherite | 100 × 100 |

Commands

All commands are available as /sp or /secureplots.

Player commands

Plot argument: most commands that accept [plot] accept a plot name, its number from /sp list, or all.

Admin commands

All /sp admin commands require OP level ≥ adminOpLevel (default: 2).

Roles & permissions

Roles

Global flags (`/sp flag`)

Global flags affect everyone inside the plot, including visitors.

Individual permissions (`/sp perm`)

Assignable per member or per permission group.

Construction: BUILD BREAK PLACE

Interaction: INTERACT CONTAINERS USE_BEDS USE_CRAFTING USE_ENCHANTING USE_ANVIL USE_FURNACE USE_BREWING

Entities: ATTACK_MOBS ATTACK_ANIMALS PVP RIDE_ENTITIES INTERACT_MOBS LEASH_MOBS SHEAR_MOBS MILK_MOBS

Nature: CROP_TRAMPLING PICKUP_ITEMS DROP_ITEMS BREAK_CROPS PLANT_SEEDS USE_BONEMEAL BREAK_DECOR

Explosives: DETONATE_TNT GRIEFING

Misc: TP FLY ENTER CHAT COMMAND_USE

Management: MANAGE_MEMBERS MANAGE_PERMS MANAGE_FLAGS MANAGE_GROUPS

Rank-based permissions

Ranks let you give different players different plot feature limits — without touching individual permissions per player. Ranks use vanilla command tags, assigned with /tag <player> add <tag>.

How it works

Define ranks in secure_plots.json under rankPerks.
Assign tags to players with /tag <player> add <tag> or the shortcut /sp admin setrank <player> <tag>.
Players with no rank tag use the global defaults.
If a player has multiple rank tags, the most permissive value of each field wins.
The adminTag always bypasses all rank restrictions.

Rank fields

Example rank config

"rankPerks": [
  {
    "tag": "basic",
    "maxPlots": 1,
    "maxTier": 0,
    "canSetMusic": false,
    "canSetParticles": false,
    "canSetWeather": false,
    "canSetTime": false,
    "canFly": false,
    "canUpgrade": false,
    "canGroups": false
  },
  {
    "tag": "vip",
    "maxPlots": 5,
    "maxTier": 3,
    "canSetMusic": true,
    "canSetParticles": true,
    "canFly": true,
    "canUpgrade": true
  },
  {
    "tag": "mvp",
    "maxPlots": 10,
    "maxTier": 4,
    "hasRankProtection": true
  }
]

Server config — `secure_plots.json`

Feature toggles

General

Ambient settings

Inactivity expiry

"inactivityExpiry": {
  "enabled": false,
  "baseDays": 45,
  "daysPerTier": 5
}

When enabled, a plot expires if the owner hasn’t logged in for baseDays + (tier × daysPerTier) days. Plots with hasRankProtection are immune.

Tier configuration

"tiers": [
  { "tier": 0, "displayName": "Bronze",    "radius": 15,  "luminance": 4, "hardness": 50, "blastResistance": 1200 },
  { "tier": 1, "displayName": "Gold",      "radius": 30,  "luminance": 5, "hardness": 50, "blastResistance": 1200 },
  { "tier": 2, "displayName": "Emerald",   "radius": 50,  "luminance": 6, "hardness": 50, "blastResistance": 1200 },
  { "tier": 3, "displayName": "Diamond",   "radius": 75,  "luminance": 7, "hardness": 50, "blastResistance": 1200 },
  { "tier": 4, "displayName": "Netherite", "radius": 100, "luminance": 8, "hardness": 50, "blastResistance": 1200 }
]

Upgrade costs

Each upgrade can require any number of items from any mod.

"upgradeCosts": [
  { "fromTier": 0, "toTier": 1, "items": [{ "itemId": "minecraft:gold_block", "amount": 15 }] },
  { "fromTier": 1, "toTier": 2, "items": [{ "itemId": "minecraft:emerald_block", "amount": 10 }] },
  { "fromTier": 2, "toTier": 3, "items": [{ "itemId": "minecraft:diamond", "amount": 64 }] },
  { "fromTier": 3, "toTier": 4, "items": [{ "itemId": "minecraft:netherite_block", "amount": 1 }] }
]

Default role permissions

Permissions automatically granted when a member is added by role.

"roleDefaults": {
  "admin":   ["BUILD", "INTERACT", "CONTAINERS", "PVP", "MANAGE_MEMBERS", "MANAGE_PERMS", "TP", "ENTER"],
  "member":  ["BUILD", "INTERACT", "CONTAINERS", "TP", "ENTER"],
  "visitor": ["INTERACT", "ENTER"]
}

Default flags for new plots

"defaultFlags": ["ALLOW_TP", "GREETINGS"]

Crafting recipes

Recipes for plot blocks and the blueprint item. Each can be disabled individually ("disabled": true) so the item is only obtainable in creative mode or via /sp admin.

"craftingRecipes": [
  {
    "result": "secure-plots:bronze_plot_block",
    "pattern": ["CBC", "BHB", "CBC"],
    "key": {
      "C": "minecraft:copper_block",
      "B": "minecraft:redstone_block",
      "H": "minecraft:heart_of_the_sea"
    }
  },
  {
    "result": "secure-plots:plot_blueprint",
    "pattern": ["SPS", "PCP", "SPS"],
    "key": {
      "S": "minecraft:amethyst_shard",
      "P": "minecraft:paper",
      "C": "minecraft:compass"
    }
  }
]

Client visual config — `secure_plots_client.json`

This file lives on the server and is automatically synced to every client on join. Edit it server-side — changes propagate instantly on the next /sp admin reload.

Plot border — thickness

Plot border — animation

Plot border — tier colors

Each tier has 9 color channels (values 0.0–1.0):

"tierColors": [
  {
    "tier": 0,
    "coreR": 1.0, "coreG": 0.55, "coreB": 0.05,
    "glowR": 0.7, "glowG": 0.28, "glowB": 0.0,
    "whiteR": 1.0, "whiteG": 0.88, "whiteB": 0.55
  }
]

Hologram

The floating info panel displayed above plot blocks.

Hologram text labels (all customizable)

Plot management screen

Screen panel colors (ARGB hex)

Localisation

Two languages are bundled: en_us (English) and es_es (Rioplatense Spanish). All 260+ translation keys cover commands, UI, tooltips, HUD messages, permission names, and every player-facing string.

To add another language, create assets/secure-plots/lang/<locale>.json in a resource pack using the existing files as a template.

Server admin quick reference

Support

If Secure Plots is useful for your server, consider supporting development:

介绍

🛡 Secure Plots

Requirements

Installation

How it works

Plot tiers (all configurable)

Commands

Player commands

Admin commands

Roles & permissions

Roles

Global flags (/sp flag)

Individual permissions (/sp perm)

Rank-based permissions

How it works

Rank fields

Example rank config

Server config — secure_plots.json

Feature toggles

General

Ambient settings

Inactivity expiry

Tier configuration

Upgrade costs

Default role permissions

Default flags for new plots

Crafting recipes

Client visual config — secure_plots_client.json

Plot border — thickness

Plot border — animation

Plot border — tier colors

Hologram

Hologram text labels (all customizable)

Plot management screen

Screen panel colors (ARGB hex)

Localisation

Server admin quick reference

Support

License

常见问题

Secure Plots 支持哪些 Minecraft 版本？

Secure Plots 怎么安装？

评论

Global flags (`/sp flag`)

Individual permissions (`/sp perm`)

Server config — `secure_plots.json`

Client visual config — `secure_plots_client.json`