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
• Attack Notifications - Receive notifications when someone attempts to attack your pets
• HEX Color Support - Beautiful messages with custom colors (&#RRGGBB)
• Multi-Language Support - 8 languages included (English, Russian, Spanish, German, French, Portuguese, Chinese, Japanese)
• Folia Compatible - Full support for Folia server software alongside Bukkit/Spigot/Paper
• Highly Configurable - Customize every aspect of protection
• Pet-to-Pet Protection - Prevent tamed pets from attacking each other
• Mob Attack Prevention - Stop hostile mobs from attacking your pets
• Update Checker - Automatic version checking via Modrinth API
• Debug Mode - Optional detailed logging for troubleshooting
• Lightweight - Minimal performance impact
• Multi-Version Support - Compatible with Minecraft 1.16.5 - 1.21.11

Supported Damage Types

• Player attacks
• Explosions (TNT, Creepers, etc.)
• Drowning
• Fire and Lava damage
• Campfire damage
• Lightning strikes
• Fall damage
• Dragon breath
• Projectiles (arrows, etc.)
• Magic and potion effects
• Poison and Wither effects
• Entity cramming (too many entities in one block)
• Void damage and /kill command

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

# Pet attack prevention
prevent-tamed-pets-attack: true # Prevent tamed pets from attacking each other
prevent-mobs-attack-pets: true # Prevent hostile mobs from attacking tamed pets

# 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-campfire: true # Campfires
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
immortal-from-cramming: true # Entity cramming damage
immortal-from-void: true # Void damage and /kill command

# Localization
language: "en_US.yml" # Language file from messages folder

# Update checking
check-for-updates: true # Check for new versions on Modrinth

commandTabComplete: true # TAB completion for commands

Localization

The plugin supports multiple languages through the messages/ folder. Available languages:

• English (en_US.yml)
• Russian (ru_RU.yml)
• Spanish (es_ES.yml)
• German (de_DE.yml)
• French (fr_FR.yml)
• Portuguese (Brazil) (pt_BR.yml)
• Chinese (Simplified) (zh_CN.yml)
• Japanese (ja_JP.yml)

To change language, set language: "your_language.yml" in config.yml. You can also create custom language files by copying an existing one and modifying the messages.

HEX Color Examples

You can use HEX colors in messages:

• &#FF6B6B - Red
• &#4ECDC4 - Teal
• &#FFD93D - Yellow
• &#98FB98 - Light Green
• &#FF69B4 - Hot Pink
• &#ff5e1a - Orange
• &#1ad5ff - Cyan

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

Attack Notifications

When someone attempts to attack your tamed pets, you'll receive a notification the next time you log in:

• Grouped by Attacker: Multiple attacks from the same player are grouped together
• Rich Tooltips: Hover over the info icon to see up to 10 attacked pets
• Online Status: Shows whether the attacker is currently online or offline
• Overflow Handling: If more than 10 pets were attacked, shows count of additional attempts

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

Server Software Compatibility

Fully Supported

• Bukkit - Full support
• Spigot - Full support with BungeeCord Chat API fallback
• Paper - Full support with Adventure API
• Purpur - Full support (Paper-based)
• Folia - Full support with native schedulers

Folia Support

The plugin automatically detects Folia and uses appropriate schedulers:

• GlobalRegionScheduler for global tasks
• EntityScheduler for player-specific tasks
• Automatic fallback to Bukkit scheduler if Folia APIs are unavailable

No special configuration needed - just place the JAR in your plugins folder!

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.11
• Server Software: Bukkit, Spigot, Paper, Purpur, Folia
• Java: 8+

Links

• Discord Support: Discord