Wards

- Choose how long Show Radius lasts. The Show Radius button outlines a ward's boundary with particles, and that outline used to disappear after a fixed 10 seconds. Set radius_display.duration_seconds in config.yml to keep it up for anywhere from 1 to 600 seconds; a value outside that range is clamped to it. - No restart needed. The time is read on every click, so /ward reload applies a new value at once. The button's description and the chat message both show the time you set. - Nothing to migrate. A config.yml without the new key keeps the 10-second outline. Wards, members, the database and commands are unchanged. Drop the new jar in and restart. - Boot-verified at both ends of the range: Paper 1.21.8 (the compatibility floor) and Paper 26.2 (Java 25), each a clean enable with zero plugin errors.

- Water and lava flow inside your own ward. Every flow into a warded block used to be cancelled, so a bucket of water poured inside your own ward sat there as one still block. Liquid placed by the owner or a member now spreads normally inside the ward. Flow from outside the ward, or from another owner's ward, still stops at the edge. - Pistons work inside your own ward. A piston standing in a ward pushes and pulls blocks within it, and out of it into unclaimed land, so piston doors and farms work for the people who built them. A piston outside the ward, or in another owner's ward, still cannot move, push into or pull from warded blocks. - Dispensers can't pour in from outside. Now that liquid spreads inside a ward, a dispenser outside a ward can no longer place or scoop water, lava, powder snow or a mob bucket on the ward's side. This sits under the existing protection.fluid_flow switch. - Your wards count as one claim. Two wards with the same owner are treated as one claim for liquids and pistons, so a build that spans both behaves as one. - No config, data or command changes. Your wards, members, database and config carry over. Drop the new jar in and restart. - Boot-verified at both ends of the range: Paper 1.21.8 (the compatibility floor) and Paper 26.2 (Java 25), each a clean enable with zero plugin errors.

- Fixed a ward duplication exploit in the shop. With /ward shop open, clicking a stack of ward items in your own inventory was treated as buying that item, and the shop handed back a copy of the whole stack for one price. Ward items stack, so the stack doubled each time. The shop now only accepts clicks on its own slots, every purchase gives exactly one freshly made ward, and the ward is only handed over once the economy confirms the payment went through. Servers running the shop should update. - Clearer ward block controls. Left-click mines the ward block like any other block (owners can break their own ward in survival), right-click opens the menu, and pickup is sneak+right-click twice. The pickup prompt now says exactly that. - Every menu button explains itself. Each button describes what it does, shows its current state, and says what a click will do. The PVP and Mob Damage flags keep their own icons and glow when on, instead of turning into a barrier. - Reworked ward menu. A header at the top shows the ward's tier, radius, members, location, and ID, and the menu title names the ward. The duplicate Add Member button is gone from the main menu; adding members lives on the Members screen, where the button grays out when the ward is full. - Two-click confirms that work on Bedrock. Remove Member and Clear Logs now take two clicks within the pickup confirm window (pickup.confirm_ms) instead of a shift-click, so Geyser/Bedrock players can use them. - Friendlier chat prompts. Rename, Entry Message, and Add Member accept cancel and expire after 60 seconds. A rejected name keeps the prompt open so you can try again. - Ward name rules. Names are 1–32 characters, no spaces, and unique across the server. Color codes are allowed and kept for display; /ward tp <name> and the other name lookups ignore colors. Re-adding an existing member, or the owner, is refused. - More useful shop. Each ward shows its formatted price, member limit, and feature count, plus a red line when you can't afford it. A bought ward now stacks with a crafted one. - Lighter on the server. History and View Logs close the menu first and read the database off the main thread. - Show Radius is private. The boundary particles are shown only to the player who clicked, and clicking again restarts them. - Tidier Ward Intelligence. The menu is now 36 slots, and Clear Logs sits apart from View Logs so a stray click can't reach it. - No clashes with other plugins. MachinaWards now recognizes its own menus directly instead of by their title, so another plugin's menu with the same title is no longer affected. - Menu sounds. New sounds.menu_click, sounds.menu_success, and sounds.menu_error keys (set to "" to disable). Existing configs need no edits: missing keys fall back to the defaults. - Boot-verified at both ends of the range: Paper 1.21.8 (the compatibility floor) and Paper 26.2 (Java 25), each a clean enable with zero errors. Your wards, members, database, and config carry over — drop the new jar in and restart.

