Bodyguard

Bodyguard

Bodyguard lets players spawn loyal personal guards that follow them, keep a sensible escort position, and defend them from configured threats. It is built for Paper servers that want practical companion protection without requiring a database, NMS code, or a full NPC system for normal mob guards.

It works out of the box with YAML storage and also supports SQLite, MySQL, and MariaDB for larger servers.

Features

• Spawn configurable mob bodyguards such as wolves, iron golems, vindicators, pillagers, skeletons, and zombies.
• Optional fake-player bodyguard appearance through the NPCs plugin.
• Follow behaviour keeps guards near the owner in a configurable ring instead of standing inside them.
• Combat modes include passive, defensive, aggressive, and stay.
• Defensive guards react when their owner is damaged or targeted by hostile mobs.
• Aggressive guards can seek nearby hostile mobs.
• Configurable support for hostile mobs, neutral mobs targeting the owner, player targets, creative/spectator ignoring, friendly-fire prevention, target radius, and retarget timing.
• Bodyguards can be renamed, healed, recalled, dismissed, restored, saved, backed up, and inspected.
• Persistent records are saved for each guard, including owner, type, appearance, display type, name, mode, location, and suspended state.
• Configurable limits, world whitelist/blacklist, health values, equipment, names, collision, invulnerability, drops, sunlight burning protection, and storage behaviour.

Integrations

• NPCs: creates, moves, and removes linked fake-player visuals for bodyguards.
• Lifesaver: sends bodyguard protections through Lifesaver's protection/save announcement pipeline.
• StormEconomy: can reward Bodyguard protections when they flow through Lifesaver reward events.
• Bukkit permissions: works with standard permission plugins.

Bodyguard also registers BodyguardApi so other plugins can inspect active bodyguards, player-owned bodyguards, persisted guard counts, and storage health.

Commands

Main command aliases:

• /bodyguard
• /bg

Common commands:

• /bodyguard spawn [type] [name]
• /bodyguard list
• /bodyguard info <id|name>
• /bodyguard mode [id|name] <passive|defensive|aggressive|stay>
• /bodyguard rename <id|name> <new name>
• /bodyguard heal [id|name|all]
• /bodyguard recall [id|name|all]
• /bodyguard dismiss [id|name|all]
• /bodyguard restore
• /bodyguard status
• /bodyguard stats
• /bodyguard save
• /bodyguard backup
• /bodyguard reload

Permissions

• bodyguard.command
• bodyguard.spawn
• bodyguard.dismiss
• bodyguard.recall
• bodyguard.mode
• bodyguard.rename
• bodyguard.heal
• bodyguard.restore
• bodyguard.save
• bodyguard.backup
• bodyguard.reload
• bodyguard.admin

Notes

Bodyguard does not require NPCs for normal mob companions.

Fake-player bodyguards require the companion NPCs plugin unless fallback mode is explicitly enabled.

Player targeting is disabled by default.

The default storage backend is YAML. SQLite, MySQL, and MariaDB are optional.