Command Actions

Trigger server or player commands when a citizen is interacted with. Supports delays, placeholders, and a special message-sending shorthand.

Opening the Command Editor

From the Edit Citizen screen, click Edit Commands in the Quick Actions section. This opens the Command Actions list for that citizen.

The list shows each configured command with a color-coded icon indicating whether it runs as the server (purple) or as the player (blue). Click Add Command to create a new one, or use the Edit and Delete buttons on each entry.

Adding / Editing a Command

Clicking Add Command (or Edit on an existing command) opens the command editor with four settings:

Command

Enter the command to execute. Do not include a leading / — HyCitizens adds it automatically. You can use the placeholders {PlayerName} and {CitizenName} anywhere in the command text.

give {PlayerName} Rock_Gem_Diamond 1
teleport {PlayerName} 100 64 200
xp add {PlayerName} 50

Interaction Trigger

Which player action fires this command:

Delay (seconds)

How long to wait before executing this command after the interaction. Set to 0 for immediate execution. You can use delays to sequence multiple commands (see Run Order & Sequences below).

Run as Server

When checked, the command is executed by the server console with elevated privileges. When unchecked, the command runs as the player with their own permissions.

• Use Run as Server = on for admin commands like giving items, teleporting, awarding XP.
• Use Run as Server = off when the player needs to execute the command with their own permissions.

Click Add Command (or Save Changes) to save, then click Done on the command list to apply all changes to the citizen.

Placeholders in Commands

The following placeholders are automatically replaced in the command string. They are not case sensitive.

Special: {SendMessage} Prefix

If a command starts with {SendMessage}, HyCitizens will send the rest of the text as a formatted chat message to the player instead of running it as a server command. This supports the same color tags and placeholders as regular messages.

{SendMessage}{GOLD}You have discovered a secret, {PlayerName}!

This is useful when you want to send a styled chat message via the command system rather than the Messages editor — for example, as part of a timed sequence.

Run Order & Sequences

Multiple commands on the same citizen execute in list order. Use individual delays to create scripted sequences:

Command 1: {SendMessage}{WHITE}Prepare yourself...
  Run as Server: false | Delay: 0.0s

Command 2: {SendMessage}{RED}You have entered a restricted zone!
  Run as Server: false | Delay: 2.0s

Command 3: warp PvPArena {PlayerName}
  Run as Server: true  | Delay: 3.0s