mioku-plugin-terraria 2.0.1 → 2.0.3

package/README.md

@@ -8,15 +8,12 @@
 - **RCON 命令执行**：在群聊中以命令前缀（默认 `$`）开头的消息会被当作服务器命令执行，支持白名单
 - **多服务器支持**：可同时连接多台 Terraria 服务器，每台独立配置
 - **自动重连**：连接断开后按指数退避自动重连，可配置最大重试次数
+- **过滤未知玩家**：默认不推送玩家名称缺失的事件，可在配置中关闭
 
 ## 服务端要求
 
 Terraria 服务器需安装 [TianSuo](https://github.com/Jerryplusy/TianSuo) TShock 插件
 
-## 配置
-
-通过 WebUI 配置页面管理
-
 ## 命令
 
 | 命令                       | 描述                       | 权限  |

package/config.md

@@ -13,6 +13,11 @@ fields:
     type: switch
     description: 消息中是否显示服务器名称
 
+  - key: base.ignore_unknown_player
+    label: 不推送未知玩家信息
+    type: switch
+    description: 开启后，不推送玩家名称缺失的事件（如未知玩家加入、退出、聊天、死亡）
+
   - key: base.servers
     label: 服务器列表
     type: array
@@ -83,5 +88,6 @@ fields:
 keys:
   - base.say_way
   - base.display_server_name
+  - base.ignore_unknown_player
   - base.servers
 ```

package/core/command.ts

@@ -14,7 +14,7 @@ export function isCommandAllowed(
   text: string,
   serverItem: TerrariaServerConfig,
   isMaster: boolean,
-  userId: number | string | undefined,
+  userId: string | undefined,
 ): boolean {
   if (isMaster) return true;
 

package/index.ts

@@ -39,18 +39,13 @@ export default definePlugin({
     serverManager.startServers(config);
     ctx.logger.info("Terraria 插件已就绪");
 
-    const requireGroup = (event: any): number | undefined => {
-      const groupId =
-        "group_id" in event && typeof event.group_id === "number"
-          ? event.group_id
-          : undefined;
-      return groupId;
-    };
+    const requireGroup = (event: any): string | undefined =>
+      String(event?.group_id ?? "").trim() || undefined;
 
     ctx.command({
-      name: "/ts 状态",
-      match: /^\/ts\s*状态(?:\s|$)/,
-      prefixes: false,
+      name: "ts 状态",
+      prefixes: ["/", "."],
+      match: /^ts\s*状态(?:\s|$)/,
       permission: "master",
       description: "查看所有已配置服务器的 WebSocket 连接状态",
       handler: async ({ event }) => {
@@ -61,12 +56,12 @@ export default definePlugin({
       },
     });
     ctx.command({
-      name: "/ts 开启同步",
-      match: /^\/ts\s*开启同步(?:\s|$)/,
-      prefixes: false,
+      name: "ts 开启同步",
+      prefixes: ["/", "."],
+      match: /^ts\s*开启同步(?:\s|$)/,
       permission: "master",
       description: "开启指定服务器的群聊消息同步功能",
-      usage: "/ts 开启同步 <服务器名称>",
+      usage: ".ts 开启同步 <服务器名称>",
       handler: async ({ event, args }) => {
         if (!requireGroup(event)) return;
         await handleSync(
@@ -81,12 +76,12 @@ export default definePlugin({
       },
     });
     ctx.command({
-      name: "/ts 关闭同步",
-      match: /^\/ts\s*关闭同步(?:\s|$)/,
-      prefixes: false,
+      name: "ts 关闭同步",
+      prefixes: ["/", "."],
+      match: /^ts\s*关闭同步(?:\s|$)/,
       permission: "master",
       description: "关闭指定服务器的群聊消息同步功能",
-      usage: "/ts 关闭同步 <服务器名称>",
+      usage: ".ts 关闭同步 <服务器名称>",
       handler: async ({ event, args }) => {
         if (!requireGroup(event)) return;
         await handleSync(
@@ -101,9 +96,9 @@ export default definePlugin({
       },
     });
     ctx.command({
-      name: "/ts 重连",
-      match: /^\/ts\s*重连(?:\s|$)/,
-      prefixes: false,
+      name: "ts 重连",
+      prefixes: ["/", "."],
+      match: /^ts\s*重连(?:\s|$)/,
       permission: "master",
       description: "断开并重新建立所有服务器的 WebSocket 连接",
       handler: async ({ event }) => {
@@ -118,7 +113,7 @@ export default definePlugin({
       const groupId = requireGroup(event);
       if (!groupId) return;
       const text = ctx.text(event)?.trim();
-      if (text?.startsWith("/ts")) return;
+      if (text && /^[./]ts\b/.test(text)) return;
       await forwardToTerraria(ctx, event, config, configHandler, serverManager);
     });
 
@@ -159,6 +154,8 @@ async function handleTerrariaEvent(
           : undefined,
   };
 
+  if (!event.player?.name?.trim() && config.ignore_unknown_player) return;
+
   const messageText = formatTerrariaEvent(event, config);
   if (!messageText) return;
 
@@ -196,9 +193,10 @@ async function forwardToTerraria(
     `[Terraria] 收到群消息 group=${event.group_id} text=${text}`,
   );
 
-  if (!event.group_id) return;
+  const groupId = String(event.group_id ?? "").trim();
+  if (!groupId) return;
 
-  const servers = configHandler.getServersForGroup(event.group_id);
+  const servers = configHandler.getServersForGroup(groupId);
   if (servers.length === 0) return;
 
   const msgList: QqMessagePart[] = Array.isArray(event.message)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mioku-plugin-terraria",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "Terraria 服务器与 QQ 群消息互通插件，基于 TianSuo 协议",
   "main": "index.ts",
   "type": "module",

package/types.ts

@@ -56,12 +56,14 @@ export interface TerrariaConfig {
   servers: TerrariaServerConfig[];
   say_way: string;
   display_server_name: boolean;
+  ignore_unknown_player: boolean;
 }
 
 export const DEFAULT_CONFIG: TerrariaConfig = {
   servers: [],
   say_way: "说：",
   display_server_name: true,
+  ignore_unknown_player: true,
 };
 
 export function normalizeConfig(raw: Partial<TerrariaConfig>): TerrariaConfig {
@@ -103,5 +105,9 @@ export function normalizeConfig(raw: Partial<TerrariaConfig>): TerrariaConfig {
       typeof raw.display_server_name === "boolean"
         ? raw.display_server_name
         : DEFAULT_CONFIG.display_server_name,
+    ignore_unknown_player:
+      typeof raw.ignore_unknown_player === "boolean"
+        ? raw.ignore_unknown_player
+        : DEFAULT_CONFIG.ignore_unknown_player,
   };
 }