ᴍɪɴᴇᴄʀᴀꜰᴛʀᴇꜱᴏᴜʀᴄᴇꜱ
ModsShadersPluginsResource PacksModpacks
Log inSign up

CustomNPCs

Modrinth

A simple, lightweight, intuitive NPC plugin.

61.5K downloads137 followersUpdated 2mo ago

1.8.2 · MC 26.2 · Paper

View on Modrinth

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

Show more files (33 more)

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

Banner

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:

ActionDescription
Send MessageSend a custom chat message to the player
Display TitleShow a title/subtitle on screen
Action BarDisplay text in the action bar
Play SoundPlay any in-game sound
Run CommandExecute a command as the player or console
BungeeCord / VelocitySend the player to another server
TeleportTeleport the player anywhere
Give / Remove XPModify player experience
Give / Remove Potion EffectApply or clear potion effects
Follow Preset PathWalk 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.

ResourceLink
GitHub Wikigithub.com/Foxikle/CustomNPCs/wiki
Plugin Wikidocs.foxikle.dev
JavadocsJavadoc (1.8.0)

📊 Statistics

bStats

🐛 Support & Bug Reports

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

❤️ 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.