Epistula:玩家邮件

Epistula:玩家邮件

玩家间邮件:发送物品、短消息或两者兼有,即使离线也可,配有邮箱和历史记录。

游戏玩法

Epistula

Hytale 服务器的邮件系统:向任意玩家发送物品、短消息或两者兼有,即使对方离线也可以,配有邮箱和完整历史记录。

Epistula 是一个服务器插件。一切都在服务器上运行,并保存在它自己的数据库中,因此玩家无需安装任何东西。每次发送、领取和归档都会写入服务器日志。

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

功能

✉️ 发送物品和消息

  • /mail <player> 打开 发送 标签页,左侧显示你的整个物品栏:选择一个物品,设置数量,并可选择写一条最多 255 个字符、8 行 的消息。
  • 仅发送消息 也可以,无需附带物品。
  • 收件人可以 离线,前提是其曾经加入过服务器。输入时名称栏会提示玩家,在线玩家优先。
  • 每封邮件仅限一种物品类型。任何物品都可以发送:邮件不会询问价格或所有者。
  • 消息始终以纯文本显示:无颜色、无命令、无表情符号。

📬 邮箱

  • 收件人会在 屏幕右侧 看到提示,或在登录时看到,显示有多少封邮件在等待。它不会锁定玩家:/mail 打开邮箱,/mail close 隐藏提示。
  • /mail 打开 邮箱:领取物品、阅读消息,或归档仅含消息的邮件。
  • 回复 会打开发送标签页并预填发件人,即使对方此后更改了名称。
  • 物品栏没有空间时,物品会留在邮箱中。没有任何东西会过期:邮件会一直等待,直到被领取。

📜 历史记录

  • 历史 标签页在 已发送 和 已接收 标签页中显示你发送和接收的所有内容,无论是否已领取,并附有日期和状态。记录永久保留。

🔒 安全设计

  • 物品离开你的物品栏并进入数据库是一个单一操作:既不会丢失,也不会重复。
  • 数据库是 Epistula 自有的,内嵌于模组中。每次架构更新前都会创建副本。

🪙 附加金钱(可选)

  • 在管理员选择了 支付提供方 的情况下,邮件还可以携带 一定金额的金钱,每次发送需支付 手续费:固定基础费用加上金额的百分比。
  • 发送标签页会显示你的余额、金额和手续费。收件人用同一个按钮领取物品和金钱。
  • 提供方可以是 VaultUnlocked 中注册的任意经济系统,也可以是 通过其 API 在 Epistula 中注册的经济模组。没有提供方时,这些都不会显示,邮件免费。
  • 支付绝不会被重复扣款,即使服务器中途崩溃。当经济系统的响应始终未到达时,邮件会在管理员的 支付 标签页中等待核查。
  • 金钱始终以货币单位和阅读者的数字格式显示:英语中为 1,250,葡萄牙语中为 1.250。

🎡 与动作轮盘兼容(可选)

  • 配合 Actio(一个可选的动作轮盘模组),邮箱 会显示在其轮盘中(空手按住 E),位于 社交 下,有邮件待领取时显示红点。没有它时,邮件就是 /mail,一如既往。

🔌 供其他模组使用

  • 公共 API:其他模组可以向玩家投递邮件(物品、消息或金额,来自玩家或模组本身),用于奖励、通知,或将其旧邮件连同原始发送日期迁移到 Epistula。投递绝不会重复执行。
  • 其他模组也可以作为邮件的支付提供方。
  • 如果其他模组占用了 /mail 或 /epistula,服务器日志会说明是哪一个。

🛠️ 管理员菜单

  • /epistula admin 打开一个 游戏内管理员菜单,包含三个标签页:邮件(任意玩家的历史记录,在线或离线,带名称建议)、设置(config.json 的每个选项,带保存、撤销和重新加载文件)和 支付(待处理或等待管理员核查的支付)。
  • 窗口沿用作者其他模组的风格:游戏的蓝色、金色细节以及一封带火漆印章的信件。

要求

Hytale 服务器 0.7.x(Update 7)。已在 0.7.5 上测试
VaultUnlocked 可选:允许邮件携带其中注册的任意经济系统的金钱。已用 2.20.1 测试
带有自己提供方的经济模组 可选:同上,通过 Epistula API
Actio 可选:将其邮箱放入动作轮盘

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

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

安装

  1. 停止服务器。
  2. 将 Epistula-<version>.jar 放入服务器的 mods 文件夹。该文件夹中只保留一个 Epistula jar。
  3. 启动服务器。Epistula 会在 mods/Merlinz_Epistula/ 中创建其文件。
  4. 将自己设为 OP(在控制台中执行 /op add <name>),然后在游戏中输入 /epistula 以检查其是否已加载。
  5. 要将金钱附加到邮件,请在 config.json(PaymentProvider)或管理员菜单中选择一个提供方。

在服务器停止的情况下,备份 mods/Merlinz_Epistula/ 文件夹 以及 世界(universe/)。仅恢复其中之一可能导致邮件中的物品重复或丢失。

命令

玩家(无需权限)

命令 作用
/mail 打开邮箱
/mail <player> 打开发送标签页并预填玩家名称
/mail close 隐藏屏幕上的邮件提示

管理员

每个命令的权限为 merlinz.epistula.command. 后跟其路径。子命令还需要其上级命令的权限。OP 拥有所有这些权限。

命令 作用 权限
/epistula 提示模组已加载 merlinz.epistula.command.epistula
/epistula reload 无需重启重新加载 config.json merlinz.epistula.command.epistula.reload
/epistula admin 打开管理员菜单 merlinz.epistula.command.epistula.admin

配置

mods/Merlinz_Epistula/config.json,通过 /epistula reload 或管理员菜单应用:

键 默认值 作用
MailboxLimit 50 玩家邮箱中可容纳的待领取邮件数量,从 1 到 1000
PaymentProvider none 支付提供方:none、vaultunlocked,或由其他模组注册的提供方 ID
VaultUnlockedCurrency 空 VaultUnlocked 货币。留空使用经济系统的默认值。仅在 vaultunlocked 时使用
MailBaseFee 0 每次发送物品或金钱的手续费,以货币单位计(1.5 即 1.50),从 0 到 1,000,000,000
MailFeePercent 0 附加金额的百分比,加入手续费,从 0 到 100

无法读取的文件、包含未知键或值超出范围的文件会被整体拒绝,原因会记录在日志中,模组会保留其原有设置。

已知限制

  • 德语、西班牙语、法语、俄语和中文的翻译尚未经过母语者审校。服务器日志和配置文件错误始终为英语。
  • 消息不花费任何费用,因此玩家可以用消息填满另一位玩家的邮箱;它们会被逐一归档。
  • 游戏将物品栏保存在 Epistula 数据库之外。物品移动的瞬间发生服务器崩溃,是任何操作顺序都无法完全覆盖的唯一情况。

许可证

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

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


支持

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

Support Epistula on Ko-fi