城镇工具 重制版

城镇工具 重制版

别再盲目战斗。为Towny SiegeWar打造的实时友军/敌军碰撞箱着色模组。

游戏机制

TownyUtils RENEWED


🌐 客户端外交管理与战斗分析

TownyUtils 是一款高性能的碰撞箱着色与战斗分析模组,旨在最大程度提升混乱 SiegeWar 环境中的态势感知能力。

本模组专为在极度拥挤的 SiegeWar 环境中难以分辨攻击对象的玩家,以及希望在 SiegeWar 中最大化效率的玩家而设计。TownyUtils 不是作弊模组;它是一款减少视觉杂乱并提供实时性能数据的生活质量(QoL)模组。


⚔️ 新增:SiegeWar 统计引擎

TownyUtils 最强大的新增功能是实时战斗分析引擎。

  • 实时 K/D 追踪: 实时监控您自己和您队伍的击杀与死亡。
  • 实时排行榜: 动态排名,显示当前战斗中的顶尖表现者。
  • 多城镇支持: 在多目标围城战中自动分离不同城镇的数据。

当我刚开始开发这个系统时,我以为它会很简单。然而,后来出现的许多因素——例如战斗记录插件(combatlog)、各服务器之间命令输出差异巨大,以及各服务器使用不同的插件——使得该功能仅限于在 MaviBuğday Towny 服务器上运行。

遗憾的是,由于这些因素,不会为其他服务器添加支持。

您可以通过加入我们的 Discord 服务器 查看您的 MaviBuğday SiegeWar 统计数据,在那里您可以查看被围困的城镇以及整体国家与玩家排名。

被围困城镇统计

整体玩家统计


📊 性能数据:真实战斗结果

实际 SiegeWar 统计数据

在今天(2026 年 2 月 22 日)发生的一场围城战中,我们比较了使用 TownyUtils 的玩家与未使用玩家的表现:

队伍 玩家数 模组使用 语音沟通 总击杀 击杀/玩家 表现
Pangea 联盟 ~15-20 ❌ 无模组 ✅ 是 16 击杀 0.8 击杀/玩家 基准
TownyUtils 用户 4 ✅ 使用模组 ✅ 是 18 击杀 4.5 击杀/玩家 5.6 倍更优

背景: 两队技术水平相当(HT5-LT4-HT4-LT3-HT3),装备相同,位置相同。两队各自组内均有语音协调。

为何差异如此巨大?

因素 未使用 TownyUtils 使用 TownyUtils 提升
目标选择时间 ~2.0 秒 ~0.2 秒 快 10 倍
目标准确率 ~60% 选中正确目标 ~95% 选中正确目标 +58% 准确率
无效操作 40% 错误目标 5% 错误目标 减少 87%
战斗循环 2.5 秒/次攻击 0.7 秒/次攻击 快 3.5 倍

数学分析: 5.6 倍的表现系数源自更快目标获取(3.5 倍)与更高准确率(1.58 倍)的结合,这相当于 5.53 倍的理论性能提升,几乎完美地反映了实际战斗结果。


⚙️ 核心架构

TownyUtils 建立在三个主要的后台数据处理引擎之上:

1. 命令解析(主要)

  • 客户端实时监听服务器发送的 /n online、/n allylist、/n enemylist 输出,以及计分板数据。

2. 名称标签读取器(次要)

  • 通过读取 TextDisplayEntity 和 Nametag 数据,在玩家被渲染之前检测其所属国家,并将其分类为友方或敌方。

3. 围城日志分析(新增)

  • 实时解析传入的聊天日志,以更新围城统计仪表板和排行榜。

📡 战术情报(雷达)

🎯 动作栏雷达(敌人检测)

  • 按下 O 键即可激活实时近距离雷达。它会在您的动作栏上直接显示附近敌人和盟友的精确数量,防止部落在战斗中虚报人数。

🛠️ 使用与配置

TownyUtils 模组菜单

下载并安装 TownyUtils 后,您还需要安装 Mod Menu 来管理 TownyUtils。您可以在任何服务器上,通过 Mod Menu 搜索 TownyUtils 或按下 Insert 键来打开 TownyUtils 菜单。

  • 模组状态 – 允许您启用或禁用模组的主要数据处理引擎。
  • 交互式教程(新增) – 打开一个动画形式的 10 步指南,帮助您了解模组的功能。
  • 围城统计(新增) – 打开实时战斗分析仪表板,包含 VS 卡片和排行榜。
  • 碰撞箱 – 让您根据盟友–敌人外交关系切换 TownyUtils 的彩色碰撞箱。
  • 名称标签 – 禁用名称标签,这是 Towny 围城战中劣质显卡上的主要帧率杀手,帮助您在混乱环境中看得更清楚。
  • 自动设置向导 – 自动将您当前国家的敌人和盟友分类为敌对或友好。
  • 开始手动检测 – 自动激活主要数据处理引擎 (命令解析)。
  • 检测 – 让您选择用于检测的数据处理引擎。
  • 自动设置目标 – 如果您前往援助盟国而非自己的国家,此选项可设置自动设置向导的目标国家,以便您定义其敌人和盟友。
  • 数据管理 – 允许您查看、备份或重置本地存储的 Towny 统计数据和外交数据。
  • 敌人检测(雷达) – 可通过 O 键切换,在动作栏上显示附近玩家数量。

