[1.7] 优化项目代码

Author: MineSunshineone

README.md

@@ -14,7 +14,7 @@ Velocity 线路切换插件，让玩家在不退出服务器的情况下自动
 支持基于多种条件的自动转移：
 - **地理位置**: 国家、省份
 - **网络运营商**: 电信、联通、移动
-- **连接域名**: 不同域名进入不同线路（类似 PistonMOTD 的虚拟主机）
+- **连接域名**: 支持 SRV 解析（如 `test.2b2t.icu:10004`），支持端口匹配
 - **玩家 UUID**: VIP 专属线路
 - **历史记录**: 自动记住玩家上次使用的线路
 
@@ -23,6 +23,10 @@ Velocity 线路切换插件，让玩家在不退出服务器的情况下自动
 - `!` 表示非（!中国 = 海外）
 - 多条件 AND 组合
 
+### 智能防环路
+- **冗余转移检测**: 如果玩家已经连接到目标线路的 IP/端口，插件会自动跳过转移，防止连接中断或死循环。
+- **超时保护**: 如果转移失败，自动回退到安全服务器。
+
 ### 线路管理
 - 实时延迟监控
 - 手动切换线路
@@ -41,45 +45,57 @@ Velocity 线路切换插件，让玩家在不退出服务器的情况下自动
 外部只能看到 Velocity 的 IP，无法直接连接内部子服务器，防止 DDoS 绕过。
 
 **单域名多入口**  
-配置 `cn.example.com` 和 `us.example.com` 解析到同一个 Velocity，插件根据域名自动分流。
+配置 `cn.example.com` 和 `us.example.com` 解析到同一个 Velocity，插件根据域名自动分流。支持 SRV 记录解析，精准匹配 `host:port`。
 
 ## 快速开始
 
 ### 安装
 1. 下载 `simpletransfer-xx.jar`
 2. 放入 Velocity 的 `plugins` 目录
 3. 重启 Velocity
-4. 编辑 `plugins/simpletransfer/config.toml` 配置线路
+4. 编辑 `plugins/simpletransfer/config.conf` 配置线路
 5. 编辑 `plugins/simpletransfer/rules.conf` 配置规则
 
 ### 基础配置
 
-**config.toml** - 定义线路
-```toml
-[servers.bgp]
-name = "BGP线路"
-target = "bgp-server"  # Velocity 中注册的服务器名
-description = "多线BGP"
-
-[servers.dx]
-name = "电信线路"
-target = "dx-server"
-description = "电信专线"
+**config.conf** - 定义线路 (HOCON 格式)
+```hocon
+permission_groups {
+  default {
+    permission = ""
+    servers {
+      bgp {
+        host = "bgp.example.com"
+        port = 25565
+        display_name = "BGP线路"
+        description = "多线BGP"
+      }
+      dx {
+        host = "dx.example.com"
+        port = 25565
+        display_name = "电信线路"
+        description = "电信专线"
+      }
+    }
+  }
+}
 ```
 
 **rules.conf** - 定义规则
 ```hocon
-{
-  enabled = true
-  name = "电信用户优化"
-  conditions {
-    isp = "电信"
-    has_history = false
-  }
-  action {
-    transfer = "dx"
+[
+  {
+    enabled = true
+    name = "电信用户优化"
+    conditions {
+      isp = "电信"
+      has_history = false
+    }
+    action {
+      transfer = "dx"
+    }
   }
-}
+]
 ```
 
 ### 命令
@@ -92,7 +108,7 @@ description = "电信专线"
 管理员命令：
 - `/st status <玩家>` - 查看玩家信息
 - `/st transfer <玩家> <线路>` - 强制转移玩家
-- `/st reload [config|rules|all]` - 重载配置
+- `/st reload` - 重载配置
 - `/st rules` - 查看规则列表
 
 ### 权限
@@ -105,8 +121,8 @@ description = "电信专线"
 玩家 -> Velocity (SimpleTransfer) -> 内部子服务器
          |
          +-- 检测 IP 地理位置
-         +-- 匹配路由规则
-         +-- 自动转移到最优线路
+         +-- 匹配路由规则 (支持 SRV 域名)
+         +-- 自动转移到最优线路 (智能防环路)
          +-- 记录历史选择
 ```
 
@@ -160,24 +176,24 @@ Velocity 作为中转层，所有玩家连接先到 Velocity，插件检测玩
 }
 ```
 
-### 场景3: 域名分流
+### 场景3: 域名分流 (支持 SRV)
 ```hocon
 # cn.example.com 进入国内线路
 {
   enabled = true
   conditions {
-    hostname = "cn.example.com"
+    hostname = "cn.example.com" # 默认端口 25565
   }
   action { transfer = "bgp" }
 }
 