- Confirmed working on Minecraft 26.2. Paper 26.2 ships Adventure 5, which removed a batch of long-deprecated chat API — the change that breaks a lot of older plugins on 26.2. MachinaWards is not one of them: the full Adventure surface it uses was audited against the removal list and needed no changes. - Proven, not assumed. Every Adventure call site — the /ward transfer [ACCEPT]/[DECLINE] buttons, the colored titles and action bars, and the &/&#RRGGBB color parsing — was executed directly against the Adventure 5 libraries Paper 26.2 bundles. Everything linked and rendered correctly, so there are no hidden runtime errors waiting on a command you rarely run. - Boot-verified at both ends of the range: Paper 26.2 (Java 25) and Paper 1.21.8 (the compatibility floor), each a clean enable with zero errors. - No functional changes. Your wards, members, database, and config carry over untouched — drop the new jar in and restart. - Housekeeping: corrected the version metadata on the old v2.0.1 download, which incorrectly listed Minecraft 1.16–1.20 and the Bukkit/Spigot loaders. The v2.x line has always been Paper/Purpur 1.21+; Spigot users still need v1.9.1.

New commands - /ward who — see who owns the ward you're standing in and what you're allowed to do there. - /ward list [page] — paginated ward list (8 per page, oldest first). - /ward admin cleanup <days> — preview, then confirm-delete wards of long-offline owners. The scan runs off the main thread; owners who are online or have no last-seen record are always kept. Transfer confirmation - /ward transfer now sends an offer the recipient must accept via clickable [ACCEPT] / [DECLINE] chat buttons (or /ward accept / /ward decline). - Offers expire after 60 seconds (transfer.request_timeout_seconds), cannot silently replace someone else's pending offer, and the accept button is bound to the specific ward — a stale click can never accept the wrong offer. - The recipient's ward limit is enforced at both offer and accept time. Admin transfers remain instant and still work for offline recipients. Improvements - Admin commands (/ward admin list|delete|cleanup|stats|migrate) now work from console and RCON. - Player-name lookups (addmember, removemember, transfer, GUI Add Member) check the local usercache first and only fall back to a full profile lookup on a cache miss; names that never joined the server are rejected cleanly. One jar for Paper/Purpur 1.21 through 26.2 (api-version: 1.21). Plain Spigot users: stay on v1.9.1.

v2.2.0 — one jar for every Paper/Purpur server from 1.21 to 26.2

