Geyser Sanitizer

Minecraft 版本： 1.21.11

平台： paper spigot

标签： library utility

Description

GeyserSanitizer is a Spigot/Paper plugin designed to sanitize text components sent to Bedrock players, preventing client crashes or display issues that can arise from certain unsupported text features. It specifically targets and modifies chat messages, system messages, and team-related text (nametags, prefixes, suffixes) to ensure compatibility with Bedrock clients connected via GeyserMC/Floodgate.

Features

• Chat Message Sanitization: Intercepts and sanitizes outgoing chat messages.
• System Message Sanitization: Intercepts and sanitizes outgoing system messages.
• Team Text Sanitization: Cleans nametags, prefixes, and suffixes sent as part of team updates.
• Bedrock Player Detection: Utilizes Floodgate API to selectively apply sanitization only to Bedrock players.
• Icon/Head Icon Removal: Removes JSON components containing 'atlas', 'sprite', 'hat', or 'player' keys, which are known to cause issues on Bedrock clients.

Dependencies

This plugin requires the following to function correctly:

• PacketEvents: Used for intercepting and modifying network packets.
• Floodgate: Used to identify Bedrock players.

How It Works

The plugin registers a PacketInterceptor listener with PacketEvents. When a server sends certain packets (CHAT_MESSAGE, SYSTEM_CHAT_MESSAGE, TEAMS), the interceptor checks if the recipient is a Bedrock player (using Floodgate). If so, it sanitizes the net.kyori.adventure.text.Component messages by removing JSON structures that contain problematic keys (like "atlas", "sprite", "hat", "player") before the packet is sent to the client. This prevents unsupported features from reaching the Bedrock client and causing issues.