CustomNPCs

A powerful, configurable NPC plugin for Paper servers.

Paper

✨ Features

Trigger actions when players interact with an NPC:

Action	Description
Send Message	Send a custom chat message to the player
Display Title	Show a title/subtitle on screen
Action Bar	Display text in the action bar
Play Sound	Play any in-game sound
Run Command	Execute a command as the player or console
BungeeCord / Velocity	Send the player to another server
Teleport	Teleport the player anywhere
Give / Remove XP	Modify player experience
Give / Remove Potion Effect	Apply or clear potion effects
Follow Preset Path	Walk in a pre-recorded path

Each action has a configurable delay and cooldown!

Look at players — NPCs track nearby players naturally
Configurable idle direction — set a default look direction when not tracking
Flexible persistence — choose between session-only NPCs (cleared on restart) or fully persistent NPCs that survive restarts
Conditional Actions — Execute specific actions under certain circumstances

CustomNPCs supports multiple languages! If you speak a language other than English and want to contribute, join the translation effort on Crowdin:

Don't see your language listed? Send @foxikle a DM on Discord or open a ticket in the support server to request it.

Integrate CustomNPCs into your own plugins with the provided API.

Resource	Link
GitHub Wiki	github.com/Foxikle/CustomNPCs/wiki
Plugin Wiki	docs.foxikle.dev
Javadocs	Javadoc (1.8.0)

Encounter a bug or need help? Here's where to go:

If CustomNPCs has been useful to you, consider supporting development!

CustomNPCs is open source. Contributions, translations, and feedback are always welcome.