Title Prefix Handler

A lightweight MCDReforged handler designed to fix player name parsing when the DCSTitleManager plugin applies title prefixes via Minecraft Team prefixes.

Why use this handler

DCSTitleManager adds title prefixes to player names by modifying Team prefixes. In some handler configurations, this can cause player names to be mis-parsed when chat messages contain multiple bracketed prefixes.

This handler removes the extra title prefix from the raw server output before MCDR parses the player name, allowing the title manager plugin to work correctly without breaking chat parsing.

Features

• Removes the third title prefix segment from server output
• Preserves the actual player name and chat content
• Compatible with MCDReforged >= 2.14.0
• Minimal, single-file handler implementation

Installation

1. Download the handler package and place it in your MCDR plugin directory.
2. Ensure mcdreforged is installed in your Python environment.
3. Enable the handler in the MCDR configuration.

Usage

Add the handler to your MCDR configuration and enable it before loading DCSTitleManager.

import re
from mcdreforged.handler.impl import VanillaHandler

PLUGIN_METADATA = {
    'id': 'title_prefix_handler',
    'version': '1.0.0',
}

class TitlePrefixHandler(VanillaHandler):
    def get_name(self) -> str:
        return 'title_prefix_handler'

    def pre_parse_server_stdout(self, text: str):
        text = super().pre_parse_server_stdout(text)
        text = re.sub(
            r'^(.*?\[[^]]+\].*?\[[^]]+\].*?)\[[^]]+\]\s+',
            r'\1',
            text
        )
        return text

    def parse_server_stdout(self, text: str):
        info = super().parse_server_stdout(text)
        if info.player is None:
            m = re.fullmatch(r'<\[[^]]+](?P<name>[^>]+)> (?P<message>.*)', info.content)
            if m is not None:
                name = m['name'].strip()
                if self._verify_player_name(name):
                    info.player, info.content = name, m['message']
        return info


def on_load(server, prev_module):
    server.register_server_handler(TitlePrefixHandler())

Notes

• Use this handler together with DCSTitleManager.
• Clear existing Minecraft Team state before enabling the handler to avoid prefix conflicts.

License

This project is released under the GPL-3.0 License.