Messages

This file controls all the text that CatzFly sends to players. From simple permission errors to dynamic action bar displays, every message is fully customizable here.

Message Structure

Each message in this file follows a simple structure. You can enable or disable any message, define how it's displayed, and set the text content.

message-id:
  enabled: true
  type: CHAT
  text: "Your message here with {placeholders}."

• enabled: Set to true or false. If false, this message will never be sent.

• type: Determines how the message is displayed to the player.

• text: The content of the message. It supports color codes (& and &#RRGGBB) and placeholders.

Display Types (type)

You can choose from several modern display methods for your messages:

Type	Description
CHAT	The standard method. Sends the message directly into the player's chat box.
ACTIONBAR	Displays the message on the player's action bar (the small text line above the hotbar). Ideal for brief, non-intrusive notifications.
TITLE	Shows the message as a large title and a smaller subtitle in the center of the screen. Great for important warnings or notifications.
BOSSBAR	Creates a temporary boss bar at the top of the screen to display the message.

Placeholders

Placeholders are special keywords enclosed in curly braces {} that are automatically replaced with dynamic information when a message is sent.

Common Placeholders:

• {player}: The name of the player.

• {world}: The name of the world the player is in.

• {permission}: The permission node the player is missing.

• {seconds}: An amount of time in seconds (used in givetime, settime commands).

• {cooldown_seconds}: The remaining flight cooldown time.

• {currency-symbol}: The currency symbol defined in config.yml.

Action Bar Formats

The action-bar section is special. It defines the text that is continuously displayed on the player's action bar while they are flying.

• format-free: The format used when the player is flying with free flight time. Uses the {free_flight_seconds} placeholder.

• format-paid: The format used when the player is paying with money. Uses {time} (total seconds in current flight session) and {cost} (total cost of current session) placeholders.

• format-cooldown: The format used when the player is on a flight cooldown. Uses the {cooldown_seconds} placeholder.