<\/p>\n
# MachinaWards<\/p>\n
**Protect your builds with configurable land claim wards \u2014 no grief, no drama.**<\/p>\n
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.<\/p>\n
—<\/p>\n
## How It Works<\/p>\n
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 \u2014 the ward stays in your inventory so you can relocate it any time.<\/p>\n
Right-click the ward block to open the management menu.<\/p>\n
—<\/p>\n
## Ward Tiers<\/p>\n
| Tier | Block | Default Radius | Member Limit | Ward Intelligence |
\n| ———— | ————— | ————– | ———— | —————– |
\n| **Basic** | Lantern | 12 blocks | 5 | \u2014 |
\n| **Advanced** | Beacon | 20 blocks | 10 | \u2014 |
\n| **Super** | Crying Obsidian | 30 blocks | Unlimited | Yes |<\/p>\n
<\/p>\n
<\/p>\n
<\/p>\n
All tiers, recipes, radii, prices, and member limits are fully configurable in `config.yml`. Server operators can add or rename tiers freely.<\/p>\n
—<\/p>\n
## Protection<\/p>\n
Inside a ward, the following are blocked for non-members (all toggleable per category in `config.yml`):<\/p>\n
– Block placing and breaking
\n– Block interaction (buttons, chests, doors, etc.)
\n– Explosions (creeper, TNT, etc.)
\n– Fire spread
\n– **Piston pushing\/pulling** blocks across ward boundaries
\n– **Entity grief** \u2014 Endermen, silverfish, Wither, Ravagers, and other griefing mobs can’t alter blocks inside a ward
\n– **Fluid flow** \u2014 lava and water can’t flow into a ward from outside
\n– **Hanging entities** \u2014 non-members can’t break item frames or paintings
\n– **PVP** \u2014 outsiders can’t attack players inside a ward *(per-ward override: Allow PVP flag)*
\n– **Entity damage** \u2014 outsiders can’t damage animals or mobs inside a ward *(per-ward override: Allow Mob Damage flag)*
\n– **Crop trampling** \u2014 non-members can’t trample farmland inside a ward<\/p>\n
The ward owner and any added members bypass all restrictions. Players with `wards.admin` bypass everything.<\/p>\n
Wards cannot overlap \u2014 placement is blocked if the new ward’s radius intersects an existing one, keeping protection zones unambiguous.<\/p>\n
—<\/p>\n
## Ward Menu<\/p>\n
Right-clicking the ward block opens a GUI with:<\/p>\n
– **Rename** \u2014 give your ward a custom name, shown in menus and `\/ward list`
\n– **Entry Message** \u2014 set a custom message visitors see on entry. Supports `&` color codes and `&#RRGGBB` hex colors. Placeholders: `%ward%`, `%owner%`, `%tier%`, `%radius%`. Type `clear` to remove
\n– **Toggle Alerts** \u2014 turn entry notifications on\/off for this ward
\n– **Members** \u2014 view all current members
\n– **Add Member** \u2014 type a player name in chat to add them (enforces tier member limit)
\n– **Remove Member** \u2014 click a player skull to remove them
\n– **History** \u2014 view the last 20 entry log entries
\n– **Show Radius** \u2014 draws a purple particle boundary for 10 seconds so you can visualize your claim
\n– **Allow PVP** \u2014 per-ward toggle to allow outsiders to PVP inside this specific ward
\n– **Allow Mob Damage** \u2014 per-ward toggle to allow outsiders to damage animals\/mobs inside this specific ward
\n– **Ward Intelligence** *(Super Ward only)* \u2014 access the feature tracking system<\/p>\n
—<\/p>\n
## Super Ward \u2014 Ward Intelligence<\/p>\n
Super wards include a **Ward Intelligence** menu with five toggleable tracking features:<\/p>\n
| Feature | What It Tracks |
\n| ——————– | ———————————————————- |
\n| **Creeper Alert** | Notifies the owner when a creeper explodes inside the ward |
\n| **Mob Kills Player** | Logs and alerts when a mob kills a player inside the ward |
\n| **Mob Kills Entity** | Logs when a mob kills any entity inside the ward |
\n| **Player Death** | Logs every player death inside the ward |
\n| **Explosion Log** | Logs all explosions inside the ward |<\/p>\n
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.<\/p>\n
—<\/p>\n
## Economy Shop<\/p>\n
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`.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | —<\/p>\n ## Permissions<\/p>\n | Node | Description | —<\/p>\n ## Visual & Sound Effects<\/p>\n **Particles**<\/p>\n – **Ambient particles** \u2014 a subtle END_ROD effect floats above each ward block so you always know where your wards are (configurable interval) **Sounds** *(all configurable in `config.yml \u2192 sounds:`)*<\/p>\n – `ward_place` \u2014 plays when a ward block is placed Set any sound to `””` to disable it individually.<\/p>\n —<\/p>\n ## Entry Warnings<\/p>\n When a non-member enters a ward they see an action bar notification showing the ward name and owner. This is configurable per ward \u2014 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`.<\/p>\n —<\/p>\n ## Ward Compass<\/p>\n `\/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 \u2014 any compass in your inventory will work.<\/p>\n —<\/p>\n ## Ownership Transfer<\/p>\n `\/ward transfer —<\/p>\n ## Nearby Wards<\/p>\n `\/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.<\/p>\n —<\/p>\n ## Anti-Abuse<\/p>\n – Ward items cannot be used as crafting ingredients —<\/p>\n ## Database<\/p>\n MachinaWards stores all ward data in a database. Two backends are supported:<\/p>\n **SQLite** *(default \u2014 no setup required)*<\/p>\n “`yaml Data is stored in `plugins\/MachinaWards\/MachinaWards.db`.<\/p>\n **MySQL \/ MariaDB**<\/p>\n “`yaml The MySQL driver is downloaded automatically \u2014 no manual installation needed. Use `\/ward admin migrate mysql` to copy existing SQLite data to MySQL before switching.<\/p>\n —<\/p>\n ## Configuration<\/p>\n Everything is configurable in `config.yml`:<\/p>\n – **Database:** SQLite (default) or MySQL\/MariaDB —<\/p>\n ## Dependencies<\/p>\n – **Spigot \/ Paper \/ Purpur** 1.21+ <\/p>\n","protected":false},"excerpt":{"rendered":" Physical land claim protection for Spigot, Paper & Purpur 1.21+. Place ward blocks to protect builds from
\n| —————————— | ————————————————————————– |
\n| `\/ward` | Show help |
\n| `\/ward shop` | Open the ward shop (requires Vault) |
\n| `\/ward list` | List your wards with names, tiers, worlds, and coords |
\n| `\/ward tp
\n| `\/ward compass [id|name]` | Point your compass at a ward (nearest, or by ID\/name) |
\n| `\/ward transfer
\n| `\/ward transfer
\n| `\/ward addmember
\n| `\/ward removemember
\n| `\/ward info [id|name]` | Show tier, radius, owner, and member info for a ward |
\n| `\/ward nearby [radius]` | List wards within radius blocks (default 100, max 500), sorted by distance |
\n| `\/ward admin list [player]` | *(admin)* List all wards, optionally filter by player |
\n| `\/ward admin delete
\n| `\/ward admin tp
\n| `\/ward admin stats` | *(admin)* Show total wards, per-world breakdown, members, and owner count |
\n| `\/ward admin migrate mysql` | *(admin)* Copy all ward data from SQLite to MySQL |
\n| `\/ward reload` | *(admin)* Reload config and re-register recipes |<\/p>\n
\n| —————— | —————————————————————- |
\n| `wards.admin` | Full administrative access \u2014 bypass protection, delete any ward |
\n| `wards.place` | Allows placing ward blocks (default: true for all players) |
\n| `wards.player.
\n– **Placement burst** \u2014 particle effect confirms a new ward was created
\n– **Deletion burst** \u2014 particle effect fires when a ward is broken or picked up
\n– **Radius preview** \u2014 purple particle ring shows your claim boundary for 10 seconds via the Show Radius button<\/p>\n
\n– `ward_break` \u2014 plays when a ward is broken\/removed
\n– `ward_pickup` \u2014 plays when a ward is picked up via sneak+right-click
\n– `entry_alert` \u2014 plays for the visitor when they enter a ward<\/p>\n
\n– Ward items cannot be inserted into beacon payment slots
\n– Wards cannot be placed overlapping an existing ward
\n– Picking up a ward block requires a second sneak+right-click confirmation within a configurable window (default 5 seconds) to prevent accidents<\/p>\n
\ndatabase:
\n type: sqlite
\n“`<\/p>\n
\ndatabase:
\n type: mysql
\n mysql:
\n host: localhost
\n port: 3306
\n database: machinawards
\n username: root
\n password: “”
\n“`<\/p>\n
\n– **Shape:** `column` (vertical cylinder, unlimited height) or `sphere` (3D radius)
\n– **World whitelist** \u2014 restrict wards to specific worlds
\n– **Height limits** \u2014 `min_y` \/ `max_y`
\n– **Alert cooldown** \u2014 default 90 seconds between entry notifications
\n– **Protection toggles** \u2014 individually enable\/disable each protection category
\n– **Per-tier:** display name, placed block material, crafting recipe, radius, price, member limit (`max_members`), features list
\n– **Particle type and interval**
\n– **Sound effects** \u2014 one config key per event, set to `””` to disable
\n– **Entry warning:** `entry.show_warning_to_visitor`, `entry.warning_format` with `%ward%`, `%owner%`, `%tier%`, `%radius%` placeholders
\n– **Pickup confirmation window:** `pickup.confirm_ms` (default 5000ms)
\n– **Color support:** all text fields support `&` color codes and `&#RRGGBB` hex colors<\/p>\n
\n– **Vault** *(optional)* \u2014 required only for the economy shop
\n– **MySQL\/MariaDB** *(optional)* \u2014 only if you choose the MySQL database backend<\/p>\n
\n griefing, manage members via GUI, track events with Ward Intelligence, and customize tiers, radii, and recipes in
\n config.<\/p>\n","protected":false},"featured_media":168598,"template":"","meta":{"_minecraft_slug":"wards","_minecraft_project_id":"SX98EKcZ","_minecraft_author":"Mxchina","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":121,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"wards.zip","_minecraft_size_bytes":13999613,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T19:15:17.478718Z","_minecraft_date_created":"2025-08-25T07:35:33.875186Z","_minecraft_date_modified":"2026-03-10T22:51:22.064894Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/wards","_minecraft_icon_attachment_id":168598,"_minecraft_imported_at":"2026-06-09T19:44:38+00:00","_minecraft_import_hash":"a4d8d84af12d3b5c1c255336536a4310","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,844,88,89,126,127,128,867,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-168597","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-economy","mod_category-equipment","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n