FoliaNPC
Lightweight player-style NPCs for Spigot, Paper and Folia
Lightweight player-style NPCs for Spigot, Paper and Folia
Official Website and Documentation
FoliaNPC is a lightweight NPC plugin that lets you create player-style NPCs for lobbies, guides, shops, quests, tutorials and interactive server menus.
It supports Spigot, Paper and Folia, uses Folia-aware scheduling, stores NPCs in simple YAML files, and supports click actions, dialogs, holograms, skins and import/export tools.
Features
- Player-style NPC rendering
- Spigot, Paper and Folia support
- Folia region-safe scheduling
- NPC creation, removal, teleport, movement and rename
- Right-click, left-click or both-click actions
- Console and player command execution
- Per-action cooldown support
- Optional action permissions
- Dialog trait with placeholder support
- Look-at-player rotation
- Configurable view distance
- Hologram name and description lines
- Skins from online players
- Skins from Mojang texture URLs
- Raw texture value and signature support
- YAML NPC storage
- NPC import and export
- Admin GUI
- Optional PlaceholderAPI support
Requirements
- Java 17 or newer
- Minecraft 1.20+
- Spigot, Paper or Folia
- EntityPacketBridge recommended for modern NMS click support
- PacketEvents supported as fallback renderer
Installation
- Download or build FoliaNPC.jar.
- Put it in your server plugins folder.
- Install EntityPacketBridge or PacketEvents.
- Start the server once.
- Edit plugins/FoliaNPC/config.yml if needed.
- Create your first NPC with /npc create <id> [name].
Commands
Main NPC commands
Code (Text):
/npc
/npc create <id> [name]
/npc remove <id>
/npc list
/npc select <id>
/npc info [id]
/npc debug [id]
/npc tp [id]
/npc move <id> <x> <y> <z> [yaw] [pitch]
/npc rename <id> <name>
/npc reload
Code (Text):
/npc skin <id> player <onlinePlayer>
/npc skin <id> url <url> [slim|wide]
/npc skin <id> texture <value> [signature]
/npc skin <id> clear
/npc skinurl <id> <url> [slim|wide]
Code (Text):
/npc look <id> <on|off>
/npc range <id> <blocks>
/npc trait <id> <command|dialog|shop|quest>
Code (Text):
/npc command add <id> <command>
/npc command remove <id> <index>
/npc command list <id>
/npc command clear <id>
/npc action <id> add <right|left|both> <console|player> <command>
/npc action <id> clear
/npc action <id> list
Code (Text):
/npc dialog <id> set <line1 | line2>
Code (Text):
/npc hologram <id> name <on|off>
/npc hologram <id> description set <line1 | line2>
/npc hologram <id> description <on|off>
/npc hologram <id> description clear
/npc hologram <id> mode <name|description|both|none>
Code (Text):
/npc export <id>
/npc import <file>
/npc menu [id]
Code (Text):
folianpc.admin
Placeholders
Built-in placeholders for actions and dialogs:
Code (Text):
{player} Player name
{uuid} Player UUID
{npc} NPC ID
{npc_name} NPC display name without color codes
Skin Notes
For reliable URL skins, use Mojang texture URLs:
Code (Text):
https://textures.minecraft.net/texture/<hash>
Code (Text):
/npc skin guide texture <value> [signature]
Code (Text):
plugins/FoliaNPC/config.yml
plugins/FoliaNPC/messages.yml
plugins/FoliaNPC/npcs.yml
plugins/FoliaNPC/exports/<id>.yml
- Spigot 1.20+ supported with PacketEvents fallback
- Paper 1.20+ supported
- Folia 1.20+ supported with Folia-aware scheduling
Support
If NPCs do not render, install EntityPacketBridge or PacketEvents and check:
Code (Text):
/npc debug [id]
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.6, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
FoliaNPC is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21, 26.1 and newer. Downloaded 101 times (via Spigot). Download it and open it directly in the game.