MinestomPvP is an extension for Minestom. It tries to mimic vanilla (and pre-1.9) PvP as good as possible, while also focusing on customizability and usability.
But, MinestomPvP does not only provide PvP, it also provides everything around it (e.g., status effects and food). You can easily choose which features you want to use.
The maven repository is available on jitpack.
Currently, most vanilla PvP features are supported.
- Attack cooldown
- Damage invulnerability
- Weapons
- Armor
- Shields (or sword blocking)
- Food
- Totems
- Bows and crossbows
- Fishing rods (only hooking entities or legacy knockback, not fishing)
- Other projectiles (potions, snowballs, eggs, ender pearls)
- All enchantments possible with the above features (this includes protection, sharpness, knockback, ...)
- Lingering potions
- Fall damage
- Fireworks (for crossbows)
- Projectile collision might need some improvements (which is a Minestom issue too)
One way to use this extension is by simply putting the jar inside your servers extensions folder. This will apply PvP mechanics to your whole server.
But you can also choose to (and this is the preferred option for most servers) use the jar file as a library.
In this case, you can choose where to apply the PvP mechanics and customize them.
You can get an EventNode with all PvP related events listening using PvpExtension.events().
By adding this node as a child to any other node, you enable pvp in that scope.
Separated features of this extension are also available as static methods in PvpExtension.
You also have to call PvpExtension.init() before doing anything else.
Example (adds PvP to the global event handler, so everywhere):
PvpExtension.init();
MinecraftServer.getGlobalEventHandler().addChild(PvpExtension.events());The rest of this readme assumes you are using the extension as a library.
You can get the EventNode for legacy PvP using PvpExtension.legacyEvents().
Do not combine it with any non-legacy node, as this will cause issues.
To disable attack cooldown for a player and set their attack damage to the legacy value, use PvpExtension.setLegacyAttack(player, true).
To enable the cooldown again and set the attack damage to the new value, use false instead of true.
A lot of servers like to customize their 1.8 knockback. It is also possible to do so with this extension. In EntityKnockbackEvent, you can set a LegacyKnockbackSettings object. It contains information about how the knockback is calculated. A builder is obtainable by using LegacyKnockbackSettings.builder(). For more information, check the config of BukkitOldCombatMechanics.
To integrate this extension into your minestom server, you may have to tweak a little bit to make sure everything works correctly.
When applying damage to an entity, use CustomDamageType instead of DamageType (except if you use the default ones: GRAVITY, ON_FIRE and VOID).
If you have your own damage type, also extend CustomDamageType instead of DamageType.
Potions and milk buckets are considered food: the Minestom food events are also called for drinkable items.
This extension provides several events:
DamageBlockEvent: cancellable, called when an entity blocks damage using a shield. This event can be used to set the remaining damage.EntityKnockbackEvent: cancellable, called when an entity gets knocked back by another entity. Gets called twice for weapons with the knockback enchantment (once for default damage knockback, once for the extra knockback). This event can be used to set the knockback strength.EntityPreDeathEvent: cancellable, a form ofEntityDeathEventbut cancellable and with a damage type.EquipmentDamageEvent: cancellable, called when an item in an equipment slot gets damaged.FinalAttackEvent: cancellable, called when a player attacks an entity. This event can be used to set a few variables like sprint, critical, sweeping, etc.FinalDamageEvent: cancellable, called when the final damage calculation (including armor and effects) is completed. This event should be used instead ofEntityDamageEvent, unless you want to detect how much damage was originally dealt.LegacyKnockbackEvent: cancellable, called when an entity gets knocked back by another entity using legacy pvp. Same applies as forEntityKnockbackEvent. This event can be used to change the knockback settings.PickupArrowEvent: cancellable, called when a player picks up an arrow.PlayerExhaustEvent: cancellable, called when a players exhaustion level changes.PlayerSpectateEvent: cancellable, called when a spectator tries to spectate an entity by attacking it.PotionVisibilityEvent: cancellable, called when an entities potion state (ambient, particle color and invisibility) is updated.ProjectileBlockHitEvent: called when a projectile hits a block.ProjectileEntityHitEvent: cancellable, called when a projectile hits an entity.TotemUseEvent: cancellable, called when a totem prevents an entity from dying.
It is possible to add your own features to this extension. For example, you can extend the current enchantment behavior by registering an enchantment using CustomEnchantments. This will provide you with a few methods for when the enchantment is used. It is also possible to do the same for potion effects using CustomPotionEffects, which will provide you with a few methods for when the effect is applied and removed.
You can use the class Tool, which contains all tools and their properties (not all properties are currently included, will change soon).
The same applies for ToolMaterial (wood, stone, ...) and ArmorMaterial.
You can contribute in multiple ways. If you have an issue or a great idea, you can open an issue. You may also open a new pull request if you have made something for this project and you think it will fit in well.
If anything does not integrate with your project, you can also open an issue (or submit a pull request). I aim towards making this extension as usable as possible!
Thanks to kiipy for testing and finding bugs.
I used BukkitOldCombatMechanics as a resource for recreating legacy pvp.