format

README.md

@@ -142,7 +142,8 @@ DMCC 在 Client 端提供独立的 `whitelist` 代理命令（默认所需权限
 当 DMCC 处于 `standalone + multi_server_client` 架构时，不同子服务器可使用不同 OP 映射策略。
 
 在 `standalone` 配置的 `user_mappings` 与 `role_mappings` 中，每个条目包含一个顶层 `op_level`（给 Standalone 自身查询使用），以及一个
-`server_overrides` 列表字典。若 `server_overrides` 中没有某子服务器的对应条目，则该子服务器自动降级使用顶层 `op_level` 作为默认回退值。
+`server_overrides` 列表字典。若 `server_overrides` 中没有某子服务器的对应条目，则该子服务器自动降级使用顶层 `op_level`
+作为默认回退值。
 
 ## 7. 命令列表与权限参考
 

core/src/main/java/com/xujiayao/discord_mc_chat/network/packets/events/DiscordEventPacket.java

@@ -16,10 +16,14 @@ import java.util.List;
  */
 public class DiscordEventPacket extends Packet {
 
-	/** The type of Discord event. */
+	/**
+	 * The type of Discord event.
+	 */
 	public EventType type;
 
-	/** Pre-built rich text segments for the main message line. */
+	/**
+	 * Pre-built rich text segments for the main message line.
+	 */
 	public List<TextSegment> segments;
 
 	/**
@@ -67,10 +71,14 @@ public class DiscordEventPacket extends Packet {
 	 * @author Xujiayao
 	 */
 	public enum EventType {
-		/** A regular Discord chat message forwarded to Minecraft. */
+		/**
+		 * A regular Discord chat message forwarded to Minecraft.
+		 */
 		CHAT,
 
-		/** A Discord command execution notification forwarded to Minecraft. */
+		/**
+		 * A Discord command execution notification forwarded to Minecraft.
+		 */
 		COMMAND
 	}
 }

core/src/main/java/com/xujiayao/discord_mc_chat/network/packets/events/TextSegment.java

@@ -21,22 +21,34 @@ public class TextSegment implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 
-	/** The display text of this segment. */
+	/**
+	 * The display text of this segment.
+	 */
 	public String text;
 
-	/** Whether the text should be rendered in bold. */
+	/**
+	 * Whether the text should be rendered in bold.
+	 */
 	public boolean bold;
 
-	/** Whether the text should be rendered in italic. */
+	/**
+	 * Whether the text should be rendered in italic.
+	 */
 	public boolean italic;
 
-	/** Whether the text should be rendered with underline. */
+	/**
+	 * Whether the text should be rendered with underline.
+	 */
 	public boolean underlined;
 
-	/** Whether the text should be rendered with strikethrough. */
+	/**
+	 * Whether the text should be rendered with strikethrough.
+	 */
 	public boolean strikethrough;
 
-	/** Whether the text should be rendered obfuscated. */
+	/**
+	 * Whether the text should be rendered obfuscated.
+	 */
 	public boolean obfuscated;
 
 	/**

core/src/main/java/com/xujiayao/discord_mc_chat/server/discord/DiscordEventHandler.java

@@ -21,8 +21,8 @@ import org.jetbrains.annotations.NotNull;
 
 import java.util.ArrayList;
 import java.util.List;
-import java.util.Set;
 import java.util.Map;
+import java.util.Set;
 import java.util.stream.Collectors;
 
 /**

core/src/main/java/com/xujiayao/discord_mc_chat/server/discord/DiscordManager.java

@@ -11,7 +11,9 @@ import net.dv8tion.jda.api.JDA;
 import net.dv8tion.jda.api.JDABuilder;
 import net.dv8tion.jda.api.OnlineStatus;
 import net.dv8tion.jda.api.entities.Activity;
+import net.dv8tion.jda.api.entities.Member;
 import net.dv8tion.jda.api.entities.Message;
+import net.dv8tion.jda.api.entities.User;
 import net.dv8tion.jda.api.entities.Webhook;
 import net.dv8tion.jda.api.entities.channel.concrete.TextChannel;
 import net.dv8tion.jda.api.exceptions.InsufficientPermissionException;
@@ -295,7 +297,7 @@ public class DiscordManager {
 	 * @param discordId The Discord user ID.
 	 * @return The User object, or null if JDA is not available or user not found.
 	 */
