DontKillFriends

Protect your tamed animals from damage, even when you're offline!

DontKillFriends is a lightweight Minecraft plugin that prevents other players from harming your beloved pets. Whether you're online or offline, your tamed animals stay safe from both player attacks and environmental damage.

Features

• Complete Pet Protection - Shields tamed animals from all types of damage
• Offline Protection - Your pets remain safe even when you're not online
• HEX Color Support - Beautiful messages with custom colors (&#RRGGBB)
• Highly Configurable - Customize every aspect of protection
• Debug Mode - Optional detailed logging for troubleshooting
• Lightweight - Minimal performance impact
• Multi-Version Support - Compatible with Minecraft 1.16.5 - 1.21.8

Supported Damage Types

• Player attacks
• Explosions (TNT, Creepers, etc.)
• Drowning
• Fire and Lava damage
• Lightning strikes
• Fall damage
• Dragon breath
• Projectiles (arrows, etc.)
• Magic and potion effects
• Poison and Wither effects

Commands

Command	Description	Permission
/dkf version	Show plugin version	dontkillfriends.version
/dkf reload	Reload plugin configuration	dontkillfriends.reload

Aliases: /dontkillfriends = /dkf

Permissions

Permission	Description	Default
dontkillfriends.version	View plugin version	op
dontkillfriends.reload	Reload plugin config	op
dontkillfriends.bypass	Bypass pet protection (can damage any tamed animal)	op

Configuration

# Main protection settings
protect-offline-pets: true # Protect pets of offline players
debug-logs: false # Show debug messages in console

# Damage types to protect from
immortal-from-explosion: true # Explosions
immortal-from-drowning: true # Drowning
immortal-from-suffocation: true # Suffocation
immortal-from-fire: true # Fire and lava
immortal-from-lightning: true # Lightning
immortal-from-fall: true # Fall damage
immortal-from-dragon: true # Dragon breath
immortal-from-host: true # Owner damage
immortal-from-projectile: true # Arrows and projectiles
immortal-from-magic: true # Potions and magic

# Messages (support HEX colors via &#RRGGBB)
hit-message: "&#FF6B6B&lYou hit a tamed animal!" # Impact Message
offline-owner-suffix: " &#FFD93D(Owner offline)" # Suffix when owner is offline | Disable - ""
reload-message: "&#4ECDC4Successfully reloaded plugin." # A message about the plugin reload

commandTabComplete: true # TAB completion for commands

HEX Color Examples

You can use HEX colors in messages:

• &#FF6B6B - Red
• &#4ECDC4 - Teal
• &#FFD93D - Yellow
• &#98FB98 - Light Green
• &#FF69B4 - Hot Pink

Example: "&#FF6B6B&lDanger! &#FFD93DYou cannot hurt this pet!"

Installation

1. Download the latest version from Modrinth
2. Place DontKillFriends-x.x.x.jar in your server's plugins folder
3. Restart your server
4. Configure the plugin in plugins/DontKillFriends/config.yml
5. Use /dkf reload to apply changes

Troubleshooting

If you encounter issues:

1. Enable debug logging: Set debug-logs: true in config.yml
2. Use /dkf reload to apply changes
3. Check console for detailed information
4. Report issues on Discord (@gu.b) with debug logs

Compatibility

• Minecraft Versions: 1.16.5 - 1.21.8
• Server Software: Bukkit, Spigot, Paper, Purpur
• Java: 8+