mioku-plugin-terraria 2.0.2 → 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/index.ts

@@ -154,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;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mioku-plugin-terraria",
-  "version": "2.0.2",
+  "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,
   };
 }