Commands - MarkusBordihn/BOs-Easy-NPC GitHub Wiki

Commands ๐Ÿ“œ

Most NPC settings can be changed through the UI, but Easy NPC also exposes server commands under /easy_npc.

Commands that target an NPC use the Easy NPC argument type. In practice this means you can use a supported target selector and usually get suggestions for nearby or targeted NPCs.

Config UI Commands ๐Ÿ› ๏ธ

These commands are available when the Config UI module is installed:

/easy_npc configure <NPC>
/easy_npc debug config <true|false>
/easy_npc preset_browser

configure opens the main configuration screen for the selected NPC.

Core Debug and Maintenance ๐Ÿงฐ

/easy_npc debug core <true|false>
/easy_npc delete <NPC>
/easy_npc despawn <NPC>
/easy_npc respawn <NPC>
/easy_npc reload <NPC>

delete removes the NPC permanently. despawn removes it from the world but keeps its saved data. respawn restores a saved NPC. reload refreshes the selected NPC from its current data.

Information Commands โ„น๏ธ

/easy_npc info <NPC>
/easy_npc list
/easy_npc list owner [player]
/easy_npc list type <entity_type>
/easy_npc list dimension <dimension>
/easy_npc list identifier <custom_identifier>
/easy_npc list namespace <namespace>
/easy_npc stats

info shows saved metadata for one NPC. list and stats work on the stored NPC index and are useful for administration.

Dialog Commands ๐Ÿ’ฌ

/easy_npc dialog open <NPC> <player>
/easy_npc dialog open <NPC> <player> <dialog_uuid_or_label>
/easy_npc dialog set priority <NPC> <dialog_uuid_or_label> <priority>
/easy_npc dialog close <player>

More details are documented on Dialogs.

Equipment, Name and Owner ๐Ÿ›ก๏ธ

/easy_npc equipment set <NPC> <slot> <item>
/easy_npc equipment remove <NPC> <slot>
/easy_npc name set <NPC> <name> [color] [visibility]
/easy_npc name color <NPC> <color>
/easy_npc name visibility <NPC> <visibility>
/easy_npc name clear <NPC>
/easy_npc owner set <NPC> <player>
/easy_npc owner get <NPC>
/easy_npc owner remove <NPC>

visibility uses the supported name visibility values from the command suggestions.

Navigation, Pose and Model Editing ๐ŸŽญ

/easy_npc navigation set home <NPC> <position>
/easy_npc navigation set pos <NPC> <position>
/easy_npc navigation reset <NPC>
/easy_npc pose reset <NPC>
/easy_npc pose set <pose_id> <NPC> [position]
/easy_npc rotate <NPC> <yaw>
/easy_npc rotate <NPC> <model_part> <x> <y> <z>
/easy_npc position <NPC> <model_part> <x> <y> <z>
/easy_npc scale <NPC> <model_part> <scale>
/easy_npc scale <NPC> <model_part> <x> <y> <z>

rotate, position, and scale work on model parts supported by the selected NPC model.

Objectives and Interaction ๐ŸŽฏ

/easy_npc objective list <NPC> ...
/easy_npc objective set <NPC> ...
/easy_npc objective remove <NPC> ...
/easy_npc interact block <NPC> <block_pos>

The exact subcommands for objectives depend on the objective type. See Objectives.

Presets ๐Ÿ—‚๏ธ

/easy_npc preset export local <NPC> [name]
/easy_npc preset export custom <NPC> [name]
/easy_npc preset export world <NPC> [name]
/easy_npc preset import custom <preset> [position] [uuid]
/easy_npc preset import data <preset> [position] [uuid]
/easy_npc preset import default <preset> [position] [uuid]
/easy_npc preset import world <preset> [position] [uuid]
/easy_npc preset import_new custom <preset> [position]
/easy_npc preset import_new data <preset> [position]
/easy_npc preset import_new default <preset> [position]
/easy_npc preset import_new world <preset> [position]
/easy_npc preset import_with_owner custom <preset> <player> <position>
/easy_npc preset import_with_owner data <preset> <player> <position>
/easy_npc preset import_with_owner default <preset> <player> <position>
/easy_npc preset import_with_owner world <preset> <player> <position>

/easy_npc preset import local is not supported on the server side. Local presets are handled through the client UI instead.

More details are documented on Preset.

Rendering and Skins ๐ŸŽจ

/easy_npc render set type <NPC> <render_type>
/easy_npc render set model <NPC> <entity_type>
/easy_npc skin set variant <NPC> <variant>
/easy_npc skin layer <NPC>
/easy_npc skin layer <NPC> enable
/easy_npc skin layer <NPC> disable

render set model changes the rendered entity model and is only supported for Doppler NPCs.

More details are documented on CustomModels and Skins.

Progression, Sound and Trading ๐Ÿ“ˆ

/easy_npc progression get <NPC>
/easy_npc progression set <NPC> level <level>
/easy_npc progression set <NPC> xp <xp>
/easy_npc progression add <NPC> xp <xp>
/easy_npc progression scaling <NPC> <true|false>
/easy_npc sound set <NPC> <sound_type> <resource_location>
/easy_npc trading open <NPC> [player]
/easy_npc trading reset <NPC>

More details are documented on Progression, Trading, and Dialogs.

Spawning and Spawners ๐ŸŒŸ

/easy_npc spawn <uuid>
/easy_npc spawn <uuid> <position>
/easy_npc spawner set <block_pos> <parameter> <value>

Supported spawner parameters are:

  • Delay
  • MinSpawnDelay
  • MaxSpawnDelay
  • SpawnCount
  • MaxNearbyEntities
  • RequiredPlayerRange
  • SpawnRange

Test Command ๐Ÿงช

/easy_npc test spawn raw_npc ...
/easy_npc test spawn standard_npc ...
/easy_npc test spawn custom_npc ...

This command is intended for development and testing.

โš ๏ธ **GitHub.com Fallback** โš ๏ธ