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 debug npc <NPC>
/easy_npc delete <NPC>
/easy_npc despawn <NPC>
/easy_npc respawn <NPC>
/easy_npc reload <NPC>

debug npc dumps the current server-side state for one NPC and is useful for troubleshooting name, skin, and scaling sync issues. 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 render set species <NPC> <species_id>
/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. render set species is only supported for Cobblemon 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** โš ๏ธ