Main Configuration

On this page, you will find everything you need to know about the config.yml options of Phoenix NPCs

Changes made by hand in config.yml apply with /pnpc reload. Options changed from Editor > Settings are saved straight away.

#General Configuration

Internal Pool Size - The number of threads the plugin keeps for its own background work. The default of 4 suits almost every server.
Debug - Adds verbose logging to the console, useful when reporting an issue.

performance:
  internal-pool-size: 4
debug: false

#NPC Defaults

The visibility distance and the interaction cooldown are used by every NPC that does not set its own. The other two apply to every NPC.

Option	Description
visibility-distance	How many blocks away players can see an NPC.
interaction-cooldown	How many milliseconds a player waits between clicks on an NPC.
look-distance	How close a player has to be, in blocks, for an NPC to turn its head to them.
tab-remove-delay	How many ticks a player NPC not shown in tab stays in the tab list after it appears, so its skin has time to load.

visibility-distance: 48.0
interaction-cooldown: 500
look-distance: 6.0
tab-remove-delay: 40

#MineSkin

Needed for skins from an image URL. Get a key from MineSkin. visibility is how the skins you make are listed on MineSkin: unlisted keeps them off its public gallery.

mineskin:
  api-key: ''
  visibility: unlisted

#Dialogue Use Dialogs

Shows dialogues as Paper dialog screens where the server has them. When off, every dialogue is sent in chat.

dialogue-use-dialogs: true

#Nameplate Engine

What draws NPC names and indicators. phoenixholograms hands them to PhoenixHolograms, so they can use its animations, text tokens and per-line conditions. Without PhoenixHolograms installed, built-in is used. Also changed from Editor > Settings.

nameplates:
  engine: phoenixholograms

#Messages & Translations

Every message the plugin sends lives in the translation file rather than in config.yml. See Languages & Translations.

Last updated about 2 hours ago