# PVP Toggle Changelog ## v1.1.0-Release ### Features - Modrinth update checker: checks for new releases on startup and notifies the console and online OPs; toggle via `update-check.enabled`. - Messages moved to `lang/zh.yml` and `lang/en.yml`; switch locale with `language`. Config holds settings only. - Missing config / lang keys are merged automatically on startup and `/pvp reload` after plugin updates. - PlaceholderAPI: `%pvptoggle_status%`, `%pvptoggle_status_<player>%`. - Supports **Spigot / Paper 1.20.1 – 26.1+** and Folia

# PVP Toggle Changelog ## v1.0.1-Release **Features** - Players can use `/pvp`, `/pvp on` / `off` / `toggle` to change their own PVP; admins can use `/pvp on|off|toggle <player>` to manage others. - `/pvp status` to see your status, `/pvp status <player>` to see another player’s (with permission); `/pvp reload` to reload config. - Config options: default PVP state, remember choice on rejoin, per-world state, save debounce, command cooldown, sound/ActionBar/title on toggle; all messages can be edited in config. - Supports Folia, LuckPerms (soft depend), and PlaceholderAPI (`%pvptoggle_status%`, `%pvptoggle_status_<player>%`). - Projectile damage (e.g. arrows) is checked against the shooter’s PVP state; repeating `/pvp on` or `/pvp off` shows an “already on/off” message. **Fixes & improvements** - Fixed the issue where PVP appeared enabled but damage did not apply; enabled state now applies correctly. - Permissions: `pvptoggle.use`, `pvptoggle.admin`, `pvptoggle.reload`, `pvptoggle.status.other`.

# PVPToggle A Paper 1.21 PVP toggle plugin: players choose whether to participate in PVP; admins can manage others’ state. Supports Folia, LuckPerms, PlaceholderAPI, and per-world PVP state. --- ## Features - **Players**: `/pvp` or `/pvp on` / `off` / `toggle` to change your own PVP - **Admins**: `/pvp on|off|toggle <player>` to manage someone else’s PVP - **Status**: `/pvp status` for yourself, `/pvp status <player>` for others (with permission) - **Reload**: `/pvp reload` to reload config (with permission) - **Per-world**: Optional separate PVP state per world - **Debounced save**: Fewer disk writes - **Cooldown**: Configurable cooldown after toggling your own PVP - **Feedback**: Configurable sound, ActionBar, and Title on toggle - **PlaceholderAPI**: Placeholders like `%pvptoggle_status%` - **Folia**: Region-aware scheduling; async save so it doesn’t block - **LuckPerms**: Permissions handled by LuckPerms when installed --- ## Commands | Command | Description | Permission | |---------|--------------|------------| | `/pvp` | Same as `/pvp toggle`; toggles your PVP | pvptoggle.use | | `/pvp on` | Enable PVP for yourself | pvptoggle.use | | `/pvp off` | Disable PVP for yourself | pvptoggle.use | | `/pvp toggle` | Toggle your PVP | pvptoggle.use | | `/pvp status` | View your own PVP status | pvptoggle.use | | `/pvp status <player>` | View another player’s PVP status | pvptoggle.status.other | | `/pvp on\|off\|toggle <player>` | Set PVP for another player | pvptoggle.admin | | `/pvp reload` | Reload config.yml | pvptoggle.reload | --- ## Permissions | Permission | Description | Default | |------------|--------------|---------| | `pvptoggle.use` | Use /pvp, on/off/toggle, and /pvp status (self) | true | | `pvptoggle.admin` | Use /pvp on\|off\|toggle <player> | op | | `pvptoggle.reload` | Use /pvp reload | op | | `pvptoggle.status.other` | Use /pvp status <player> | op | --- ## Configuration (config.yml) - **default-pvp**: Default PVP state for new or unknown players (true/false) - **persist-on-rejoin**: Whether to keep each player’s choice when they rejoin - **per-world**: Whether to store PVP state per world (separate per world) - **save-debounce-seconds**: Debounce time in seconds before writing to disk; 0 = save every time - **command-cooldown-seconds**: Cooldown in seconds after toggling your own PVP; 0 = no cooldown - **toggle-feedback**: Feedback when toggling - **play-sound**: Play a sound - **sound**: Sound name (e.g. ENTITY_EXPERIENCE_ORB_PICKUP) - **sound-volume** / **sound-pitch**: Volume and pitch - **use-actionbar**: Show message in ActionBar - **actionbar-message**: ActionBar text; `%status%` = on/off - **use-title**: Show title - **title** / **subtitle**: Title and subtitle; `%status%` = on/off - **placeholder-on** / **placeholder-off**: Values returned by PlaceholderAPI placeholders - **messages.***: All messages; supports `&` color codes and `%player%`, `%seconds%`, `%status%` --- ## PlaceholderAPI With PlaceholderAPI installed, these placeholders are registered (return values are configurable): | Placeholder | Description | |-------------|-------------| | `%pvptoggle_status%` | Current player’s PVP status (in that player’s context) | | `%pvptoggle_status_<player>%` | A specific player’s PVP status (e.g. `%pvptoggle_status_Steve%`) | Default return values are `on` / `off`; change them with **placeholder-on** and **placeholder-off** in config. --- ## Compatibility - **Server**: Paper 1.21+ (or compatible forks) - **Folia**: Supported (`folia-supported: true`); uses AsyncScheduler for saves - **LuckPerms**: Soft dependency; permissions are managed by LuckPerms when present - **PlaceholderAPI**: Soft dependency; placeholders are registered when present ---