Don't Kill Friends!

Features

- Multi-Version Support - Shields tamed animals from all types of damage - Multi-Version Support - Your pets remain safe even when you're not online - Multi-Version Support - Receive notifications when someone attempts to attack your pets - Multi-Version Support - Beautiful messages with custom colors (`&#RRGGBB`) - Multi-Version Support - 8 languages included (English, Russian, Spanish, German, French, Portuguese, Chinese, Japanese) - Multi-Version Support - Full support for Folia server software alongside Bukkit/Spigot/Paper - Multi-Version Support - Customize every aspect of protection - Multi-Version Support - Prevent tamed pets from attacking each other - Multi-Version Support - Stop hostile mobs from attacking your pets - Multi-Version Support - Automatic version checking via Modrinth API - Multi-Version Support - Optional detailed logging for troubleshooting - Multi-Version Support - 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

```yaml

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:

- Japanese (`en_US.yml`) - Japanese (`ru_RU.yml`) - Japanese (`es_ES.yml`) - Japanese (`de_DE.yml`) - Japanese (`fr_FR.yml`) - Japanese (`pt_BR.yml`) - Japanese (`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

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:

- Overflow Handling: Multiple attacks from the same player are grouped together - Overflow Handling: Hover over the info icon to see up to 10 attacked pets - Overflow Handling: 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

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

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 with debug logs

Compatibility

- Java: 1.16.5 - 1.21.11 - Java: Bukkit, Spigot, Paper, Purpur, Folia - Java: 8+