禁用名称标签有多强


🕵️ 数据隐私

为何收集数据?

在 TownyUtils 中,跨服务器准确性和兼容性最高的数据处理引擎是解析 Towny 命令的 命令解析引擎。由于每个 Towny 服务器使用的格式和语言不同,该引擎可能工作异常或完全无法工作。因此,您自动或手动启动的 命令解析引擎 所输出的 /n online、/n allylist 和 /n enemylist 命令结果会被发送给我们。这有助于我们改进模组的跨服务器兼容性。

我的数据部分

⚠️ 隐私保证

❌ 无个人数据:您的聊天记录、密码或私信绝不会被访问或收集。

✅ 仅命令输出:仅为兼容性目的分析 Towny 命令的结构。

您的数据共享偏好可随时在设置中开启/关闭(ON/OFF)。您的数据绝不会与第三方共享。数据会传输至开发者控制的私有端点。该端点 URL 不公开。在命令解析过程中,短捕获窗口内的消息可能会被传输,以确保与不同格式服务器的兼容性。


📜 免责声明与常见问题

保留所有权利。禁止未经授权使用源代码、逆向工程或再分发。

❓ 此模组是否提供不公平优势?

不。 此模组是客户端视觉增强工具(QoL)。它不会向服务器发送数据包或传输任何未经授权的数据。

此模组并非为提供不公平优势而设计;相反,它旨在最大化 SiegeWar 中的竞争性和乐趣。

❓ 为什么名称标签读取器不工作?

次要数据处理引擎——名称标签读取器,成功率非常低,且不保证在每个服务器上都能工作。这是因为每个服务器的名称标签结构不同,某些情况下甚至可能不包含国家名称。然而,在它能工作的服务器上,两个数据处理引擎都能成功运行,因此外交检测和更新不会有延迟。

❓ 为什么模组在我玩的服务器上不工作?

由于该模组迄今为止仅在土耳其服务器上测试过,因此不保证在具有不同语言格式的服务器上工作。总体而言,主要数据引擎在我测试过的所有土耳其服务器上都成功运行。同样,它也在地球MC(EarthMC)等外国地缘政治服务器上运行过。但是,不保证在每个外国服务器上都能工作。


TÜRKÇE


TownyUtils RENEWED


🌐 Towny 外交管理与战斗分析

TownyUtils 是一款碰撞箱着色与实时统计模组,旨在将混乱 SiegeWar 环境中的态势感知和性能提升至顶峰。

本模组专为在极度拥挤的 SiegeWar 环境中难以分辨攻击对象、无法从 SiegeWar 战斗中获得最大效率或乐趣的玩家而设计。TownyUtils 不是作弊模组;它是一款减少视觉杂乱并提供实时性能数据的生活质量(QoL)模组。


⚔️ 新增:SiegeWar 统计引擎

添加到 TownyUtils 的最强大功能是实时战斗分析引擎。

  • 即时 K/D 追踪: 战斗中可秒级追踪您自己和队伍的得分。
  • 实时排行榜: 列出当前战斗中表现最突出的玩家的动态排名。
  • 多城镇支持: 在多目标围城战中自动为不同城镇分离数据。

当我开始开发这个系统时,我以为它会很简单。然而,后来出现的许多不同因素(战斗记录插件、命令输出在服务器之间差异巨大,以及服务器使用不同插件)导致该功能仅能在 MaviBuğday Towny 服务器上运行。

遗憾的是,由于这些原因,不会为其他服务器添加支持。


📊 性能数据:真实战斗结果

实际 SiegeWar 统计数据

在今天(2026 年 2 月 22 日)发生的一场围城战中,我们比较了使用 TownyUtils 和未使用 TownyUtils 的玩家的表现:

队伍 玩家数 模组使用 语音沟通 总击杀 击杀/玩家 表现
Pangea 联盟 ~15-20 ❌ 无模组 ✅ 是 16 击杀 0.8 击杀/玩家 基准水平
TownyUtils 用户 4 ✅ 有模组 ✅ 是 18 击杀 4.5 击杀/玩家 5.6 倍更优

背景: 两队技术水平相当(HT5-LT4-HT4-LT3-HT3),装备相同,位置相同。两队各自组内均有语音协调。

为何差异如此巨大?

因素 未使用 TownyUtils 使用 TownyUtils 提升
目标选择时间 ~2.0 秒 ~0.2 秒 快 10 倍
目标准确率 ~60% 正确目标 ~95% 正确目标 +58% 准确率
无效操作 40% 错误目标 5% 错误目标 减少 87%
战斗循环 2.5 秒/次攻击 0.7 秒/次攻击 快 3.5 倍

