AstralCore Actions

AstralChat registers five action types into AstralCore's global action registry on startup. They become usable in any menu, dialog, or filter actions: list across every plugin on the server.

`equip-chat-tag`

Equip a chat tag for the actor. Argument: a tag id resolved through the tag placeholder.

- "[equip-chat-tag] lumberjack"
- "[equip-chat-tag] %tag_id%"     # typical use inside a tag layout

On success the player sees tag-equipped with %tag% substituted. Unknown ids trigger tag-not-found.

`unequip-chat-tag`

Clear the actor's equipped tag. No arguments.

- "[unequip-chat-tag]"

Sends tag-unequipped.

`toggle-paid-roles`

Toggle whether the actor's paid LuckPerms prefix is shown by %chat_prefix%. Useful for players who hold multiple ranks and want the staff prefix without the cosmetic paid one. No arguments.

- "[toggle-paid-roles]"

Sends paid-roles-enabled/paid-roles-disabled.

`toggle-chat-mentions`

Toggle the actor's mention notifications (sound + title). No arguments.

- "[toggle-chat-mentions]"

Sends mentions-enabled/mentions-disabled. See Mentions.

`unignore-player`

Remove an entry from the actor's ignore list by UUID. Argument: a UUID, typically resolved through a placeholder when iterating an ignore-list menu.

- "[unignore-player] %parameters_target_uuid%"

This bypasses the /unignore command and is the recommended hook for menu-driven ignore-list management.

items:
  toggle-pms:
    slot: 11
    item-stack:
      material: ENDER_PEARL
      name: "Private messages: %chat_privateMessagesEnabled%"
    actions:
      LEFT:
        - "[player] togglepm"

  toggle-mentions:
    slot: 13
    item-stack:
      material: BELL
      name: "Mentions: %chat_mentionsEnabled%"
    actions:
      LEFT:
        - "[toggle-chat-mentions]"

  toggle-paid:
    slot: 15
    item-stack:
      material: GOLD_INGOT
      name: "Show paid rank: %chat_showPaidRoles%"
    actions:
      LEFT:
        - "[toggle-paid-roles]"

Last modified: 25 July 2026

Astral Realms Documentation Help