Wards

!(https://cdn.modrinth.com/data/cached_images/38c5ba2fd5f1b1cb06005b487077a850c5ccebdf.jpeg)

# 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 item is returned to 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 |

!(https://cdn.modrinth.com/data/cached_images/02e75d0bcd586582db305a9014db5acd11c68181.jpeg)

!(https://cdn.modrinth.com/data/cached_images/822f675679a17057a49d48b992ddad5db07fcb58.jpeg)

!(https://cdn.modrinth.com/data/cached_images/3ada56c7793c08c794c294c3b7406ce69bdfab2f.jpeg)

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 individually toggleable in `config.yml`):

| Category | Config key | Notes | |----------|------------|-------| | Block placing | `block_place` | | | Block breaking | `block_break` | | | Block interaction | `interact` | Buttons, chests, doors, etc. VISITOR trust members can still interact — see Trust Levels | | Explosions | `explosion` | Creeper, TNT, etc. | | Fire spread | `fire` | | | Piston push/pull | `piston` | Blocks cannot be pushed or pulled across ward boundaries | | Entity grief | `entity_grief` | Endermen, silverfish, Wither, Ravagers, and other griefing mobs cannot alter blocks | | Fluid flow | `fluid_flow` | Lava and water cannot flow into a ward from outside | | Hanging entities | `hanging` | Item frames and paintings are protected from non-members | | PVP | `pvp` | Outsiders cannot attack players inside. Per-ward override: Allow PVP flag | | Entity damage | `entity_damage` | Outsiders cannot damage animals or mobs inside. Per-ward override: Allow Mob Damage flag | | Crop trampling | `crop_trample` | Non-members cannot trample farmland | | Bucket pouring | `bucket_pour` | Non-members cannot pour lava or water buckets inside a ward | | Entity placement | `entity_place` | Non-members cannot place armor stands, boats, or minecarts | | Vehicle destruction | `vehicle_destroy` | Non-members cannot damage or destroy vehicles inside a ward | | Block spread | `block_spread` | Fire, sculk, vines, etc. cannot spread into a ward from outside |

The ward owner and all 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.

## Trust Levels

When adding a member to a ward, they receive a trust level that controls what they can do inside:

| Level | Can Do | Cannot Do | |-------|--------|-----------| | Member (default) | Build, break blocks, use all items | — | | Visitor | Open doors, chests, buttons, containers | Place or break blocks, use buckets |

Trust levels are assigned and changed per-member from the Manage Members screen in the ward GUI. Click a member's skull to open their trust sub-menu and select a level. The change takes effect immediately.

Trust level enforcement can be disabled server-wide in `config.yml` (`trust_levels.enabled: false`), which makes Visitors behave identically to Members.

## Ward Menu

Right-clicking the ward block opens a management GUI. The menu adapts based on who is clicking:

Owner / Admin view — full management access:

| Item | Action | |------|--------| | Name Tag — Rename | Set a custom name for this ward | | Bell — Toggle Alerts | Turn entry notifications on/off for this ward | | Player Head — Manage Members | View and manage all current members and their trust levels | | Paper — History | Show the last 20 entry log entries | | Spyglass — Show Radius | Draw a purple particle boundary for 10 seconds | | Emerald — Add Member | Type a player name in chat to add them (enforces tier member limit) | | Feather — Entry Message | Set a custom message visitors see on entry. Supports `&` color codes and `&#RRGGBB` hex. Placeholders: `%ward%`, `%owner%`, `%tier%`, `%radius%`. Type `clear` to remove | | Allow PVP | Per-ward toggle to allow outsiders to PVP inside this ward | | Allow Mob Damage | Per-ward