数学分析: 5.6 倍的表现系数源自更快目标检测(3.5 倍)与更高命中率的结合(1.58 倍);这相当于理论上 5.53 倍的性能提升,几乎完美地反映了实际 SiegeWar 结果。


⚙️ 核心架构

TownyUtils 建立在三个后台运行的主要数据处理引擎之上:

1. 命令解析(主要)

  • 客户端实时监听服务器发送的 /n online、/n allylist、/n enemylist 输出,以及计分板(scoreboard)数据。

2. 名称标签读取器(次要)

  • 通过读取 TextDisplayEntity 和 Nametag 数据,在玩家尚未渲染之前检测其所属国家,并将其分类为友方或敌方。

3. 围城日志分析(新增)

  • 实时解析聊天日志,更新围城统计面板和排行榜。

📡 战术情报(雷达)

🎯 动作栏雷达(敌人检测)

  • 按下 O 键即可激活实时近距离雷达。在动作栏上显示最近的敌人和友方数量,防止部落在战斗中“虚报数字”(编造人数),并向您展示清晰的画面。

🛠️ 使用与配置

mm

下载并安装 TownyUtils 后,您还需要安装 Mod Menu 模组来管理 TownyUtils。您可以在任何服务器上,通过 Mod Menu 内搜索 TownyUtils 或按下 Insert 键来打开 TownyUtils 菜单。

  • Mod Status(模组状态) – 允许您启用或禁用模组的主要数据处理引擎。
  • 交互式指南(新增) – 打开一个 10 步动画指南,帮助您了解模组的功能。
  • 围城统计(新增) – 打开包含 VS 卡片和排行榜的实时战斗分析面板。
  • Hitboxes(碰撞箱) – 让您根据盟友–敌人外交关系开启或关闭 TownyUtils 的彩色碰撞箱。
  • Name Tags(名称标签) – 禁用名称标签,这是 Towny 围城战中劣质显卡上的主要帧率杀手,帮助您在混乱环境中看得更清楚。
  • Auto Setup Wizard(自动设置向导) – 自动将您当前国家的敌人和盟友分类为敌对或友好。
  • Start Manual Detection(开始手动检测) – 自动激活主要数据处理引擎 (命令解析)。
  • Detection(检测) – 让您选择用于检测的数据处理引擎。
  • Auto Setup Target(自动设置目标) – 如果您前往援助盟国而非自己的国家,此选项可让您为自动设置向导设置目标国家,以便定义该国的敌人和盟友。
  • 数据管理 – 允许您查看、备份或重置本地存储的 Towny 统计数据和外交数据。
  • 敌人检测(雷达) – 可通过 O 键开启/关闭,在动作栏上显示附近玩家数量。

禁用名称标签有多强


🕵️ 数据隐私

为何收集数据?

在 TownyUtils 中,跨服务器准确性和兼容性最高的数据处理引擎是解析 Towny 命令的 命令解析引擎。由于每个 Towny 服务器使用的格式和语言不同,该引擎可能工作异常或完全无法工作。 因此,您自动或手动启动的 命令解析引擎 所输出的 /n online、/n allylist 和 /n enemylist 命令结果会被发送给我们。这有助于我们改进模组的跨服务器兼容性。

我的数据部分

⚠️ 隐私保证

❌ 无个人数据:您的聊天记录、密码或私信绝不会被访问或收集。

✅ 仅命令输出:仅为兼容性目的分析 Towny 命令的结构。

您的数据共享偏好可随时在设置中开启/关闭(ON/OFF)。您的数据绝不会与第三方共享。数据会发送至开发者控制的私有端点。该端点地址不公开。由于不同服务器格式差异,短捕获窗口内的消息可能会被传输以确保兼容性。


📜 法律声明与常见问题

保留所有权利。禁止未经授权使用源代码、逆向工程或再分发。

❓ 此模组是否提供不公平优势?

不。* 此模组是客户端视觉增强工具(QoL)。*它不会向服务器发送数据包或传输任何未经授权的数据。

此模组并非为提供不公平优势而设计;相反,它旨在最大化 SiegeWar 中的竞争性和乐趣。

❓ 为什么名称标签读取器(Nametag Reader)不工作?

次要数据处理引擎——名称标签读取器,成功率非常低,且不保证在每个服务器上都能工作。这是因为名称标签在每个服务器上的结构不同,某些情况下甚至可能不包含国家名称。然而,在它能工作的服务器上,两个数据处理引擎都能成功运行,因此外交检测和更新不会有延迟。

❓ 为什么模组在我玩的服务器上不工作?

由于该模组迄今为止仅在土耳其服务器上测试过,因此不保证在具有不同语言格式的服务器上工作。总体而言,主要数据引擎在我测试过的所有土耳其服务器上都成功运行。同样,它也在地球MC(EarthMC)等外国地缘政治服务器上运行过。但是,不保证在每个外国服务器上都能工作。