SystemChatListener

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/xMrAfonso/Runway/llms.txt

Use this file to discover all available pages before exploring further.

​

Packet Type

​

Configuration

listeners:
  system-messages: true

​

Class Structure

public class SystemChatListener extends AbstractListener {
    private final MiniMessage mm = MiniMessage.miniMessage();

    public SystemChatListener(ProcessHandler processHandler, ConfigManager configManager) {
        super(processHandler, configManager);
    }

    @Override
    public void onPacketPlaySend(PacketPlaySendEvent e) {
        // Implementation
    }
}

​

Implementation Details

​

1. Packet Type Validation

if (!config.getOrDefault("listeners.system-messages", true) ||
    e.getPacketType() != PacketType.Play.Server.SYSTEM_CHAT_MESSAGE) return;

• The listener is disabled in the configuration
• The packet type doesn’t match SYSTEM_CHAT_MESSAGE

​

2. Message Extraction

Player player = e.getPlayer();
WrapperPlayServerSystemChatMessage packet = new WrapperPlayServerSystemChatMessage(e);
String message = mm.serialize(packet.getMessage());

​

3. Message Filtering

if (message.startsWith("<lang:multiplayer.message_not_delivered:")) {
    e.setCancelled(true);
    return;
}

​

4. Action Bar Handling

if (message.contains("[actionbar]")) {
    message = message.replace("[actionbar]", "");
    e.setCancelled(true);
    player.sendActionBar(handler.processComponent(message, player));
}

1. Stripped of the tag
2. Cancelled from appearing in chat
3. Redirected to the action bar with formatting applied

​

5. Standard Message Processing

else {
    packet.setMessage(handler.processComponent(message, player));
}

• Resolves PlaceholderAPI placeholders
• Resolves MiniPlaceholders
• Parses MiniMessage formatting
• Returns a formatted Adventure Component

​

Usage Example

player.sendMessage("<gradient:red:blue>Welcome %player_name%!</gradient> [actionbar]");

1. Detects the [actionbar] tag
2. Removes the tag from the message
3. Processes placeholders: %player_name% → Steve
4. Applies MiniMessage gradient formatting
5. Sends the result to the action bar instead of chat

​

Dependencies

• PacketEvents: For packet interception
• WrapperPlayServerSystemChatMessage: Packet wrapper for reading/modifying system chat
• MiniMessage: For serializing Adventure components to strings
• ProcessHandler: For placeholder resolution and formatting

​

Related Components

• ProcessHandler - Handles text processing
• ConfigManager - Manages listener configuration