# About Omi's PVP is an all-in-one PVP plugin that adds more than just simple `/pvp` or admin commands. It's great for both small and big communities - especially the ones where you can't seem to figure out what parts of PVP should be illegal and what parts shouldn't! It adds things I thought were missing from most PVP plugins. **Server software:** Paper and compatible Bukkit/Spigot forks, including Purpur and Pufferfish. > There are 2 versions of the plugin - **Modern** and **Old**. Modern works from **1.21.9 to the latest version**, while Old works from **1.12.2 to 1.21.8**. Updating from Old to Modern should be seamless. > > Both versions contain essentially the same gameplay features. Modern additionally has some features that rely on newer Minecraft/Paper functionality, such as the configurable Combat Mode Bossbar/Action Bar indicator. ## [Full Plugin Guide](https://docs.google.com/document/d/1APkusVIYy1V0NCu2peVaatqrWA5PLxWCUMr9xNiNEQ4/edit?usp=sharing) | [Issue & Suggestion Reporting](https://tally.so/r/jargz4) # Features * Anti-Spawn Killing * Kill Streaks * Detailed PVP Stats, including assists and stat leaderboards * Player Bounties (set by players) and a Bounty Leaderboard * PVP Clans (pretty unique feature, read more about it below) * **Clan Battles** - challenge other clans with goals, combined clan progress and optional item rewards * Heirs (people can't pick up your items upon a **natural** death, **unless** you add them as an heir) * Safe Backups * Enable/Disable PVP * Enable/Disable dropping items in PVP (on the go!) * Rivals (add someone as a rival and configure your rivalry, it's unique too, read about it below) * Rival & Clan Battle Goal Rewards * Command-Block during PVP (of course configurable) * Health Indicator * Combat Mode Indicator (Modern) * Public API for other plugins * Update Checker * A couple more cool features hidden inside the things listed above * High Customizability # Commands, Features - Explained ## Easy Commands * `/pvp ` - enables or disables PVP * `/pvpdrops ` - enables or disables dropping items after dying in PVP (doesn't affect natural deaths) * `/pvpstats [player name, or null]` - allows you to view certain stats about yourself and other people ### Assists Assists aren't given to just anyone who hit the killed player. OPVP keeps track of damage dealt during the fight. If another player dealt the **most damage** to the victim but didn't get the final kill, they receive the assist. For example, if Player A deals 14 damage, Player B deals 5 damage and Player B gets the final hit, Player A gets the assist. ## Admin Commands > I think most of these are pretty self-explanatory. Admin functionality is now under `/opvp` instead of the old `/opvpadmin` command. * `/opvp ` * `/opvp cooldown [player] [seconds]` - allows admins to manage OPVP cooldowns * `/changepvp [player name] ` * `/changepvpdrops [player name] ` `/opvp info` also shows useful information about OPVP and helps you check whether a newer version of the plugin is available. # Unique and Complex Commands ## Bounty * `/bounty list` - lists active bounties set on players * `/bounty leaderboard` - shows the players with the highest active bounties * `/bounty set [player name]` - shows you instructions and helps you set a bounty on a player > If you set a bounty on a person, when that person is killed the killer will receive the bounty immediately. Bounties use actual Minecraft items rather than a forced economy dependency, so OPVP doesn't require Vault or an economy plugin. ## Heirs * `/heirs [player name]` - removes or adds a player to your heir list * `/heirs list` - lists all your heirs > Heirs are people who are permitted to pick up your items after you die naturally (like from fall damage). ## Rivals > This is probably my favorite feature. Both `/rivals` and `/rival` work the same way. * `/rivals challenge [player name]` - challenges a player to a rivalry * `/rivals ` - accepts or denies a rivalry request * `/rivals help` - gives you help * `/rivals list` - lists all your rivals * `/rivals end ` - you can end a rivalry with one command if you don't have any goals set. If you do, certain conditions have to be met before it can be force-ended, or you can end it with permission from your rival * `/rivals set_rules [rival name] ...` - allows you to configure the rules of your rivalry * `/rivals set_rules [rival name] forcepvp ` - allows you to force PVP with a rival if they accept. That means that even if normal PVP is off, the rivalry can still allow you to fight * `/rivals set_rules [rival name] forcepvpdrops ` - does the same for PVP drops * `/rivals set_rules [rival name] goals [value]` - allows you to set a PVP goal. You can make the goal either a set milestone or a timed competition where the winner is determined by the best positive difference during the set time * `/rivals set_rules [rival name] goals [value]` - does the same thing, except with many Minecraft statistics. For this command to work, Vanilla Tweaks' Track Statistics & Track Raw Statistics datapacks need to be installed on the server. If they aren't present, this exact feature cleanly disappears * `/rivals get_goals [rival name]` - shows you all the goals you have set with the chosen rival > After winning a goal against a rival, both rivals receive a message about it. If one of them is offline, they'll get it as soon as they log back on. The same applies to things like rivalry requests. ### Rival Goal Rewards Goals can also have **item rewards** attached to them. OPVP uses a deposit/escrow system so the rewards actually come from the players rather than being generated out of nowhere. Both sides can accept or decline the proposed reward. Deposited items are protected while the goal is active and OPVP safely handles returning or dropping them where necessary. ## PVP Clans > PVP Clans are clans that allow smaller communities to operate under their own PVP laws, create alliances, fight other clans or just unite in some way. Both: `/pvpclan` and: `/clan` can be used. > OPVP checks for `/clan` conflicts when the server starts. If another plugin already uses `/clan`, OPVP won't take over that command and `/pvpclan` will continue working normally. * `/pvpclan create [your clan name]` - creates a PVP clan * `/pvpclan help` - shows help * `/pvpclan info [clan name]` - shows all you need to know about a clan * `/pvpclan join [clan name]` - sends a request to join a certain clan, unless that clan has open entries, in which case you'll join immediately * `/pvpclan leave` - leaves your current clan * `/pvpclan list` - lists all clans on the server ### Clan Management > Now the more advanced commands. * `/pvpclan manage applications ` - allows you to view everyone who sent a request to join your clan, or accept/deny them. `view` can be run by every clan member, while `accept` and `deny` are limited to the owner and approved members * `/pvpclan manage disband` - after typing the command twice your clan gets disbanded (only the owner can run this command) * `/pvpclan manage kick [player's name]` - kicks a player from a clan (can only be run by the owner) * `/pvpclan manage modify [value]` - changes one of the clan's settings The modifiers are: 1. `admins ` - lists, adds or removes clan admins. Admins have the ability to change clan settings other than the admin list itself 2. `application_approvers ` - manages people who have permission to approve join applications 3. `autonomy ` - controls whether people inside the clan can individually control if they have PVP and PVP drops enabled or disabled 4. `clan_tag ` - views or changes the clan tag. Once configured, it will be shown in chat 5. `friendly_fire ` - decides if clan members can fight each other; by default it's set to true 6. `open_entry ` - when true, anyone who tries to join your clan joins without needing their application approved 7. `pvp ` - enables or disables forced PVP for clan members (autonomy has to be false) 8. `pvpdrops ` - enables or disables forced PVP drops for clan members (autonomy has to be false) 9. `pvp_cooldown [duration]` - gives clan members a higher or lower PVP cooldown (autonomy has to be true) 10. `pvpdrops_cooldown [duration]` - gives clan members a higher or lower PVP drops cooldown (autonomy has to be true) 11. `restricted_goal_reward_perms ` - controls whether Clan Battle goal-reward management is restricted to authorized clan members. It's false by default ## Clan Battles Clan Battles expand the Rival system to **entire clans**. Instead of only tracking one player's progress, Clan Battle goals combine the progress of the participating clan members. * `/pvpclan manage battle challenge [clan]` - challenges another clan * `/pvpclan manage battle ` - accepts or declines a Clan Battle request * `/pvpclan manage battle end ...` - ends an active Clan Battle, following similar goal/end rules to Rivalries * `/pvpclan manage battle get_goals ...` - views the battle's goals * `/pvpclan manage battle set_goals ...` - configures goals for the battle * `/pvpclan get_goals` - provides an easier way to view Clan Battle goals Clan Battles support the same general types of goals as Rivalries, including Vanilla Tweaks statistics when the required datapacks are installed. They also add clan-specific objectives such as: `pvp_milestone clan_kills` which uses the clan members' combined kills. ### Clan Battle Goal Rewards Clan Battles can have item rewards too: * `/pvpclan manage battle goal_reward ` * `/pvpclan goal_reward` Rewards use OPVP's deposit/escrow system rather than generating free items. The system is designed to safely return or drop deposited items when needed. # Health Indicator OPVP can display a player's health underneath their name. It can be configured to display either normal HP or hearts, depending on what fits your server better. # Combat Mode Indicator **Modern OPVP** can visually show the remaining Combat Mode time using: * Bossbar * Action Bar * Both Bossbar is the default, and the feature can be configured. This is one of the features that isn't included in OPVP Old because it uses the modern implementation. # Public API OPVP V1.1 introduces a **Public API** for developers who want their plugins to interact with OPVP directly. The API can be used to work with things such as: * PVP and PVP Drops state * Combat Mode * Cooldowns * Kills, deaths, assists and kill streaks * Player statistics * Clans * Rivals * Bounties and bounty leaderboard data There are also explicitly marked direct state-changing methods for integrations that intentionally need to bypass normal player command restrictions. A separate lightweight `OPVP-API-1.0.jar` is available for developers to use as a compile-only dependency. **It is not supposed to be installed in your server's plugins folder** - the normal OPVP plugin already contains everything required at runtime. # Languages Currently the plugin supports three languages: * English (`en`, default) * Polish (`pl`) * German (`de`) Language can be changed in the config. # Config Many features can be disabled or configured, so don't worry if a single feature doesn't fit your server. Existing configurations are automatically migrated when updating. New settings are added without intentionally resetting your existing configuration. # Dependencies and Integrations The plugin has **no required dependencies** and there are no plans to change that. As mentioned above, there is an optional Vanilla Tweaks **Track Raw Statistics** and **Track Statistics** datapack integration. You can download them [here](https://vanillatweaks.net/picker/datapacks/). If the required datapacks aren't installed, the features that specifically depend on them disappear without preventing the rest of OPVP from working. # Modern vs Old **OPVP Modern** * Minecraft 1.21.9+ * Intended for current Paper and compatible server software * Includes the modern Combat Mode Bossbar/Action Bar indicator and its additional configuration **OPVP Old** * Minecraft 1.12.2 - 1.21.8 * Maintains compatibility with older Minecraft/server versions * Contains essentially the same core gameplay systems, including Clans, Clan Battles, Rivals, Bounties, Assists and the Public API * Doesn't include functionality that specifically depends on the modern implementation, such as the modern Combat Mode indicator Moving from Old to Modern when updating your Minecraft server should be seamless. # Licensing Of course everyone can use my plugin on their servers, no matter if the server has actual revenue or not and edit it for personal/server-only matters

omichall