Minecraft plugin Sentinel

About Sentinel

Sentinel adds configurable combat NPCs to Spigot servers. It extends Citizens NPCs with combat behaviors so NPCs can act as guards, arena opponents, healers or scripted combat entities.

Main functionality

• Adds combat traits to Citizens NPCs (melee, ranged, healing and utility behaviors). ()
• Flexible targeting system (many built‑in target types and matchers).
• Configurable stats: health, damage, armor, speed, attack rates, drops and respawn behavior. ()
• Integrations with common server plugins (Vault, Towny, Factions, Denizen, WorldGuard, etc.). ()

Commands

(All commands are literal; keep exact spelling when using.)

• /sentinel help — Shows help info.
• /sentinel info — Shows info on the current NPC.
• /sentinel stats — Shows statistics about the current NPC.
• /sentinel targets — Shows the targets of the current NPC.
• /sentinel ignores — Shows the ignore targets of the current NPC.
• /sentinel avoids — Shows the avoid targets of the current NPC.
• /sentinel debug — Toggles debug output to console.
• /sentinel reload — Reloads the configuration file.
• /sentinel kill — Kills the NPC.
• /sentinel respawn — Respawns the NPC.
• /sentinel forgive id/name — Forgives the specified entity or all current targets.
• /sentinel guard PLAYERNAME/npc:ID — Makes the NPC guard a player or NPC.
• /sentinel addtarget TYPE — Adds a target.
• /sentinel removetarget TYPE — Removes a target.
• /sentinel addignore TYPE — Ignores a target.
• /sentinel removeignore TYPE — Allows targeting a target.
• /sentinel addavoid TYPE — Avoids a target.
• /sentinel removeavoid TYPE — Stops avoiding a target.
• /sentinel avoidrange RANGE — Sets avoidance distance.
• /sentinel range RANGE — Sets maximum attack range.
• /sentinel damage DAMAGE — Sets attack damage (use -1 to auto‑calculate).
• /sentinel weapondamage MATERIAL DAMAGE — Per‑weapon damage setting.
• /sentinel armor ARMOR — Sets armor value (or -1 to auto‑calculate).
• /sentinel health HEALTH — Sets NPC health.
• /sentinel attackrate RATE 'ranged' — Sets attack rate.
• /sentinel healrate RATE — Sets NPC heal rate.
• /sentinel respawntime TIME — Sets respawn time (0 = no respawn, -1 = delete on death).
• /sentinel chaserange RANGE — Sets chase range.
• /sentinel drops — Edit NPC drops.
• /sentinel dropchance ID CHANCE — Set drop chance by ID.
• /sentinel deathxp XP — Set XP dropped on death.
• /sentinel targettime TIME — Set target time limit.
• /sentinel speed SPEED — Set movement speed modifier.
• /sentinel spawnpoint — Toggle/change spawnpoint.
• /sentinel greeting GREETING — Set greeting message.
• /sentinel warning WARNING — Set warning message.
• /sentinel greetrange RANGE — Set greeting distance.
• /sentinel greetrate RATE — Set greeting cooldown.
• /sentinel accuracy OFFSET — Set weapon accuracy.
• /sentinel squad SQUAD — Set squad name (shared aggro).
• /sentinel reach REACH — Set reach for melee.
• /sentinel projectilerange RANGE — Set projectile range.
• /sentinel protectfromrange RANGE — Configure protection distance.
• Toggleable flags (true/false): invincible, protected, fightback, runaway, needammo, safeshot, chaseclose, chaseranged, enemydrops, autoswitch, realistic, knockback. ()

Permissions

• sentinel.basic — Access to /sentinel commands.
• sentinel.admin — Edit other players' Sentinel NPCs.
• sentinel.greet — Use greeting-related commands.
• sentinel.info — Use info/stats/targets commands.
• Other commands use sentinel.X where X is the command name (for example: sentinel.damage). ()

Compatibility & dependencies

• Requires Citizens (Citizens2) as NPC engine. ()
• Compatible with modern Spigot/Paper builds; README states compatibility covering Spigot 1.19+ through 1.21.3 (primarily targeted at 1.21.3). Check the project notes for precise tested versions. ()
• Optional integrations: Denizen/Depenizen, Vault, Towny, Factions, WorldGuard, QualityArmory, CrackShot and others listed in the repository. ()

Basic usage notes

• Install Citizens first, then drop Sentinel into plugins/ and start the server to generate config. Use /npc create + /trait Sentinel + /npc equip to set up NPCs. README includes example NPC setups (guards, archers, healers). ()

Where to get help and sources

• Official repository and Spigot resource pages contain full docs, example setups and issue/troubleshooting guidance. ()