From 8c6643e6581f80b9688e1e4c62a99593ba79faae Mon Sep 17 00:00:00 2001
From: Xujiayao <i@xujiayao.com>
Date: Fri, 20 Mar 2026 10:42:40 +0800
Subject: [PATCH] [skip ci] Enhance configuration for Minecraft message
 handling with detailed comments and explanation

---
 .../src/main/resources/config/config_single_server.yml |  8 +++++++-
 core/src/main/resources/config/config_standalone.yml   | 10 ++++++++--
 .../main/resources/config/custom_messages/zh_cn.yml    |  2 ++
 3 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/core/src/main/resources/config/config_single_server.yml b/core/src/main/resources/config/config_single_server.yml
index 19b4d460..01f666bc 100644
--- a/core/src/main/resources/config/config_single_server.yml
+++ b/core/src/main/resources/config/config_single_server.yml
@@ -82,13 +82,19 @@ message_parsing:
     # unicode_emojis: true
     # hyperlinks: true
     # timestamps: true
-  minecraft_to_minecraft:
+  minecraft_to_minecraft: # For overwrite_minecraft_source_messages only
     markdown: true
     unicode_emojis: true
     custom_emojis: true
     mentions: true
     hyperlinks: true
     timestamps: true
+  # Once enabled, ci.cancel() [PlayerChat, SourceSay, SourceTellRaw, SourceMsg, SourceMe]
+  # to prevent the original message from being processed by Minecraft, and instead broadcast
+  # the parsed message back (including the sender's own client).
+  # ---
+  # So, enabling this = enabling [player.chat, source.say, source.tell_raw, source.msg, source.me]
+  # for the source DMCC client.
   overwrite_minecraft_source_messages: false
 
 # 命令过滤设置
diff --git a/core/src/main/resources/config/config_standalone.yml b/core/src/main/resources/config/config_standalone.yml
index 79f7a8d8..bc2827a0 100644
--- a/core/src/main/resources/config/config_standalone.yml
+++ b/core/src/main/resources/config/config_standalone.yml
@@ -75,7 +75,7 @@ broadcasts:
       tell_raw: "in-game-chat"
       msg: "in-game-chat" # msg / tell / w
       me: "in-game-chat"
-  minecraft_to_minecraft:
+  minecraft_to_minecraft: # For other_dmcc_clients only
     server:
       started: true
       stopped: true
@@ -116,13 +116,19 @@ message_parsing:
     # unicode_emojis: true
     # hyperlinks: true
     # timestamps: true
-  minecraft_to_minecraft:
+  minecraft_to_minecraft: # For other_dmcc_clients & overwrite_minecraft_source_messages
     markdown: true
     unicode_emojis: true
     custom_emojis: true
     mentions: true
     hyperlinks: true
     timestamps: true
+  # Once enabled, ci.cancel() [PlayerChat, SourceSay, SourceTellRaw, SourceMsg, SourceMe]
+  # to prevent the original message from being processed by Minecraft, and instead broadcast
+  # the parsed message back (including the sender's own client).
+  # ---
+  # So, enabling this = enabling [player.chat, source.say, source.tell_raw, source.msg, source.me]
+  # for the source DMCC client.
   overwrite_minecraft_source_messages: false
 
 # 命令过滤设置
diff --git a/core/src/main/resources/config/custom_messages/zh_cn.yml b/core/src/main/resources/config/custom_messages/zh_cn.yml
index ce10d712..3edcf6ea 100644
--- a/core/src/main/resources/config/custom_messages/zh_cn.yml
+++ b/core/src/main/resources/config/custom_messages/zh_cn.yml
@@ -116,6 +116,7 @@ discord_to_minecraft:
       bold: false
       color: "gray"
 
+# These are for system_messages
 minecraft_to_xxxxx:
   server:
     start: ":white_check_mark: **服务器已启动！**"
@@ -132,6 +133,7 @@ minecraft_to_xxxxx:
   source:
     me: ":eyes: **{display_name} {action}**"
 
+# These are for user_messages
 minecraft_to_discord:
   user_message:
     enabled_fake_user_style: