Machina Wards Banner

MachinaWards

Protect your builds with configurable land claim wards — no grief, no drama.

MachinaWards lets players place physical ward blocks to claim and protect an area. Members can be added by the owner, events are logged, and outsiders are stopped cold. Three tiers of wards scale from starter bases to high-value infrastructure.

How It Works

Craft a ward item and place it like any block. The block marks the center of your protected zone. Break or sneak+right-click to pick it back up — the ward stays in your inventory so you can relocate it any time.

Right-click the ward block to open the management menu.

Ward Tiers

Tier	Block	Default Radius	Member Limit	Ward Intelligence
Basic	Lantern	12 blocks	5	—
Advanced	Beacon	20 blocks	10	—
Super	Crying Obsidian	30 blocks	Unlimited	Yes

All tiers, recipes, radii, prices, and member limits are fully configurable in config.yml. Server operators can add or rename tiers freely.

Protection

Inside a ward, the following are blocked for non-members (all toggleable per category in config.yml):

Block placing and breaking
Block interaction (buttons, chests, doors, etc.)
Explosions (creeper, TNT, etc.)
Fire spread
Piston pushing/pulling blocks across ward boundaries
Entity grief — Endermen, silverfish, Wither, Ravagers, and other griefing mobs can't alter blocks inside a ward
Fluid flow — lava and water can't flow into a ward from outside
Hanging entities — non-members can't break item frames or paintings
PVP — outsiders can't attack players inside a ward (per-ward override: Allow PVP flag)
Entity damage — outsiders can't damage animals or mobs inside a ward (per-ward override: Allow Mob Damage flag)
Crop trampling — non-members can't trample farmland inside a ward

The ward owner and any added members bypass all restrictions. Players with wards.admin bypass everything.

Wards cannot overlap — placement is blocked if the new ward's radius intersects an existing one, keeping protection zones unambiguous.

Ward Menu

Right-clicking the ward block opens a GUI with:

Rename — give your ward a custom name, shown in menus and /ward list
Entry Message — set a custom message visitors see on entry. Supports & color codes and &#RRGGBB hex colors. Placeholders: %ward%, %owner%, %tier%, %radius%. Type clear to remove
Toggle Alerts — turn entry notifications on/off for this ward
Members — view all current members
Add Member — type a player name in chat to add them (enforces tier member limit)
Remove Member — click a player skull to remove them
History — view the last 20 entry log entries
Show Radius — draws a purple particle boundary for 10 seconds so you can visualize your claim
Allow PVP — per-ward toggle to allow outsiders to PVP inside this specific ward
Allow Mob Damage — per-ward toggle to allow outsiders to damage animals/mobs inside this specific ward
Ward Intelligence (Super Ward only) — access the feature tracking system

Super Ward — Ward Intelligence

Super wards include a Ward Intelligence menu with five toggleable tracking features:

Feature	What It Tracks
Creeper Alert	Notifies the owner when a creeper explodes inside the ward
Mob Kills Player	Logs and alerts when a mob kills a player inside the ward
Mob Kills Entity	Logs when a mob kills any entity inside the ward
Player Death	Logs every player death inside the ward
Explosion Log	Logs all explosions inside the ward

Each feature has its own sub-menu where you can toggle it on/off, view recent logs, or clear the log history. All data is persisted to the database and wiped automatically when the ward is destroyed.

Economy Shop

If Vault is installed with an economy provider (e.g. EssentialsX), players can purchase ward items directly using /ward shop. Prices are set per tier in config.yml.

Commands

Command	Description
`/ward`	Show help
`/ward shop`	Open the ward shop (requires Vault)
`/ward list`	List your wards with names, tiers, worlds, and coords
`/ward tp <id \| name>`
`/ward compass [id \| name]`
`/ward transfer <player>`	Transfer your nearby ward to another player
`/ward transfer <id> <player>`	Transfer a specific ward to another player
`/ward addmember <player>`	Add a member to your nearby ward
`/ward removemember <player>`	Remove a member from your nearby ward
`/ward info [id \| name]`
`/ward nearby [radius]`	List wards within radius blocks (default 100, max 500), sorted by distance
`/ward admin list [player]`	(admin) List all wards, optionally filter by player
`/ward admin delete <id \| name>`
`/ward admin tp <id \| name>`
`/ward admin stats`	(admin) Show total wards, per-world breakdown, members, and owner count
`/ward admin migrate mysql`	(admin) Copy all ward data from SQLite to MySQL
`/ward reload`	(admin) Reload config and re-register recipes