- Now compiled against the 1.21 API floor (api-version: 1.21), so a single jar loads everywhere from Minecraft 1.21 through 26.2 — newer servers stay backward compatible. - Verified by booting on Paper 1.21.1, Purpur 1.21.11, Paper 26.1.2, Purpur 26.1.2, and Paper 26.2. - Hardened sound resolution for early-1.21 servers (registry lookup falls back safely where Registry.SOUNDS is unavailable). - Includes the v2.1.1 fix: colored titles & action bars build proper Adventure components (& and &#RRGGBB hex). - Requires Paper or Purpur (uses the server-bundled Adventure API). Plain Spigot users: use v1.9.1. - Java requirement follows vanilla: Java 21+ on 1.21.x servers, Java 25+ on 26.1+ servers.

v2.1.1

- Minecraft 26.1 support — compiled against the 26.1.2 API (api-version: 26.1); verified end-to-end on Paper 26.1.2 and Purpur 26.1.2 (Java 25 servers). - Fixed colored titles & action bars — entry alerts and placement titles now build proper Adventure components: legacy & codes and &#RRGGBB hex colors are parsed into real styles instead of raw formatting codes. - Internal cleanup: explosion protection uses the standard Bukkit events on all platforms. - Note for 1.21.x servers: stay on v1.9.1 — the v2.x line targets Minecraft 26.1+.

MachinaWards Changelog v2.1.0 - Minecraft 26.1 compatibility (Spigot, Paper, Purpur 26.1+) - api-version updated to 26.1 - Sound resolution migrated to Registry.SOUNDS — existing config values unchanged - getOfflinePlayer(String) deprecation resolved v2.0.1 - Critical: Entry messages were never saved or loaded from the database - High: Ward members could perform owner-only GUI actions (rename, flags, add/remove members, trust changes) - Medium: Shop purchase silently consumed money if inventory was full — overflow now drops at player's feet - Low: Pending rename/add-member chat state leaked on player disconnect - Low: Breaking a ward block returned the raw material instead of the ward item - Low: Remove notification used wrong config key (notify_on_add → notify_on_remove) v2.0 - Trust level system (VISITOR / MEMBER) with per-member GUI management - Ward Intelligence for Super Wards (creeper alert, mob kills, player death, explosion log) - Full Adventure API integration (titles, action bars, hex color support) - Ward flags: Allow PVP, Allow Mob Damage - Extended protection: bucket pour, entity placement, vehicle destroy, block spread, spawner eggs (Purpur) - Ward pickup via sneak+right-click with confirmation window - Entry message per ward with color codes and placeholders - Compass navigation, nearby ward listing, ownership transfer - MySQL backend with SQLite→MySQL migration command - Chunk-indexed spatial lookup, owner index, short ID index - Particle task, configurable sounds, world/height restrictions

v1.9.1 - /ward list now shows a header with your ward count and limit (e.g. Your Wards (2/3)) so you always know how many more wards you can claim

v1.5.0 — QoL & Polish - Hex color support in ward names and entry messages (&#FF5500 syntax) - Custom entry messages per ward — visitors see a configurable message when entering; placeholders: %ward% %owner% %tier% %radius% - Ward compass — /ward compass [id|name] points your compass at a ward (nearest owned by default) - Ownership transfer — /ward transfer [id] <player>, notifies the new owner - Ward pickup — Sneak+right-click the ward block to pick it up (with a configurable confirmation window, default 5s) - Config hot-reload — /ward reload reloads config.yml and re-registers crafting recipes - Tab completion for all commands --- v1.5.1 — Performance - Shape cache avoids reading config on every block/move event - Persistent SQLite connection + WAL journal mode + async writes - Spatial chunk index — containment checks are now O(1) instead of O(N) --- v1.5.2 — Scale (10k+ wards) - Batch DB loading — startup uses 4 queries total regardless of ward count (was 2N+1) - Owner index — /ward list, ward limits, and member counts are O(1) - Name/short-ID indexes — /ward tp, /ward info, and similar lookups are O(1) - Particle task rewritten to iterate loaded chunks instead of all wards --- v1.6.0 — MySQL Support - Optional MySQL/MariaDB backend — set database.type: mysql in config.yml and fill in credentials; SQLite remains the default - MySQL driver auto-downloaded via Paper's library system (no manual install) - /ward admin migrate mysql — copies all ward data from SQLite to MySQL in the background --- v1.7.0 — Protection Gaps + Admin Tools - Piston protection — pistons can't push/pull blocks across ward boundaries - Entity grief protection — blocks Endermen, silverfish, Wither, Ravagers, etc. from changing blocks inside wards - Fluid flow protection — lava and water can't flow into a ward - Hanging entity protection — non-members can't break item frames or paintings inside wards - /ward info [id|name] — shows tier, radius, owner, member count, and your role - EntryListener rewritten to use chunk index (O(1) per player move tick) - All new protections are toggleable in config.yml --- v1.8.0 — PVP & Mob Protection + Per-Ward Flags - PVP protection — outsiders can't attack players inside wards - Entity damage protection — outsiders can't damage animals/mobs inside wards - Crop trample protection — non-members can't trample farmland inside wards - Per-ward flags (toggled in the ward GUI): - Allow PVP — enable PVP inside a specific ward - Allow Mob Damage — enable mob damage inside a specific ward - /ward admin stats — shows total wards, per-world breakdown, total members, and owner count --- v1.9.0 — Nearby Search + Sounds + Block Index - /ward nearby [radius] — lists wards within radius blocks (default 100, max 500), sorted by distance with owner and tier info - /ward admin tp <id|name> — teleport to any ward (admin only), with tab completion - Sound effects — configurable sounds on ward place, break, pickup, and when a visitor enters (config.yml → sounds:) - Ward block break/interact now uses an O(1) block position index instead of scanning all wards in the world

MachinaWards v1.4.0 — Update Brief For admins: - New wards.place permission gates who can place wards at all (default: true — all players can place by default, revoke to restrict) - Fixed: players with no wards.player.* permission could previously place unlimited wards — now properly blocked unless wards.place is granted - New max_members config key per tier — Basic: 5, Advanced: 10, Super: unlimited. Set to -1 for no limit - Overlap prevention — ward placement is now blocked if the new ward's radius intersects any existing ward, eliminating ambiguous double-protection zones For players: - Ward naming — click the Name Tag in the ward menu to give your ward a custom name. Shows in the menu button, /ward list, and teleport messages - /ward tp <id> — teleport to any of your wards by short ID (tab-completes your own ward IDs) - /ward list now shows the ward's custom name alongside tier, world, and coords - Member limit is now enforced — you'll get a clear message if a ward's member cap is reached

Update Brief — v1.3.0 For admins: - New /ward admin list — see every ward on the server with owner, tier, world, and coordinates - New /ward admin list <player> — filter wards by a specific player - New /ward admin delete <id> — remotely delete any ward by its short ID (tab-completes) - Admin help is now hidden from regular players - Fixed: admins were incorrectly blocked from building inside other players' wards - Fixed: explosions (creeper, TNT) and fire spread now properly respect ward boundaries — previously the config flags had no effect For players: - /ward list now shows the world name and short ward ID alongside coords — useful on multi-world servers - No other changes to normal gameplay