SimpleNPC is a lightweight yet powerful Paper plugin that brings lifelike player\u2011controlled 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.<\/p>\n
\u2728 Features
\n\ud83d\udc64 True Player Appearance \u2013 NPCs wear a Steve head and leather armor, blending perfectly with real players. Their name tag shows health and hunger in real time.<\/p>\n
\ud83e\udde0 Advanced AI Behaviors<\/p>\n
Mining \u2013 Give them a pickaxe, and they\u2019ll automatically search for and break nearby stone, ores, and deepslate (up to 5 blocks away).<\/p>\n
Woodcutting \u2013 Hand them an axe, and they\u2019ll chop down logs of all types.<\/p>\n
Combat \u2013 With a sword, NPCs will engage nearby monsters (zombies, skeletons, etc.).<\/p>\n
Eating \u2013 When hunger drops, they consume food from their inventory, complete with burp sounds.<\/p>\n
Health Regeneration \u2013 If well\u2011fed (hunger \u2265 18), they slowly regenerate health.<\/p>\n
Sleeping \u2013 At night, NPCs search for a bed and \u201csleep\u201d until dawn.<\/p>\n
Random Walking \u2013 When idle, they wander around like real players.<\/p>\n
\ud83d\udee1\ufe0f Creator Protection \u2013 The player who spawned an NPC is never attacked, not even in revenge mode.<\/p>\n
\u26a1 Revenge Mode \u2013 If another player attacks the NPC, it enters a 5\u2011second revenge mode and will instantly kill that attacker on its next hit.<\/p>\n
\ud83d\udcac Action Messages \u2013 NPCs announce what they\u2019re doing (mining, eating, sleeping, etc.) with colorful chat messages, repeated only every 5 seconds to avoid spam.<\/p>\n
\ud83d\udcb0 Economy Integration \u2013 Uses Vault to charge players without the simplenpc.spawn permission. Set your own cost in config.yml.<\/p>\n
\ud83d\udcbe Persistent Data \u2013 All NPCs and their inventories are saved to disk and restored after a server restart.<\/p>\n
\ud83c\udfad Multiple Types \u2013 Choose from steve (fights monsters), zombie (attacks players), or villager (same as steve) \u2013 more can be added easily.<\/p>\n
\ud83d\udd27 Installation
\nDownload the latest SimpleNPC-*.jar from the Releases page.<\/p>\n
Place it in your server\u2019s plugins folder.<\/p>\n
Ensure your server runs Paper 1.21+ and has Vault installed (with an economy plugin like EssentialsX).<\/p>\n
Restart the server.<\/p>\n
After first start, a configuration file is created at plugins\/SimpleNPC\/config.yml.<\/p>\n
\u2699\ufe0f Configuration
\nyaml
\n# Cost to spawn an NPC for players without permission
\nspawn-cost: 100.0<\/p>\n
# How often (in seconds) NPCs perform automatic actions (eating, health regen, etc.)
\naction-interval: 1
\n\ud83c\udfae Commands & Permissions
\nCommand\tDescription\tPermission
\n\/spawnnpc [type] [name]\tSpawns an NPC at your location. type can be steve, zombie, or villager (default steve). name is optional (default “Steve”).\tsimplenpc.spawn (default: op)
\nWithout permission \u2013 Players pay the configured spawn-cost from their Vault balance.<\/p>\n
With permission \u2013 Free spawn.<\/p>\n
\ud83e\udde0 How to Use
\nSpawn an NPC \u2013 Stand where you want it and run \/spawnnpc steve Bob.<\/p>\n
Give it items \u2013 Right\u2011click the NPC to open its 27\u2011slot inventory. Place tools (pickaxe, axe, sword) or food inside.<\/p>\n
Watch it work \u2013 The NPC will now:<\/p>\n
Wander randomly when idle.<\/p>\n
Mine stone\/ores if holding a pickaxe.<\/p>\n
Chop trees if holding an axe.<\/p>\n
Attack monsters if holding a sword (and not in revenge mode).<\/p>\n
Eat food when hungry.<\/p>\n
Find a bed and \u201csleep\u201d at night.<\/p>\n
Testing revenge \u2013 Ask a friend to hit the NPC. It will flash revenge mode and instantly kill them on the next hit.<\/p>\n
\u26a0\ufe0f Requirements
\nPaper 1.21 or higher (Spigot is not fully compatible).<\/p>\n
Java 21 or higher.<\/p>\n
Vault (mandatory \u2013 plugin will not load without it).
\nIf you don\u2019t need economy, you can modify the plugin to soft\u2011depend Vault (not recommended for production).<\/p>\n","protected":false},"excerpt":{"rendered":"
A Minecraft Paper plugin that adds lifelike player NPCs with AI behavior: mining, fighting, eating, sleeping, and more!<\/p>\n","protected":false},"featured_media":141135,"template":"","meta":{"_minecraft_slug":"simplenpc","_minecraft_project_id":"r2i4JORh","_minecraft_author":"Boulder_BDX","_minecraft_license":"Apache-2.0","_minecraft_downloads":683,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simplenpc.zip","_minecraft_size_bytes":48373,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T09:45:56.718111Z","_minecraft_date_created":"2026-03-04T23:29:19.469236Z","_minecraft_date_modified":"2026-03-03T03:14:08.744806Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simplenpc","_minecraft_icon_attachment_id":141135,"_minecraft_imported_at":"2026-06-08T09:15:05+00:00","_minecraft_import_hash":"d254e539e751ca4ffac2bdfd56a356fd","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,137,127,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-141134","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-mobs","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n