Messages

This file controls all the custom messages sent by CatzUtils. You can customize the text, appearance, and format of every message to fit your server's style.

Message Structure

Each message in the file is identified by a unique key (e.g., inventory-full). Under each key, you can configure how the message is delivered.

Example:

inventory-full:
  # Set to false to disable this message from being sent.
  enabled: true
  # The display format (CHAT, ACTION_BAR, or TITLE).
  type: CHAT
  # The text content of the message. Supports color codes and placeholders.
  text: "&cYour inventory is full! The reward was dropped on the ground."

Key Explanations

Key	Description
enabled	A simple true or false toggle. If set to false, the message will not be sent.
type	Determines how the message is displayed to the player. See the available types below.
text	The content of the message. This supports standard & color codes and placeholders.

Display Types (type)

You can choose from several different ways to display your messages.

Type	Description
CHAT	The default type. Sends the message directly into the player's chat, prefixed with the text from config.yml.
ACTION_BAR	Displays the message on the player's action bar (the text line above the hotbar).
TITLE	Shows the message in the center of the screen. Use a pipe character `

Placeholders

All messages support placeholders to display dynamic, in-game information. Below is a complete list of placeholders available in the plugin.

Placeholder	Description	Context / Example Usage
%player%	The name of the relevant player.	Used almost everywhere. Note: In PvP rewards, this refers to the player who was killed.
%killer%	The name of the player who got a kill.	PvP kill rewards (player-kill-reward).
%mob%	The name of the mob that was killed.	Mob kill rewards (mob-kill-reward).
%block%	The name of the block that was broken.	Block break rewards (block-break-reward).
%caught_item%	The name of the item caught while fishing.	Fishing rewards (fishing-reward).
%item%	The display name of an item being given as a reward.	Item reward messages (item-reward).
%amount%	The quantity of an item or the amount of money being rewarded.	Item and money reward messages (item-reward, money-reward).
%world%	The name of the world where an event occurred.	Block breaking and mob kill rewards.
%x%, %y%, %z%	The coordinates of where an event occurred (e.g., a block breaking).	Block breaking and mob kill rewards.
%version%	The current version of the CatzUtils plugin.	System messages (plugin-info).
%reason%	The reason a mob was ignored (e.g., SPAWNER).	Ignored mob kill messages (ignored-mob-kill).