CustomNPCs

Modrinth

A simple, lightweight, intuitive NPC plugin.

61.5K downloads137 followersUpdated 2mo ago

1.8.2 · MC 26.2 · Paper

Files

1.8.2
release
Bug Fixes
26.226.1.226.1.126.1+14paper
2026-08-29 · 3.2K downloads
customnpcs-1.8.2-all.jar · 607 KB
1.8.1
release
CustomNPCs 1.8.1
26.226.1.226.1.126.1+14paper
2026-08-09 · 1.3K downloads
customnpcs-1.8.1.jar · 608 KB
1.8.0
release
CustomNPCs 1.8.0
26.226.1.226.1.126.1+14paper
2026-07-14 · 1.4K downloads
customnpcs-1.8.0-all.jar · 608 KB
1.7.10
release
CustomNPCs 1.7.10
26.226.1.226.1.126.1+14paper
2026-07-08 · 433 downloads
customnpcs-1.7.10.jar · 583 KB
1.7.10-pre2
beta
CustomNPCs 1.7.10-pre2
26.226.1.226.1.126.1+14paper
2026-06-16 · 934 downloads
customnpcs-1.7.10-pre2.jar · 578 KB
1.7.10-pre1
beta
CustomNPCs 1.7.10-pre1
26.1.226.1.126.11.21.11+13paper
2026-05-17 · 1.4K downloads
customnpcs-1.7.10-pre1.jar · 561 KB
1.7.9
release
CustomNPCs 1.7.9
1.21.111.21.101.21.91.21.8+15paper
2026-03-01 · 5.2K downloads
customnpcs-1.7.9.jar · 587 KB
1.7.8
release
CustomNPCs 1.7.8
1.21.111.21.101.21.91.21.8+15paper
2025-12-11 · 5K downloads
customnpcs-1.7.8.jar · 587 KB
1.7.7
release
CustomNPCs 1.7.7
1.21.101.21.91.21.81.21.7+14paper
2025-10-14 · 3K downloads
customnpcs-1.7.7.jar · 568 KB
1.7.6
release
CustomNPCs 1.7.6
1.21.91.21.81.21.71.21.6+13paper
2025-10-01 · 855 downloads
customnpcs-1.7.6.jar · 568 KB
1.7.5
release
CustomNPCs 1.7.5
1.21.81.21.71.21.61.21.5+12paper
2025-08-04 · 3.4K downloads
customnpcs-1.7.5.jar · 552 KB
1.7.5-pre8
beta
CustomNPCs 1.7.5-pre8
1.21.81.21.71.21.61.21.5+12paper
2025-08-04 · 150 downloads
customnpcs-1.7.5-pre8.jar · 552 KB
1.7.5-pre7
beta
CustomNPCs 1.7.5-pre7
1.21.81.21.71.21.61.21.5+12paper
2025-08-04 · 140 downloads
customnpcs-1.7.5-pre7.jar · 552 KB
1.7.5-pre6
beta
CustomNPCs 1.7.5-pre6
1.21.81.21.71.21.61.21.5+12paper
2025-07-29 · 394 downloads
customnpcs-1.7.5-pre6.jar · 551 KB
1.7.5-pre5
beta
CustomNPCs 1.7.5-pre5
1.21.81.21.71.21.61.21.5+12paper
2025-07-25 · 292 downloads
customnpcs-1.7.5-pre5.jar · 546 KB
1.7.5-pre4
beta
CustomNPCs 1.7.5-pre4
1.21.71.21.61.21.51.21.4+11paper
2025-07-09 · 954 downloads
customnpcs-1.7.5-pre4.jar · 546 KB
1.7.5-pre3
beta
CustomNPCs 1.7.5-pre3
1.21.71.21.61.21.51.21.4+11paper
2025-07-04 · 418 downloads
customnpcs-1.7.5-pre3.jar · 546 KB
1.7.5-pre2
beta
CustomNPCs 1.7.5-pre2
1.21.51.21.41.21.31.21.2+9paper
2025-06-15 · 1K downloads
customnpcs-1.7.5-pre2.jar · 530 KB
1.7.5-pre1
beta
CustomNPCs 1.7.5-pre1
1.21.51.21.41.21.31.21.2+9paper
2025-05-17 · 1.5K downloads
customnpcs-1.7.5-pre1.jar · 502 KB
1.7.4
release
CustomNPCs 1.7.4
1.21.41.21.31.21.21.21.1+8paper
2025-04-20 · 2.7K downloads
customnpcs-1.7.4.jar · 490 KB
1.7.3
release
CustomNPCs 1.7.3
1.21.41.21.31.21.21.21.1+8paper
2025-03-09 · 2.6K downloads
customnpcs-1.7.3.jar · 486 KB
1.7.2
release
CustomNPCs 1.7.2
1.21.41.21.31.21.21.21.1+8paper
2025-01-17 · 3.1K downloads
customnpcs-1.7.2.jar · 481 KB
1.7.1
release
CustomNPCs 1.7.1 -- HOTFIX
1.21.41.21.31.21.21.21.1+8paper
2024-12-22 · 1.8K downloads
customnpcs-1.7.1.jar · 5.0 MB
1.7
release
CustomNPCs 1.7
1.21.41.21.31.21.21.21.1+8paper
2024-12-21 · 384 downloads
customnpcs-1.7.jar · 5.0 MB
1.7-pre12
beta
CustomNPCs 1.7-pre12 (Hotfix)
1.21.31.21.21.21.11.21+7paper
2024-11-30 · 1.1K downloads
customnpcs-1.7-pre12.jar · 4.9 MB
1.7-pre11
beta
CustomNPCs 1.7-pre11
1.21.31.21.21.21.11.21+7paper
2024-11-28 · 284 downloads
customnpcs-1.7-pre11.jar · 4.9 MB
1.7-pre10
beta
CustomNPCs 1.7-pre10
1.21.31.21.21.21.11.21+7paper
2024-11-22 · 414 downloads
customnpcs-1.7-pre10.jar · 4.9 MB
1.7-pre9
beta
CustomNPCs 1.7-pre9
1.21.31.21.21.21.11.21+7paper
2024-11-18 · 288 downloads
customnpcs-1.7-pre9.jar · 4.5 MB
1.7-pre8
beta
CustomNPCs 1.7-pre8
1.21.31.21.21.21.11.21+7paper
2024-11-17 · 146 downloads
customnpcs-1.7-pre8.jar · 4.5 MB
1.7-pre3
beta
CustomNPCs 1.7-pre3
1.21.11.211.20.61.20.5+5paper
2024-09-22 · 2.3K downloads
customnpcs-1.7-pre3.jar · 4.4 MB
1.7-pre2
beta
CustomNPCs 1.7-pre2
1.20.61.20.51.20.41.20.3+3paper
2024-06-02 · 4.3K downloads
customnpcs-1.7-pre2.jar · 4.7 MB
1.7-pre1
beta
CustomNPCs 1.7-pre1
1.20.61.20.51.20.41.20.3+3paper
2024-05-01 · 1.1K downloads
customnpcs-1.7-pre1.jar · 4.7 MB
1.6.1
release
CustomNPCs 1.6.1
1.20.41.20.31.20.21.20.1+1paper
2024-04-26 · 2.1K downloads
customnpcs-1.6.1.jar · 4.7 MB
1.6.1-pre2
beta
CustomNPCs 1.6.1-pre2
1.20.41.20.31.20.21.20.1+1paper
2024-04-01 · 734 downloads
customnpcs-1.6.1-pre2.jar · 4.7 MB
1.6.1
beta
CustomNPCs 1.6.1-pre1
1.20.41.20.31.20.21.20.1+1paper
2024-03-30 · 221 downloads
customnpcs-1.6.1-pre1.jar · 4.7 MB
1.6
release
CustomNPCs - 1.6.0
1.20.41.20.31.20.21.20.1+1paper
2024-03-02 · 1.3K downloads
customnpcs-1.6.jar · 4.7 MB
1.6-pre5
beta
CustomNPCs 1.6-pre5
1.20.41.20.31.20.21.20.1+1paper
2024-02-29 · 250 downloads
customnpcs-1.6-pre5.jar · 4.7 MB
1.6-pre4
beta
CustomNPCs 1.6-pre4
1.20.41.20.31.20.21.20.1+1paper
2024-02-28 · 190 downloads
customnpcs-1.6-pre4.jar · 4.7 MB
1.6-pre3
beta
CustomNPCs 1.6-pre3
1.20.41.20.31.20.21.20.1+1paper
2024-02-24 · 257 downloads
customnpcs-1.6-pre3.jar · 4.7 MB
1.6-pre2
beta
CustomNPCs 1.6-pre2
1.20.41.20.31.20.21.20.1+1paper
2023-12-14 · 973 downloads
customnpcs-1.6-pre2.jar · 210 KB
1.6-pre1
beta
CustomNPCs 1.6-pre1
1.20.41.20.3paper
2023-12-10 · 167 downloads
CustomNPCs-1.6-pre1.jar · 196 KB
1.5.2
release
CustomNPCs 1.5.2
1.20.2paper
2023-12-05 · 423 downloads
CustomNPCs-1.5.2.jar · 195 KB
1.5.2-pre3
beta
CustomNPCs 1.5.2-pre3
1.20.2paper
2023-11-24 · 121 downloads
CustomNPCs-1.5.2-pre3.jar · 195 KB
1.5.2-pre2
beta
CustomNPCs 1.5.2-pre2
1.20.2paper
2023-11-17 · 137 downloads
CustomNPCs-1.5.2-pre2.jar · 191 KB
1.5.2-pre1
beta
CustomNPCs 1.5.2-pre1
1.20.2paper
2023-11-16 · 100 downloads
CustomNPCs-1.5.2-pre1.jar · 191 KB
1.5.1
release
CustomNPCs 1.5.1 - Bug Fix
1.20.2paper
2023-11-03 · 194 downloads
CustomNPCs-1.5.1.jar · 192 KB
1.5
release
1.5
1.20.2paper
2023-11-01 · 140 downloads
CustomNPCs-1.5.jar · 191 KB
1.4.2
release
CustomNPCs 1.4.2
1.20.11.20paper
2023-10-04 · 997 downloads
CustomNPCs-1.4.2.jar · 189 KB
1.4.1
release
CustomNPCs 1.4.1
1.20.11.20paper
2023-09-24 · 154 downloads
CustomNPCs-1.4.1.jar · 189 KB
1.4
release
Conditional Actions! (1.4)
1.20.11.20paper
2023-09-15 · 188 downloads
CustomNPCs-1.4.jar · 189 KB
1.3.2
release
CustomNPCs 1.3.2
1.20.11.20paper
2023-08-24 · 194 downloads
CustomNPCs-1.3.2.jar · 156 KB
1.3.1
release
CustomNPCs 1.3.1
1.20.11.20paper
2023-07-23 · 269 downloads
CustomNPCs-1.3.1.jar · 152 KB
1.3
release
1.3
1.20.11.20paper
2023-06-30 · 916 downloads
CustomNPCs-1.3.jar · 152 KB

