
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 上测试 |
安装
- 停止服务器。
- 将
Epistula-<version>.jar放入服务器的mods文件夹。该文件夹中只保留一个 Epistula jar。 - 启动服务器。Epistula 会在
mods/Merlinz_Epistula/中创建其文件。 - 将自己设为 OP(在控制台中执行
/op add <name>),然后在游戏中输入/epistula以检查其是否已加载。 - 要将金钱附加到邮件,请在
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 上支持其开发。谢谢!
正在加载版本记录…










正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。