Permissions

Node	Description
`wards.admin`	Full administrative access — bypass protection, delete any ward
`wards.place`	Allows placing ward blocks (default: true for all players)
`wards.player.<N>`	Cap how many wards a player can own (e.g.`wards.player.3`)

Visual & Sound Effects

Particles

Ambient particles — a subtle END_ROD effect floats above each ward block so you always know where your wards are (configurable interval)
Placement burst — particle effect confirms a new ward was created
Deletion burst — particle effect fires when a ward is broken or picked up
Radius preview — purple particle ring shows your claim boundary for 10 seconds via the Show Radius button

Sounds (all configurable in config.yml → sounds:)

ward_place — plays when a ward block is placed
ward_break — plays when a ward is broken/removed
ward_pickup — plays when a ward is picked up via sneak+right-click
entry_alert — plays for the visitor when they enter a ward

Set any sound to "" to disable it individually.

Entry Warnings

When a non-member enters a ward they see an action bar notification showing the ward name and owner. This is configurable per ward — owners can set a fully custom entry message with color codes and hex colors directly from the ward menu. The message supports placeholders: %ward%, %owner%, %tier%, and %radius%. The visitor warning can be toggled globally in config.yml.

Ward Compass

/ward compass sets your compass to point at your nearest ward in the current world. Specify an ID or name to target a specific ward. No special item is needed — any compass in your inventory will work.

Ownership Transfer

/ward transfer <player> while standing in a ward transfers ownership to another player. Use /ward transfer <id> <player> to transfer from anywhere. The new owner is notified immediately if they are online.

Nearby Wards

/ward nearby [radius] lists all wards within the given radius (default 100 blocks, max 500), sorted by distance. Shows each ward's name, tier, owner, and distance. Useful for scouts, admins, and players exploring unfamiliar territory.

Anti-Abuse

Ward items cannot be used as crafting ingredients
Ward items cannot be inserted into beacon payment slots
Wards cannot be placed overlapping an existing ward
Picking up a ward block requires a second sneak+right-click confirmation within a configurable window (default 5 seconds) to prevent accidents

Database

MachinaWards stores all ward data in a database. Two backends are supported:

SQLite (default — no setup required)

database:
  type: sqlite

Data is stored in plugins/MachinaWards/MachinaWards.db.

MySQL / MariaDB

database:
  type: mysql
  mysql:
    host: localhost
    port: 3306
    database: machinawards
    username: root
    password: ""

The MySQL driver is downloaded automatically — no manual installation needed. Use /ward admin migrate mysql to copy existing SQLite data to MySQL before switching.

Configuration

Everything is configurable in config.yml:

Database: SQLite (default) or MySQL/MariaDB
Shape: column (vertical cylinder, unlimited height) or sphere (3D radius)
World whitelist — restrict wards to specific worlds
Height limits — min_y / max_y
Alert cooldown — default 90 seconds between entry notifications
Protection toggles — individually enable/disable each protection category
Per-tier: display name, placed block material, crafting recipe, radius, price, member limit (max_members), features list
Particle type and interval
Sound effects — one config key per event, set to "" to disable
Entry warning: entry.show_warning_to_visitor, entry.warning_format with %ward%, %owner%, %tier%, %radius% placeholders
Pickup confirmation window: pickup.confirm_ms (default 5000ms)
Color support: all text fields support & color codes and &#RRGGBB hex colors

Dependencies

Spigot / Paper / Purpur 1.21+
Vault (optional) — required only for the economy shop
MySQL/MariaDB (optional) — only if you choose the MySQL database backend

Lower banner