MaceBot

MaceBot

MaceBot 是你的个人锤战PvP训练师。练习瞄准、学习战斗机制、即时切换属性，并在完整的模拟对决中测试你的技能——全部无需其他玩家。

游戏机制

MaceBot

将任何世界变成狼牙棒战斗训练场。MaceBot 会生成一个完全可自定义的 PvP 机器人，它能格挡、闪避、暴击，并以真实的时间感进行反击——专为帮助你磨练你的狼牙棒战斗技巧而设计：瞄准、距离控制、眩晕猛击、珍珠狼牙棒战术，应有尽有。

你可以调高或调低机器人的难度，并选择专注的练习模式，而不是仅仅进行一场普通的战斗。所有功能都可以通过命令完全控制，因此你不需要任何客户端模组即可使用——但在客户端安装后将解锁完整的 GUI，包括实时战斗受击框覆盖、主题编辑器，以及为想要额外便利和更灵活控制的玩家提供的专业套装编辑器。

自 v1.3.1 以来的 Bug 修复

  • 修复了加入未安装 MaceBot 的服务器时重复出现警告信息的问题。
  • 修复了在未安装 MaceBot 的服务器上使用按键绑定导致游戏崩溃的问题。
  • 修复了加入耗时过长的服务器时游戏崩溃的问题。

[注意] 我无法在无问题的专用服务器环境中测试该模组。 因此，你在加入其他服务器时可能会遇到更多崩溃或错误。请在报告部分指出这些问题。谢谢。

🚀 v1.3 新增内容

  • 完全命令控制 — 每项设置、套装和机器人动作现在都可以通过命令进行管理。使用 MaceBot 不再需要客户端模组。
  • 难度等级 — 新手（Noob）、高手（Pro）和大师（Master），可调整机器人的攻击距离、命中率和可用动作。
  • 练习模式 — NPC、对战（Fight），以及一个专用的练习（Practice）模式，包含眩晕猛击（Stun Slam）、瞄准（Aim）和珍珠接取（Pearl Catch）子模式。
  • 通过命令管理套装 — 无需打开 GUI 即可创建、编辑、复制和删除套装。
  • 自定义名称 — 以任意名称生成机器人；如果该名称与真实账号匹配，则会使用该玩家的真实皮肤。
  • 重新设计的客户端 GUI — 重新打造为单一的任务栏式界面，并附带新的主题编辑器，可完全自定义颜色。
  • 战斗受击框覆盖 — 以可自定义的颜色查看目标受击框的渲染。
  • 更安全的默认设置 — 增益效果和自动补充物品现在默认关闭，且所有操作都需要管理员权限，以防止在生存世界中被意外使用。
✨ 功能特性

服务端

  • 战斗 AI

    • 执行狼牙棒攻击、暴击和鞘翅狼牙棒猛击。
    • 生命值低时使用图腾并自我治疗。

  • 难度

    • 三个难度等级：新手（Noob）、高手（Pro） 和 大师（Master）。
    • 根据所选等级调整机器人的攻击距离和命中率（失误频率），并限制某些动作——例如鞘翅狼牙棒猛击。

  • 模式

    • NPC — 用于基础战斗练习的固定沙包。
    • 对战（Fight） — 完整的模拟机器人，会进行反击。
    • 练习（Practice） — 三种专注训练子模式：
      • 眩晕猛击（Stun Slam） — 举起盾牌练习施展眩晕猛击。
      • 瞄准（Aim） — 机器人悬浮在半空中，处于飞行状态，为你提供一个更小的受击框来练习瞄准。
      • 珍珠接取（Pearl Catch） — 机器人使用风弹反复将自己弹射到约 6 格高的空中，让你练习投掷珍珠和狼牙棒猛击的时机。

  • 装备管理

    • 自动补充物品栏。
    • 支持鞘翅飞行和可自定义套装。

  • 套装（Kits）

    • 完全通过命令创建、删除和查看套装。
    • 从零开始构建新套装，或直接从你当前的物品栏生成一个套装。
    • 服务端没有游戏内套装编辑器，因此如果你没有安装客户端模组，仍然可以编辑套装：装备该套装，在你普通的物品栏中调整物品，然后运行 /macebot kits <kit> copyInv 将更改保存回套装。

  • 机器人身份

    • 以自定义名称生成机器人。如果该名称与真实的 Minecraft 账号匹配，机器人将使用该账号的实际皮肤——例如，将机器人生成为 "Wemmbu" 会赋予它玩家 Wemmbu 的名称和皮肤。

  • 自定义选项

    • 切换暴击、普通狼牙棒攻击、鞘翅使用等。
    • 控制机器人是否能对你造成伤害。
    • 完全基于命令控制 MaceBot 的每项设置——请参阅下方命令部分。

  • 安全默认设置

    • 增益效果和自动补充物品默认禁用，以防止在普通的生存世界中被意外使用。
    • 同样出于安全原因，所有命令都需要3级管理员权限。

客户端