Files are delivered unmodified from Modrinth's servers and verified against the SHA-512 hash published by the project. The project's license applies to every file; check it before redistributing.

Gallery

About

CustomNPCs

A powerful, configurable NPC plugin for Paper servers.

Paper

Looking for contributors!

If you're interested in contributing to the project, please reach out! I'm looking for help maintaining the project <3

✨ Features

🎨 Appearance

Names longer than 16 characters — break vanilla's character limit
MiniMessage color support — gradients, rainbow names, hex colors, and more
Fully customizable skins — use any player skin or custom texture
Armor & item display — equip NPCs with any gear you can imagine
Multiline Holograms — Create NPCs with as many hologram lines as you'd like

⚡ Interaction Actions

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!

🧠 Behavior

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

🌍 Translations

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

👉 Translate 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.

🛠️ Developer API

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)

📊 Statistics

🐛 Support & Bug Reports

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

Discord — Fastest way to get support
GitHub Issues — For confirmed bugs and feature requests

❤️ Support the Project

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

Patreon · PayPal · GitHub Sponsors

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

CustomNPCs

Files

1.8.2

1.8.1

1.8.0

1.7.10

1.7.10-pre2

1.7.10-pre1

1.7.9

1.7.8

1.7.7

1.7.6

1.7.5

1.7.5-pre8

1.7.5-pre7

1.7.5-pre6

1.7.5-pre5

1.7.5-pre4

1.7.5-pre3

1.7.5-pre2

1.7.5-pre1

1.7.4

1.7.3

1.7.2

1.7.1

1.7

1.7-pre12

1.7-pre11

1.7-pre10

1.7-pre9

1.7-pre8

1.7-pre3

1.7-pre2

1.7-pre1

1.6.1

1.6.1-pre2

1.6.1

1.6

1.6-pre5

1.6-pre4

1.6-pre3

1.6-pre2

1.6-pre1

1.5.2

1.5.2-pre3

1.5.2-pre2

1.5.2-pre1

1.5.1

1.5

1.4.2

1.4.1

1.4

1.3.2

1.3.1

1.3

Gallery

About

CustomNPCs

Looking for contributors!

✨ Features

🎨 Appearance

⚡ Interaction Actions

🧠 Behavior

🌍 Translations

🛠️ Developer API

📊 Statistics

🐛 Support & Bug Reports

❤️ Support the Project