SimpleNPC is a lightweight yet powerful Paper plugin that brings lifelike player‑controlled NPCs to your Minecraft server. Spawn NPCs that look like real players (Steve skin), give them tools and food, and watch them autonomously mine ores, chop trees, fight monsters, eat when hungry, and even sleep at night! They protect their creator, react to attacks with devastating revenge, and keep the server alive with their witty chat messages.

✨ Features 👤 True Player Appearance – NPCs wear a Steve head and leather armor, blending perfectly with real players. Their name tag shows health and hunger in real time.

🧠 Advanced AI Behaviors

Mining – Give them a pickaxe, and they’ll automatically search for and break nearby stone, ores, and deepslate (up to 5 blocks away).

Woodcutting – Hand them an axe, and they’ll chop down logs of all types.

Combat – With a sword, NPCs will engage nearby monsters (zombies, skeletons, etc.).

Eating – When hunger drops, they consume food from their inventory, complete with burp sounds.

Health Regeneration – If well‑fed (hunger ≥ 18), they slowly regenerate health.

Sleeping – At night, NPCs search for a bed and “sleep” until dawn.

Random Walking – When idle, they wander around like real players.

🛡️ Creator Protection – The player who spawned an NPC is never attacked, not even in revenge mode.

⚡ Revenge Mode – If another player attacks the NPC, it enters a 5‑second revenge mode and will instantly kill that attacker on its next hit.

💬 Action Messages – NPCs announce what they’re doing (mining, eating, sleeping, etc.) with colorful chat messages, repeated only every 5 seconds to avoid spam.

💰 Economy Integration – Uses Vault to charge players without the simplenpc.spawn permission. Set your own cost in config.yml.

💾 Persistent Data – All NPCs and their inventories are saved to disk and restored after a server restart.

🎭 Multiple Types – Choose from steve (fights monsters), zombie (attacks players), or villager (same as steve) – more can be added easily.

🔧 Installation Download the latest SimpleNPC-*.jar from the Releases page.

Place it in your server’s plugins folder.

Ensure your server runs Paper 1.21+ and has Vault installed (with an economy plugin like EssentialsX).

Restart the server.

After first start, a configuration file is created at plugins/SimpleNPC/config.yml.

⚙️ Configuration yaml

Cost to spawn an NPC for players without permission

spawn-cost: 100.0

How often (in seconds) NPCs perform automatic actions (eating, health regen, etc.)

action-interval: 1 🎮 Commands & Permissions Command Description Permission /spawnnpc [type] [name] Spawns an NPC at your location. type can be steve, zombie, or villager (default steve). name is optional (default "Steve"). simplenpc.spawn (default: op) Without permission – Players pay the configured spawn-cost from their Vault balance.

With permission – Free spawn.

🧠 How to Use Spawn an NPC – Stand where you want it and run /spawnnpc steve Bob.

Give it items – Right‑click the NPC to open its 27‑slot inventory. Place tools (pickaxe, axe, sword) or food inside.

Watch it work – The NPC will now:

Wander randomly when idle.

Mine stone/ores if holding a pickaxe.

Chop trees if holding an axe.

Attack monsters if holding a sword (and not in revenge mode).

Eat food when hungry.

Find a bed and “sleep” at night.

Testing revenge – Ask a friend to hit the NPC. It will flash revenge mode and instantly kill them on the next hit.

⚠️ Requirements Paper 1.21 or higher (Spigot is not fully compatible).

Java 21 or higher.

Vault (mandatory – plugin will not load without it). If you don’t need economy, you can modify the plugin to soft‑depend Vault (not recommended for production).