客户端模组完全是可选的——MaceBot 在没有它的情况下也能通过命令完整体验——但它为不想打字的玩家提供了完整的 GUI。使用默认按键 P 打开。

  • 任务栏 GUI — 设置、控制面板、套装和信息都整合在一个统一的任务栏式界面中，而不是多个独立窗口，提供远超纯命令的全面灵活控制。
  • 控制面板 — 启动、暂停、生成或移除机器人，并可通过名称字段随时重命名。如果名称与真实的 Minecraft 账号匹配，MaceBot 会获取并显示该玩家的真实皮肤。
  • 主题编辑器 — 在设置界面中自定义 GUI 中使用的颜色，包括战斗受击框颜色。
  • 套装界面与套装菜单 — 浏览所有内置和自定义套装，然后重命名（支持颜色代码）、删除、复制、编辑或加载它们。
  • 套装加载菜单 — 将套装加载到 MaceBot、你自己或所有玩家身上，可选择附魔耐久 III 和经验修补，或使用永不损坏标签（仅限可损坏物品）。
  • 套装编辑器 — 一个灵活的编辑器，涵盖物品名称（支持颜色代码）、附魔、属性、物品数量、任何创造模式菜单物品，并内置 NBT 编辑器以实现精细控制。包含一键复制物品栏按钮，可将你当前的物品栏直接复制到套装中。内置套装不能直接编辑，但你可以复制它们并进行自定义。
  • 套装查看器 — 在加载前预览套装。
  • 战斗受击框 — 以可自定义的颜色（默认：红色）高亮显示你当前目标的受击框，有助于练习距离控制和瞄准。
  • 热键 — 快速打开 GUI 界面、切换客户端模组或切换战斗受击框，无需打开菜单。
  • 安全限制 — 默认情况下，客户端模组会限制没有管理员权限的玩家的某些操作；管理员可以在设置中禁用这些限制，如果他们希望非管理员玩家也能自由使用模组。
⚙️ 命令

所有命令都在 /macebot 下分组，并且需要3级管理员权限。

/macebot controls — 启动、停止和管理机器人
命令 描述
/macebot controls spawn 生成机器人。
/macebot controls kick 移除机器人。
/macebot controls play 恢复机器人。
/macebot controls stop 暂停机器人。
/macebot controls setName <name> 重命名机器人。如果 <name> 与真实的 Minecraft 账号匹配，机器人也将使用该账号的皮肤。
/macebot settings — 配置 MaceBot、玩家和模组选项

设置分为三个类别。每个父命令都将该类别中的所有可编辑设置作为子命令暴露——布尔值直接切换，而下拉式设置（如难度或模式）会在聊天中提示其有效选项。

命令 描述
/macebot settings macebot 所有可编辑的机器人特定设置。
/macebot settings player 所有可编辑的玩家特定设置。
/macebot settings mod 所有可编辑的全局模组设置。
/macebot kits — 创建、编辑和管理套装
命令 描述
/macebot kits new empty <name> 创建一个新的空自定义套装。
/macebot kits new fromInv <name> 使用你当前的物品栏创建一个新的自定义套装。
/macebot kits <kit> load <target> 将套装加载到 MACEBOT、PLAYER（你自己）或 ALL_PLAYERS 上，默认应用耐久 III 和经验修补。
/macebot kits <kit> load <target> unbreakable 改用永不损坏标签加载套装。
/macebot kits <kit> load <target> unbreakingAndMending 以耐久 III 和经验修补加载套装。
/macebot kits <kit> load <target> unbreakingOnly 仅以耐久 III 加载套装。
/macebot kits <kit> load <target> mendingOnly 仅以经验修补加载套装。
/macebot kits <kit> duplicate 复制现有套装（包括内置套装）为新的自定义套装。
/macebot kits <kit> info 显示套装的基本信息（名称、ID、是否为自定义）。
/macebot kits <kit> info items 显示相同信息以及该套装的完整物品列表。
/macebot kits <kit> copyInv 用你当前的物品栏覆盖自定义套装。这是服务端编辑套装的变通方法——装备/持有你想要的物品，然后运行此命令保存——因为在没有客户端模组的情况下没有游戏内套装编辑器。
/macebot kits <kit> delete 删除自定义套装。内置套装不能删除。

注意： 命令本身就能提供完全的控制——无需客户端模组。如果你确实安装了客户端模组，GUI 会将所有这一切包装成更具视觉体验的点选式操作。

📥 安装

服务端

  • 将正确版本的 MaceBot 放入 mods 文件夹并重启服务器。
  • 使用上述列出的命令访问 MaceBot（需要3级管理员权限）。
  • 客户端模组是可选的——如果你想要完整的 GUI 体验，也可以安装它。

客户端

  • 将正确版本的 MaceBot 放入 mods 文件夹并重启客户端。
  • 在单人游戏中，你可以使用命令和 GUI 来控制 MaceBot。
  • 在专用服务器上，你也可以通过 GUI 控制 MaceBot。 （请注意版本兼容性。）

✅ 兼容性

  • 与 Carpet 及其分支（Carpet PvP）兼容（自 v1.2.1 起）。
📜 版本历史
  • v1.0 — 初始版本。仅服务端，命令控制。
  • v1.1 — 仅服务端，后续版本，包含额外的修复和改进。
  • v1.2 — 添加了第一个客户端 GUI，以便更轻松地控制。
  • v1.3 — 完全基于命令的控制、难度等级、模式、机器人身份/皮肤、重新设计的任务栏 GUI 及主题编辑器、战斗受击框覆盖，以及更安全的默认设置。请参阅上文“v1.3 新增内容”。

📝 结语

MaceBot 是我们的第一个大型模组项目。它可能存在错误或不兼容问题，但我们致力于改进它。请分享反馈、建议和新功能想法——你的意见有助于塑造 MaceBot 的未来。

仅适用于 Fabric Mod Loader 生态系统。