Actio

Actio

快速访问:空手按住E键打开动作轮盘,任何模组都可以在其中放置其操作。

生活质量

Actio

Hytale 服务器的快捷入口:空手按住 E 打开动作轮盘,任何模组都可以把它的动作放进去。

Actio 是一款服务器插件。一切都在服务器端运行,因此玩家无需安装任何东西。单独使用它不会给玩家带来任何变化:只有当某个模组在轮盘中注册了动作时,轮盘才会出现。

Actio 支持英语、葡萄牙语、德语、西班牙语、法语、俄语和中文。每位玩家都会以各自的游戏语言看到它,无需任何设置。

功能

🎡 按 E 打开的动作轮盘

  • 主手为空时按住 E,即可在屏幕中央打开一个轮盘,形状与游戏内的 Z 轮盘相同。松开 E 即可选中你正对着的动作。
  • 轮盘打开时镜头保持不动:移动鼠标会标记对应方向上的扇区,中央显示所标记内容的图标和名称。底部的 X 仅用于关闭轮盘。
  • 副手持盾牌或火把时也能打开。自带 E 键功能的物品会保留其 E 键功能。
  • 受到伤害、切换快捷栏、手持物品或切换世界时,轮盘会关闭且不会选中任何内容。
  • 没有动作,就没有变化:若没有任何模组注册动作,E 键仍保持游戏原功能。

🔴 生命值旁的小指示器

  • 当轮盘中有动作时,生命值条左侧会显示一个带 E 的小轮盘,提醒玩家对应的按键。
  • 上面的红点表示某个动作有新内容,例如有待领取的邮件。该红点也会显示在动作、其所属类别及其子类别上。
  • PH_2

🗂️ 类别、"更多"与返回

  • 动作被分为四个类别:经济、社交、工具和其他,并在其中按各模组的子类别归类。
  • 将鼠标停在某个类别上一秒钟即可打开它:图标上的箭头表示它可以展开,等待期间会有一个进度条填充。X 会变为返回。
  • 当某一层级的物品数量超过扇区数时,最后一个扇区会变为更多。
  • 管理员可以关闭类别,并选择轮盘每个位置放置哪个动作。

📏 自选尺寸

  • 轮盘默认有 5 个扇区,与 Z 轮盘相同,也可以选择 7、10 或 15 个(含 X)。更多扇区意味着每一层能容纳更多动作。
  • 轮盘使用的图片体积小,不会与游戏或其他模组的图片争抢空间。

🔌 面向其他模组的公共 API

  • 任何模组都可以注册自己的动作,包括以玩家语言显示的名称、自己的图标、类别和子类别,并可以为某位玩家开启某个动作的红点。
  • Actio 不依赖任何其他模组:邮件、经济或任何其他模组都以相同方式接入。若服务器上未安装 Actio,这些模组会保留各自的命令。
  • 其他模组的动作会在各模组启动和停止时自动出现和消失,控制台会列出它们。

🛠️ 管理菜单与测试动作

  • /actio menu 会打开一个游戏内管理菜单,包含所有选项:测试动作、类别、模组图标、鼠标悬停时间、轮盘尺寸,以及在关闭类别时每个位置放置的动作。
  • 更改会保存在草稿中,直到你点击应用才会写入 config.json 并立即生效。撤销会回到已保存的状态。
  • 测试动作默认关闭,开启后会在轮盘上放置仅发送聊天消息的示例动作,以便在没有任何其他模组的情况下查看轮盘。
  • 该菜单与作者其他模组的风格一致:游戏原生的蓝色、金色细节,以及带闪电图案的火漆印章。

需求

Hytale 服务器 0.7.x(Update 7)。已在 0.7.5 上测试
其他模组 无需任何模组。轮盘会显示任何使用 Actio API 的模组的动作,例如邮件模组或经济模组

每个 Actio 版本只支持一个 Hytale 更新版本。Hytale API 会随每次更新而变化,因此在对应的 Actio 版本发布之前,请不要将服务器更新到新的 Hytale 更新版本。

Actio Hytale
1.0.0 0.7.x(Update 7),已在 0.7.5 上测试

安装

  1. 停止服务器。
  2. 将 Actio-<version>.jar 放入服务器的 mods 文件夹。该文件夹中只保留一个 Actio jar。
  3. 启动服务器。Actio 会在 mods/Merlinz_Actio/ 中创建其文件,控制台会显示 Actio loaded.。
  4. 添加你希望在轮盘中显示其动作的模组。若想在没有任何此类模组的情况下查看轮盘,可使用 /actio testactions on 开启测试动作,并在玩家加入前将其关闭。

卸载。 在 Actio 仍安装的情况下使用 /stop 停止服务器:它会从所有在线玩家那里移除轮盘的 E 键功能。然后再删除 jar。若发生崩溃,请让每位当时在线的玩家在安装 Actio 的情况下加入一次,然后再移除 Actio。

命令__PH_3__

所有命令均为管理员命令。子命令还需要 /actio 的权限。OP 拥有全部权限。除 menu 外的所有命令也可在控制台中运行。

命令 作用 权限
/actio 显示已注册动作的数量,以及测试动作和类别是否开启 merlinz.actio.command.actio
/actio menu 打开管理菜单 merlinz.actio.command.actio.menu
/actio reload 无需重启即可重新加载 config.json merlinz.actio.command.actio.reload
/actio testactions on · off 开启或关闭测试动作,保存 config.json 并立即生效 merlinz.actio.command.actio.testactions

配置

mods/Merlinz_Actio/config.json,通过 /actio reload 或管理菜单应用:

键 默认值 作用
TestActions false 将测试动作放入轮盘。在实际服务器上请保持 false
Categories true 在轮盘上显示类别。设为 false 会直接显示 WheelActions 中的动作,适用于模组较少的服务器
Slices 5 轮盘的扇区数量(含 X):5、7、10 或 15
HoverSeconds 1.0 鼠标在类别、"更多"或返回上停留多久才打开,范围从 0.25 到 5 秒
WheelActions 每个位置一个空值 仅在 Categories 关闭时生效:每个位置的动作 id,从顶部开始顺时针排列,数量比 Slices 少一。"" 表示该位置留空。最多 14 个,不可重复
ExternalIcons true 显示各模组为其动作提供的图标。设为 false 时,所有动作都显示 Actio 的星形图标

包含错误的文件(JSON 格式错误、未知或缺失的键、超出范围的值)会被整体拒绝,控制台会说明原因,Actio 会保留原有设置。

已知限制

  • 德语、西班牙语、法语、俄语和中文的翻译尚未经过母语者审校。服务器日志和配置文件错误始终为英语。
  • 轮盘只有 5、7、10 或 15 个扇区:游戏客户端无法旋转图片,因此每种尺寸都是预先绘制好的。
  • 如果另一个模组已经为玩家绑定了 E 键,Actio 不会干预,该玩家的轮盘也不会打开。
  • 当玩家主手为空时,轮盘的 E 键功能会保存在玩家文件中。只有服务器崩溃会将其保留下来,玩家下次在安装 Actio 的情况下加入时会自动修复。参见上文"卸载"。

许可证

可免费在任何数量的服务器上使用,包括盈利性服务器。你不得重新发布、再分发、出售或分发 Actio 的修改版本。完整文本请参阅本页面的许可证。

Actio 是一款非官方模组。它并非由 Hypixel 制作、认可或支持。


支持

Actio 是免费的。如果它对您的服务器有帮助,您可以在 Ko-fi 上支持它的开发。谢谢!

Support Actio on Ko-fi