-	public static net.dv8tion.jda.api.entities.User retrieveUser(String discordId) {
+	public static User retrieveUser(String discordId) {
 		if (jda == null) return null;
 		try {
 			return jda.retrieveUserById(discordId).complete();
@@ -310,11 +312,11 @@ public class DiscordManager {
 	 * @param discordId The Discord user ID.
 	 * @return The Member object, or null if JDA is not available or member not found.
 	 */
-	public static net.dv8tion.jda.api.entities.Member retrieveMember(String discordId) {
+	public static Member retrieveMember(String discordId) {
 		if (jda == null) return null;
 		for (var guild : jda.getGuilds()) {
 			try {
-				net.dv8tion.jda.api.entities.Member member = guild.retrieveMemberById(discordId).complete();
+				Member member = guild.retrieveMemberById(discordId).complete();
 				if (member != null) {
 					return member;
 				}

core/src/main/java/com/xujiayao/discord_mc_chat/server/discord/DiscordMessageParser.java

@@ -4,7 +4,6 @@ import com.fasterxml.jackson.databind.JsonNode;
 import com.xujiayao.discord_mc_chat.network.packets.events.TextSegment;
 import com.xujiayao.discord_mc_chat.server.linking.LinkedAccountManager;
 import com.xujiayao.discord_mc_chat.utils.config.ConfigManager;
-import com.xujiayao.discord_mc_chat.utils.config.ModeManager;
 import com.xujiayao.discord_mc_chat.utils.i18n.I18nManager;
 import net.dv8tion.jda.api.entities.Member;
 import net.dv8tion.jda.api.entities.Message;
@@ -721,32 +720,6 @@ public class DiscordMessageParser {
 		return "blue";
 	}
 
-	/**
-	 * Internal record representing a span of raw text that maps to a special token
-	 * (mention, emoji, link, etc.).
-	 */
-	private record TokenSpan(int start, int end, TextSegment segment) {
-	}
-
-	/**
-	 * Internal record representing a markdown-formatted span of text.
-	 */
-	private record MarkdownSpan(int start, int end, String innerText, MarkdownType type) {
-	}
-
-	/**
-	 * Types of markdown formatting.
-	 */
-	private enum MarkdownType {
-		BOLD,
-		ITALIC,
-		UNDERLINE,
-		STRIKETHROUGH,
-		SPOILER,
-		CODE_BLOCK,
-		INLINE_CODE
-	}
-
 	/**
 	 * Safely truncates a string to the given maximum character count without splitting
 	 * surrogate pairs (multi-byte emoji characters).
@@ -765,4 +738,30 @@ public class DiscordMessageParser {
 		}
 		return text.substring(0, maxLen);
 	}
+
+	/**
+	 * Types of markdown formatting.
+	 */
+	private enum MarkdownType {
+		BOLD,
+		ITALIC,
+		UNDERLINE,
+		STRIKETHROUGH,
+		SPOILER,
+		CODE_BLOCK,
+		INLINE_CODE
+	}
+
+	/**
+	 * Internal record representing a span of raw text that maps to a special token
+	 * (mention, emoji, link, etc.).
+	 */
+	private record TokenSpan(int start, int end, TextSegment segment) {
+	}
+
+	/**
+	 * Internal record representing a markdown-formatted span of text.
+	 */
+	private record MarkdownSpan(int start, int end, String innerText, MarkdownType type) {
+	}
 }

minecraft/src/main/java/com/xujiayao/discord_mc_chat/minecraft/events/MinecraftEventHandler.java

@@ -71,6 +71,7 @@ import java.util.concurrent.TimeUnit;
  */
 public class MinecraftEventHandler {
 
+	private static final String DEFAULT_MENTION_STYLE = "title";
 	private static MinecraftServer serverInstance;
 
 	/**
@@ -805,8 +806,6 @@ public class MinecraftEventHandler {
 		}
 	}
 
-	private static final String DEFAULT_MENTION_STYLE = "title";
-
 	/**
 	 * Sends a mention notification to a player using the configured style.
 	 *

minecraft/src/main/java/com/xujiayao/discord_mc_chat/minecraft/translations/TranslationManager.java

@@ -7,6 +7,7 @@ import com.xujiayao.discord_mc_chat.utils.StringUtils;
 import com.xujiayao.discord_mc_chat.utils.i18n.I18nManager;
 import net.minecraft.network.chat.Component;
 import net.minecraft.network.chat.contents.TranslatableContents;
+import net.minecraft.resources.ResourceLocation;
 import net.minecraft.server.MinecraftServer;
 import net.minecraft.server.packs.PackResources;
 import net.minecraft.server.packs.PackType;
@@ -245,7 +246,7 @@ public class TranslationManager {
 					packResources1.getNamespaces(PackType.CLIENT_RESOURCES).forEach(namespace -> {
 						IoSupplier<InputStream> supplier = packResources1.getResource(
 								PackType.CLIENT_RESOURCES,
-								net.minecraft.resources.ResourceLocation.fromNamespaceAndPath(namespace, "lang/" + language + ".json")
+								ResourceLocation.fromNamespaceAndPath(namespace, "lang/" + language + ".json")
 						);
 
 						if (supplier != null) {