# Edit NPC

> **Info:**
Every option on this page is saved to the NPC's own file in the npcs folder, and the NPC updates for everyone straight away.

| Left | Middle | Right |
| --- | --- | --- |
| Display, Entity or Model | Click Actions | Appearance, Tools |
| Identifier, Name Hologram | Dialogue | Movement, Visibility |

Enabled, Group, Clone and Delete are on the bottom bar.

## Display Name

A plain label for the NPC in the editor, the NPC list, `/pnpc info` and messages. It is not shown above the NPC: link a [name hologram](../../features/nameplate-and-indicator.md#name-hologram) for that. The Display screen also sets the icon the NPC has in lists.

<figure><img src="../../.gitbook/assets/npcs/display-name.png" alt="" width="563"><figcaption><p>Display (Display Name)</p></figcaption></figure>

## Entity Type

What the NPC looks like: a player, a mannequin, any living mob, an armor stand or an interaction box. Changing it keeps every other setting. Right-Click the button to open the Entity screen, which also holds the skin, Show In Tab and the mob properties. Left-Click swaps between an entity and a model. See [Entity Types](../appearance.md#entity-types).

<figure><img src="../../.gitbook/assets/npcs/entity-type.png" alt="" width="563"><figcaption><p>Entity (Entity Type)</p></figcaption></figure>

## Skin

The skin of a player or mannequin NPC, its layers and cape, and a head with the skin. See [Skins](../skins.md).

<figure><img src="../../.gitbook/assets/npcs/skin.png" alt="" width="563"><figcaption><p>Entity (Skin)</p></figcaption></figure>

## Model

The model engine, the model and its idle and click animations, opened with Right-Click while a model engine is picked. A model is shown instead of the entity. See [Models](../models.md).

<figure><img src="../../.gitbook/assets/model/model-engine.png" alt="" width="563"><figcaption><p>Edit NPC (Model)</p></figcaption></figure>

## Identifier

The id of the NPC, which names its file. Renaming keeps the NPC, its settings and its name hologram link. Other plugins that use the old id, such as BetonQuest or Quests, need the new one. See [NPC Ids](../../plugin-information/commands.md#npc-ids).

<figure><img src="../../.gitbook/assets/npcs/identifier.png" alt="" width="563"><figcaption><p>Edit NPC (Identifier)</p></figcaption></figure>

## Name Hologram

Links a PhoenixHolograms hologram as the name above the NPC. See [Nameplate & Indicator](../../features/nameplate-and-indicator.md#name-hologram). Without PhoenixHolograms the button shows an error and opens nothing.

<figure><img src="../../.gitbook/assets/nameplate/name-hologram.png" alt="" width="563"><figcaption><p>Edit NPC (Name Hologram)</p></figcaption></figure>

## Click Actions

Everything a player sets off by clicking the NPC or walking up to it.

<figure><img src="../../.gitbook/assets/click-actions/click-actions.png" alt="" width="563"><figcaption><p>Edit NPC (Click Actions)</p></figcaption></figure>

### Clicks

What a left click, a right click and any click do, and the click cooldown. See [Click Actions](../click-actions.md).

<figure><img src="../../.gitbook/assets/click-actions/clicks.png" alt="" width="563"><figcaption><p>Click Actions (Clicks)</p></figcaption></figure>

Each button opens the list of its actions. Add Action picks a new one, Left-Click replaces an action, Shift + Left-Click sets its flags and Right-Click removes it.

### Test

Runs the left-click actions on you with Left-Click, or the right-click actions with Right-Click, and says whether they ran to the end. Costs and rewards are real. The same as `/pnpc test`.

<figure><img src="../../.gitbook/assets/click-actions/test.png" alt="" width="563"><figcaption><p>Click Actions (Test)</p></figcaption></figure>

### Action Order

For each action list, whether every action runs, one is picked at random, or one runs after another on each click.

<figure><img src="../../.gitbook/assets/click-actions/action-order.png" alt="" width="563"><figcaption><p>Click Actions (Action Order)</p></figcaption></figure>

### More Triggers

Actions that run when a player changes world or dies near the NPC.

<figure><img src="../../.gitbook/assets/click-actions/more-triggers.png" alt="" width="563"><figcaption><p>Click Actions (More Triggers)</p></figcaption></figure>

### Click Cooldown

How many seconds a player waits between clicks on this NPC. A click during the cooldown does nothing and tells the player how long is left. -1 uses the [default](../../configurations/main-configuration.md#click-cooldown).

<figure><img src="../../.gitbook/assets/click-actions/click-cooldown.png" alt="" width="563"><figcaption><p>Clicks (Click Cooldown)</p></figcaption></figure>

### Block While Running

Ignores a player's clicks while the actions of their last click are still running, such as a list with a `[DELAY]`. Stops players from starting the same chain twice.

<figure><img src="../../.gitbook/assets/click-actions/block-while-running.png" alt="" width="563"><figcaption><p>Clicks (Block While Running)</p></figcaption></figure>

### Training Dummy

Turns the NPC into a training dummy. Every hit shows the damage it would have dealt above the NPC, with the NPC's hurt sound and hurt animation. The number counts the weapon, Sharpness, the attack cooldown and critical hits. The NPC takes no damage and its left-click actions still run. Fast clicking never shows the click cooldown message on a training dummy. The number needs PhoenixHolograms with its damage indicators on; without it the sound and animation still play.

<figure><img src="../../.gitbook/assets/click-actions/training-dummy.png" alt="" width="563"><figcaption><p>Clicks (Training Dummy)</p></figcaption></figure>

### Proximity Actions

Actions that run when a player walks up to the NPC, with their radius and cooldown. See [Proximity Actions](../proximity-actions.md).

<figure><img src="../../.gitbook/assets/click-actions/proximity-actions.png" alt="" width="563"><figcaption><p>Click Actions (Proximity)</p></figcaption></figure>

### Cooldowns & Limits

A cooldown shared by every player, and how many times the NPC can be used. See [Cooldowns & Limits](../cooldowns-and-limits.md).

<figure><img src="../../.gitbook/assets/click-actions/cooldowns-and-limits.png" alt="" width="563"><figcaption><p>Click Actions (Cooldowns & Limits)</p></figcaption></figure>

### Sounds

The NPC's own sounds. See [Sounds](../../features/sounds.md).

<figure><img src="../../.gitbook/assets/click-actions/sounds.png" alt="" width="563"><figcaption><p>Click Actions (Sounds)</p></figcaption></figure>

### Trades

A vanilla villager trade window for the NPC, opened by a right click once Open On Right-Click is on. Each trade takes up to two items and gives one. For a shop with prices and categories, use the [PhoenixShop action](../../plugin-information/action-types.md#phoenixshop).

<figure><img src="../../.gitbook/assets/click-actions/trades.png" alt="" width="563"><figcaption><p>Click Actions (Trades)</p></figcaption></figure>

## Dialogue

A conversation with choices. See [Dialogues](../../features/dialogues.md).

<figure><img src="../../.gitbook/assets/dialogue/dialogue.png" alt="" width="563"><figcaption><p>Edit NPC (Dialogue)</p></figcaption></figure>

## Appearance

How the NPC looks and how it reacts to players near it.

<figure><img src="../../.gitbook/assets/appearance/appearance.png" alt="" width="563"><figcaption><p>Edit NPC (Appearance)</p></figcaption></figure>

### Pose

How the NPC stands: standing, crouching, sleeping, swimming or sitting. See [Sitting](../appearance.md#sitting).

<figure><img src="../../.gitbook/assets/appearance/pose.png" alt="" width="563"><figcaption><p>Appearance (Pose)</p></figcaption></figure>

### Scale

Makes the NPC bigger or smaller, from 0.1 to 10. The name hologram moves with it.

<figure><img src="../../.gitbook/assets/appearance/scale.png" alt="" width="563"><figcaption><p>Appearance (Scale)</p></figcaption></figure>

### Glow

Turns the outline seen through walls on or off. Opens a menu with a button for each color.

<figure><img src="../../.gitbook/assets/appearance/glowing.png" alt="" width="563"><figcaption><p>Appearance (Glow)</p></figcaption></figure>

### Equipment

The items the NPC holds and wears. Only shown while the NPC is an entity, not a model. See [Equipment](../equipment.md).

<figure><img src="../../.gitbook/assets/appearance/equipment.png" alt="" width="563"><figcaption><p>Appearance (Equipment)</p></figcaption></figure>

### Emote

A gesture the NPC makes on a timer or when a player comes close. See [Emotes](../../features/emotes.md).

<figure><img src="../../.gitbook/assets/appearance/emote.png" alt="" width="563"><figcaption><p>Appearance (Emotes)</p></figcaption></figure>

### Look

Where the NPC looks: at players, only at players who can see it, at another NPC or around at random. See [Looking](../../features/looking.md).

<figure><img src="../../.gitbook/assets/appearance/look.png" alt="" width="563"><figcaption><p>Appearance (Looking)</p></figcaption></figure>

### Collision

Lets players bump into the NPC, pushes them gently away when they walk into it, and sets the size of the NPC's clickable box. See [Hitbox](../appearance.md#hitbox).

<figure><img src="../../.gitbook/assets/appearance/collision.png" alt="" width="563"><figcaption><p>Appearance (Collision)</p></figcaption></figure>

### Rules

Another skin, glow color or equipment for the players who pass a condition. See [Per-Player Looks](../appearance.md#per-player-looks).

<figure><img src="../../.gitbook/assets/appearance/rules.png" alt="" width="563"><figcaption><p>Appearance (Per-Player Looks)</p></figcaption></figure>

### Nameplate

The height of the name hologram, the symbol above it and show on hover. See [Nameplate & Indicator](../../features/nameplate-and-indicator.md).

<figure><img src="../../.gitbook/assets/appearance/nameplate.png" alt="" width="563"><figcaption><p>Appearance (Nameplate)</p></figcaption></figure>

### Show In Tab

Lists a player NPC in the tab list, under the first line of its name. When off, the NPC still joins the tab list for a moment so its skin can load, see [Tab Remove Delay](../../configurations/main-configuration.md#tab-remove-delay). Sits on the Entity screen.

<figure><img src="../../.gitbook/assets/appearance/show-in-tab.png" alt="" width="563"><figcaption><p>Entity (Show In Tab)</p></figcaption></figure>

### Pushback

Pushes players gently away when they walk into or onto the NPC. Default follows the [pushback](../../configurations/main-configuration.md#pushback) setting in config.yml.

<figure><img src="../../.gitbook/assets/appearance/pushback.png" alt="" width="563"><figcaption><p>Collision (Pushback)</p></figcaption></figure>

## Movement

Mode, speed, waypoints, wander, pause, follow, mount and guard, and a button that sends the NPC home. See [Movement](../../features/movement.md).

<figure><img src="../../.gitbook/assets/movement/movement.png" alt="" width="563"><figcaption><p>Edit NPC (Movement)</p></figcaption></figure>

## Visibility

Who sees the NPC, from how far and on which servers.

<figure><img src="../../.gitbook/assets/visibility/visibility.png" alt="" width="563"><figcaption><p>Edit NPC (Visibility)</p></figcaption></figure>

### Visibility Distance

How many blocks away players can see the NPC, up to 256. -1 uses the [default](../../configurations/main-configuration.md#visibility-distance). A lower value means fewer packets sent to players who are far away.

<figure><img src="../../.gitbook/assets/visibility/visibility-distance.png" alt="" width="563"><figcaption><p>Visibility (Visibility Distance)</p></figcaption></figure>

### Visibility Permission

Shows the NPC only to players with this permission. Players without it cannot see or click it. Leave it empty for everyone.

<figure><img src="../../.gitbook/assets/visibility/visibility-permission.png" alt="" width="563"><figcaption><p>Visibility (Visibility Permission)</p></figcaption></figure>

### Show Conditions

Conditions a player has to pass to see the NPC. See [Visibility](../../features/visibility.md#show-conditions).

<figure><img src="../../.gitbook/assets/visibility/show-conditions.png" alt="" width="563"><figcaption><p>Visibility (Show Conditions)</p></figcaption></figure>

### Hidden Players

Players the NPC is hidden from. See [Visibility](../../features/visibility.md#hiding-from-a-player).

<figure><img src="../../.gitbook/assets/visibility/hidden-players.png" alt="" width="563"><figcaption><p>Visibility (Hidden Players)</p></figcaption></figure>

### Check a Player

Type a player's name to see why they can or cannot see the NPC. See [Visibility](../../features/visibility.md#debugging).

<figure><img src="../../.gitbook/assets/visibility/check-a-player.png" alt="" width="563"><figcaption><p>Visibility (Check a Player)</p></figcaption></figure>

### Servers

On a network that shares NPCs, the servers that show this NPC. With none listed, every server shows it. See [Storage](../../configurations/main-configuration.md#storage).

<figure><img src="../../.gitbook/assets/visibility/servers.png" alt="" width="563"><figcaption><p>Visibility (Servers)</p></figcaption></figure>

## Enabled

A disabled NPC keeps its settings but is hidden and cannot be clicked.

<figure><img src="../../.gitbook/assets/npcs/enabled.png" alt="" width="563"><figcaption><p>Edit NPC (Enabled)</p></figcaption></figure>

## Group

Puts the NPC in a group, or takes it out. An NPC is in one group at a time. See [Groups](../../features/groups.md).

<figure><img src="../../.gitbook/assets/npcs/group.png" alt="" width="563"><figcaption><p>Edit NPC (Group)</p></figcaption></figure>

## Clone

Makes a copy of the NPC where you stand, with a new id, and opens its editor. The same as `/pnpc clone`.

<figure><img src="../../.gitbook/assets/npcs/clone.png" alt="" width="563"><figcaption><p>Edit NPC (Clone NPC)</p></figcaption></figure>

## Delete

Deletes the NPC and its file, after a confirmation. A linked name hologram is unlinked and kept.

<figure><img src="../../.gitbook/assets/npcs/delete.png" alt="" width="563"><figcaption><p>Edit NPC (Delete NPC)</p></figcaption></figure>

> **Danger:**
This option is permanent, and NPCs can't be restored from the editor. `/pnpc undo` brings back one you deleted, see [Groups](../../features/groups.md#undo).

## Tools

The anvil in the top row.

<figure><img src="../../.gitbook/assets/npcs/tools.png" alt="" width="563"><figcaption><p>Edit NPC (Tools)</p></figcaption></figure>

| Tool | Does |
| ---- | ---- |
| Move Here | Moves the NPC to where you stand, facing the way you face. |
| Center | Moves the NPC to the middle of its block. |
| Face Me | Turns the NPC toward you. |
| Teleport to NPC | Teleports you to the NPC. |
| Refresh | Spawns the NPC again for everyone who sees it. |

Source: https://www.phoenixplugins.com/docs/phoenix-npcs/main-features/npcs/edit-npc