Skip to content

Commands

Jump to bottom
david edited this page Feb 6, 2025 · 2 revisions

This wiki provides detailed explanations for all available commands in Characters.
Use these commands to manage characters and customize their features, attributes, actions, and visual elements.

Character Management

Create a Character

/character create <name> [<type>]

Creates a new character with the specified name and entity type. If no entity type is defined, a player character will be created.

Parameters

  • <name>: Name of the new character.
  • [<type>]: Optional entity type.

Delete a Character

/character delete <character>

Permanently deletes a character.

List Characters

/character list

Displays a list of all existing characters.

Character Click Actions

Add a New Action

/character action add <character> <action> <click-type> <action-type> <values>

Add a new or edit an existing character click action (e.g., sending messages, playing sounds, or running commands). Actions are performend when a player interacts with a character by right or left click.

Parameters

  • <character>: The character this action is added to.
  • <action>: The name of the action.
  • <click-type>: The click type that invokes this action.
  • <action-type>: The type of action.
  • <values>: Specific values used for the action.

All available action types

  • connect: Connects the user to a different server (velocity/bungee-cord only)
  • play-sound: Plays a sound to the player
  • run-console-command: Runs a console command
  • run-command: Performs a command as the player
  • send-actionbar: Sends an actionbar to the player
  • send-entity-effect: Sends an entity effect for the character to the player
  • send-message: Sends a message to the player
  • teleport: Teleports the player to a specific location
  • send-title: Sends a title to the player
  • transfer: Transfers the user to a different server

Set Cooldown on Action

/character action cooldown <character> <action-name> <cooldown>

Sets a cooldown period for an action, determining how long a user has to wait until it can be used again. A cooldown of 0 will remove the cooldown.

Parameters

  • <character>: The target character.
  • <action-name>: Name of the action.
  • <cooldown>: Cooldown duration (in ticks if unit is omitted).

View Actions

/character action list <character>

Lists all existing actions assigned to a character.

Set Action Permission

/character action permission <character> <action-name> set <permission>

Assign a permission to an action, restricting it to players with the appropriate permission.

Parameters

  • <character>: The target character.
  • <action-name>: Name of the action.
  • <permission>: Permission to restrict access.

Remove Action Permission

/character action permission <character> <action-name> remove

Removes a permission from an action, allowing all players to use it.

Remove an Action

/character action remove <character> <action-name>

Deletes an existing action from a character.

Parameters

  • <character>: The target character.
  • <action-name>: Name of the action to remove.

Character Attributes

Set Attributes

/character attribute set <character> <attribute> <value>

Updates a character’s attributes, such as pose, freezing, burning, or invulnerability.

Parameters

  • <character>: The target character.
  • <attribute>: Attribute to modify.
  • <value>: New value for the specified attribute.

Character Equipment

Clear Equipment

/character equipment clear <character> [<slot>]

Clears a character’s equipped items or a specific equipment slot.

Parameters

  • <character>: The target character.
  • [<slot>]: Optional specific slot to clear (e.g., hand, offhand, or chest).

Set Equipment

/character equipment set <character> <slot> <item>

Assigns an item to a specific equipment slot.

Parameters

  • <character>: The target character.
  • <slot>: Target equipment slot.
  • <item>: Item to equip.

Character Skin Management

Hide or Show Skin Layers

/character skin layer hide <skin-layer> <character>
/character skin layer show <skin-layer> <character>

Toggles visibility for specific skin layers such as cape, sleeves, etc. Only applies to characters of type player.

Parameters

  • <skin-layer>: The layer to modify.
  • <character>: Target player character.

All available skin layers

  • cape
  • hat
  • jacket
  • left_pants_leg
  • left_sleeve
  • right_pants_leg
  • right_sleeve

Reset Skin

/character skin reset <character>

Resets a player character’s skin to its default.

Set Skin from File

/character skin set <character> file <path> [slim]

Assigns a skin to a player character using a file from the server’s local file system.

Parameters

  • <path>: Path to the skin file.
  • [slim]: Optional slim skin format (reduces arm width).

Set Skin from Player

/character skin set <character> player <name>

Uses the skin of a specific player for the character.

Parameters

  • <name>: Player whose skin will be used.

Set Skin from URL

/character skin set <character> url <url> [slim]

Assigns a skin from an external URL.

Parameters

  • <url>: URL to the skin image.
  • [slim]: Optional slim skin format.

Character Name Tags

Customize Name-Tag Properties

/character tag set <character> <property> <value>

Customizes various properties of a character’s name-tag.

All available properties

  • alignment: Alignment of the name-tag text (left, right, or center).
  • background-color: Background color in ARGB or named color.
  • billboard: Axes on which the name-tag pivots (fixed, vertical, horizontal, or center).
  • brightness: Light levels for name-tag (block- and sky-light: 0-15).
  • default-background: Enables/disables the default background.
  • line-width: Maximum character width for text.
  • scale: Name-tag scale (0.05x to 10x).
  • see-through: Toggles see-through text feature.
  • text: Custom formatted text for the name-tag.
  • text-opacity: Text opacity percentage (0-100).
  • text-shadow: Enables or disables shadow for text.
  • visible: Toggles visibility of the name-tag.

Reset Name-Tag Properties

/character tag reset <character> <property>

Reset properties of a character's name-tag.

Teleportation

Teleport Character to Entity

/character teleport <character> <entity>

Teleports a character to another entity.

Parameters

  • <character>: The target character.
  • <entity>: Entity to teleport to.

Teleport to Character

/character teleport <character>

Teleports yourself to a specific character.

Teleport to Position

/character teleport <character> <position>

Teleports a character to a specific position.

Parameters

  • <position>: Target coordinates.

View Permissions

Set View Permission

/character view-permission set <character> <permission>

Assigns a permission to control visibility of the character. If a player lacks this permission they will not be able to see or interact with this character.

Parameters

  • <permission>: Permission string.

Remove View Permission

/character view-permission remove <character>

Removes the permission, making the character visible to everyone.

Clone this wiki locally