aicheye's Combat Tagging

A lightweight fabric server mod to make PvP fairer and prevent combat-logging.

Ethically sourced and GMO-free! Consider downloading on Modrinth to support this project.

Features:

• Compatible with PvP and PvE
• Combat disconnect punishing
  • Reduced health to half a heart (can be configured to instantly kill)
  • Reduced absorption
  • Poison
• While combat tagged
  • TP cooldown (ender pearls and chorus fruit)
    • By default, the cooldown starts as soon as the player enters combat
  • Enchanted golden apple cooldown
    • By default, the cooldown only starts after eating the first enchanted golden apple
  • Elytras disabled while combat tagged
  • Command blacklist (e.g., /home, /spawn, /tpa)
  • Red username
  • Bar to indicate how long until the player's combat tag expires
• Fully configurable

Note:

An unexpected server shutdown will count as a disconnect (stopping the server gracefully will not).

By default, /teammsg and /team are disabled

• All players in combat are put on a "combat" team for the sake of username colouring
• Disabling username colouring also re-enables these commands

Configuration Options

Found in ./config/CombatTag.json

Key	Type	Default	Description
CombatDurationSec	Float	20.0	How long the combat tag should last for
CombatTpCooldownSec	Float	10.0	How long the cooldown for enderpearls and chorus fruits should be during combat
CombatNotchAppleCooldownSec	Float	10.0	How long the cooldown for enchanted golden apples should be during combat
HealthRemainingPunish	Float	1.0	How much health the player should have upon reconneccting while combat tagged
AbsorptionRemainingPunish	Float	0.0	How much absorption the player should have upon reconnecting while combat tagged
PoisonDurationSec	Float	20.0	How long the player should be poisoned for upon reconnecting while combat tagged
PoisonLevel	Integer	5	The amplification level of the poison effect upon reconnecting while combat tagged
OnlyTagWeapons	Boolean	false	Whether combat tags should only apply when taking weapon/TNT/crystal damage (full list of weapons here)
EnableTagOnAttack	Boolean	true	Whether the attacker should be tagged in PvP
EnablePveTagOnDamage	Boolean	false	Whether the damaged player should be tagged in PvE
EnablePveTagOnAttack	Boolean	false	Whether the attacking player should be tagged in PvE
EnableHealthPunish	Boolean	true	Whether the player should lose health upon reconnecting while combat tagged
EnableAbsorptionPunish	Boolean	true	Whether the player should lose absorption upon reconnecting while combat tagged
EnablePoisonPunish	Boolean	true	Whether the player should be poisoned upon reconnecting while combat tagged
EnableTpPunish	Boolean	true	Whether the teleport cooldown should be active during combat
EnableInstantTpPunish	Boolean	true	Whether the teleport cooldown should be activated immediately upon entering combat
EnableNotchApplePunish	Boolean	true	Whether the enchanted golden apple cooldown should be active during combat
EnableInstantNotchApplePunish	Boolean	false	Whether the enchanted golden apple cooldown should be activated immediately upon entering combat
EnableElytraPunish	Boolean	true	Whether elytra should be disabled during combat
EnableCombatColour	Boolean	true	Whether players in combat should appear red (spectral arrows, scoreboard, username in chat, etc.)
DisableTeamMsgCommand*	Boolean	true	Whether players should be allowed to use /teammsg
DisableTeamCommand*	Boolean	true	Whether players should be allowed to use /team
CommandBlacklist	String[]	["tpa", "tpaccept", "home", "spawn", "back", "warp"]	Commands that are blocked while in combat
CommandBlacklistMessage	String	"You cannot use this command while in combat!"	Message shown when a blacklisted command is blocked

*Warning: disabling these options may allow players in combat to message each other or leave the combat team and lose their colour

Requirements

• Fabric loader 16.10 or later (1.21.4/5)
• Fabric loader 16.14 or later (1.21.6/7)
• Minecraft 1.21.4 or later
  • May work with older versions (build yourself to test: see here for more)
• Java 21 or later