NewClaims

## Features ### Claim System - Protect the current chunk with `/claim` - Per-player claim limit configurable via `config.yml` or permission (`newclaims.claims.<n>`) - Claim cost integrated with **Vault** (optional, auto-detected) - Multi-world support with a whitelist in `config.yml` - Visualize chunk borders with particles using `/claim visualize` ### Protections - Breaking and placing blocks - Interacting with chests, doors, levers, furnaces, etc. - PvP between players (configurable) - TNT and Creeper explosions - Fire spreading - Mob griefing (Endermen, Ghasts, etc.) - Crop trampling - Pistons pushing blocks into/out of claims - Liquid flow (optional) ### Trust System Grant granular permissions inside your claim: - **Full** — build, break, and interact - **Build** — break and place blocks only - **Interact** — interact only (chests, doors, levers) ### Ban System Ban specific players from your claim. Banned players are teleported out immediately upon being banned. ### Developer API Custom events for integration with other plugins: - `ClaimCreateEvent` (cancellable) - `ClaimDeleteEvent` - `ClaimEnterEvent` (cancellable) Programmatic access via `ClaimAPI` exposed by the plugin instance. --- ## Commands | Command | Description | |---|---| | `/claim` | Protect the current chunk | | `/claim list` | List your claims | | `/claim info` | Information about the current chunk's claim | | `/claim visualize` | Show claim borders with particles | | `/claim trust <player> ` | Add trust to a player | | `/claim untrust <player>` | Remove trust | | `/claim trustedlist` | List players with access | | `/claim ban <player>` | Ban a player from the claim | | `/claim unban <player>` | Unban a player | | `/claim setname <name>` | Set a custom name for the claim | | `/unclaim` | Remove the claim from the current chunk | | `/unclaim all` | Remove all your claims | | `/claimadmin list <player>` | List a player's claims | | `/claimadmin delete <player> ` | Delete a player's claim(s) | | `/claimadmin bypass` | Toggle bypass mode | | `/claimadmin info` | Info about the current chunk's claim | | `/claimadmin reload` | Reload configurations | | `/claimadmin stats` | Server-wide statistics | --- ## Permissions | Permission | Description | Default | |---|---|---| | `newclaims.use` | Access to basic commands | everyone | | `newclaims.claim` | Create claims | everyone | | `newclaims.unclaim` | Remove claims | everyone | | `newclaims.trust` | Manage trust | everyone | | `newclaims.visualize` | Visualize borders | everyone | | `newclaims.claims.<n>` | Limit of N claims | — | | `newclaims.claims.unlimited` | Unlimited claims | op | | `newclaims.admin` | Admin commands | op | | `newclaims.bypass` | Bypass protections | op | | `newclaims.*` | Full access | op | --- ## Configuration All options are in `config.yml`. No restart required — use `/claimadmin reload`. ```yaml general: max-claims-default: 5 enabled-worlds: particle-visualize-duration: 10 auto-save-interval: 300 economy: claim-cost-enabled: true claim-cost: 100.0 protection: protect-explosions: true protect-fire: true protect-mob-griefing: true pvp-in-claims: false protect-crop-trampling: true ``` All messages are editable in `messages.yml` with support for color codes (`&a`, `&c`, etc.) and dynamic placeholders. --- ## Storage Data is saved to `plugins/NewClaims/claims.json` **asynchronously** with atomic writes (no risk of corruption on crashes). No external database required. --- ## Dependencies | Dependency | Type | |---|---| | (https://papermc.io) | Required | | (https://www.spigotmc.org/resources/vault.34315/) | Optional (economy) | --- ## License MIT License — free to use, modify, and distribute.