-# us.example.com 进入国际线路
+# SRV 域名匹配 (需指定端口)
 {
   enabled = true
   conditions {
-    hostname = "us.example.com"
+    hostname = "play.example.com:10004"
   }
-  action { transfer = "us" }
+  action { transfer = "vip" }
 }
 ```
 

pom.xml

@@ -5,7 +5,7 @@
 
     <groupId>ict.minesunshineone</groupId>
     <artifactId>simpletransfer</artifactId>
-    <version>1.6</version>
+    <version>1.7</version>
     <packaging>jar</packaging>
 
     <name>SimpleTransfer</name>

src/main/java/ict/minesunshineone/simpleTransfer/command/AbstractSubCommand.java

@@ -0,0 +1,121 @@
+package ict.minesunshineone.simpleTransfer.command;
+
+import com.velocitypowered.api.command.CommandSource;
+
+import ict.minesunshineone.simpleTransfer.config.ConfigManager;
+import ict.minesunshineone.simpleTransfer.connection.PlayerConnectionManager;
+import net.kyori.adventure.text.Component;
+import net.kyori.adventure.text.format.NamedTextColor;
+import net.kyori.adventure.text.format.TextColor;
+
+/**
+ * 子命令基类
+ * 提供通用工具方法
+ */
+public abstract class AbstractSubCommand implements SubCommand {
+
+    protected final ConfigManager configManager;
+    protected final PlayerConnectionManager connectionManager;
+
+    // 常用颜色常量
+    protected static final TextColor COLOR_PRIMARY = TextColor.color(0x00DDFF);
+    protected static final TextColor COLOR_SUCCESS = TextColor.color(0x00FF88);
+    protected static final TextColor COLOR_WARNING = TextColor.color(0xFFDD00);
+    protected static final TextColor COLOR_ERROR = TextColor.color(0xFFAAAA);
+    protected static final TextColor COLOR_INFO = TextColor.color(0xAAFFFF);
+    protected static final TextColor COLOR_MUTED = TextColor.color(0xAAAAAA);
+    protected static final TextColor COLOR_TITLE = TextColor.color(0x00FFFF);
+
+    protected AbstractSubCommand(ConfigManager configManager, PlayerConnectionManager connectionManager) {
+        this.configManager = configManager;
+        this.connectionManager = connectionManager;
+    }
+
+    // ========== 消息构建工具方法 ==========
+
+    /**
+     * 发送带箭头前缀的消息
+     */
+    protected void sendPrefixed(CommandSource source, String text, TextColor color) {
+        source.sendMessage(Component.text()
+                .append(Component.text(" ➤ ", COLOR_PRIMARY))
+                .append(Component.text(text, color))
+                .build());
+    }
+
+    /**
+     * 发送带箭头前缀的键值对消息
+     */
+    protected void sendKeyValue(CommandSource source, String key, String value, TextColor valueColor) {
+        source.sendMessage(Component.text()
+                .append(Component.text(" ➤ ", COLOR_PRIMARY))
+                .append(Component.text(key, NamedTextColor.WHITE))
+                .append(Component.text(value, valueColor))
+                .build());
+    }
+
+    /**
+     * 发送错误消息
+     */
+    protected void sendError(CommandSource source, String message) {
+        source.sendMessage(Component.text()
+                .append(Component.text(" ✘ ", NamedTextColor.RED))
+                .append(Component.text(message, COLOR_ERROR))
+                .build());
+    }
+
+    /**
+     * 发送成功消息
+     */
+    protected void sendSuccess(CommandSource source, String message) {
+        source.sendMessage(Component.text()
+                .append(Component.text(" ✓ ", NamedTextColor.GREEN))
+                .append(Component.text(message, COLOR_SUCCESS))
+                .build());
+    }
+
+    /**
+     * 发送空行
+     */
+    protected void sendEmpty(CommandSource source) {
+        source.sendMessage(Component.text(" "));
+    }
+
+    /**
+     * 发送标题
+     */
+    protected void sendTitle(CommandSource source, String title) {
+        source.sendMessage(Component.text()
+                .append(Component.text("✦ ", NamedTextColor.GOLD))
+                .append(Component.text(title, COLOR_TITLE))
+                .build());
+    }
+
+    /**
+     * 获取延迟颜色
+     */
+    protected NamedTextColor getPingColor(long ping) {
+        if (ping < 50) {
+            return NamedTextColor.GREEN;
+        } else if (ping < configManager.getPingThreshold()) {
+            return NamedTextColor.YELLOW;
+        } else {
+            return NamedTextColor.RED;
+        }
+    }
+
+    /**
+     * 检查是否为管理员
+     */
+    protected boolean isAdmin(CommandSource source) {
+        return source.hasPermission("simpletransfer.admin");
+    }
+
+    @Override
+    public boolean hasPermission(CommandSource source) {
+        if (isAdminOnly()) {
+            return isAdmin(source);
+        }
+        return true;
+    }
+}