ItemMail 4

插件

· 作者 _ForgeUser7489212

ItemMail 4

0 本站下载 0 关注 更新于 9 年前
一键开服(送7天)

ItemMail

ItemMail 为玩家提供了一种更简便的交易方式。其 MySQL 集成非常适合云服务器。

功能

  • 玩家可以向其他玩家发送物品,也可以请求物品
  • 友好的显示名称!不确定你有哪些颜色的羊毛?ItemMail 确保你 确切地 知道自己将获得什么。
  • 全新的序列化系统!从 ItemMail 4 版本开始,玩家不会再丢失任何数据(如书籍中的文字)。
  • MySQL 集成,非常适合云服务器。

新数据系统

ItemMail 4 版本引入了新的数据存储系统,物品的保存方式不同,但效率更高!这需要一个新的 MySQL 表。所有操作均为自动完成,您只需输入一条命令:

  • /im convert

该命令会将旧表中任何未读邮件/请求转换为新格式,并放入新表中!如果您在 4 版本之前使用过 ItemMail,在安装时请务必运行此命令。

关于物品如何序列化的完整文档可在 找到

命令

  • /im accept [id] - 接受一个物品请求 (ItemRequest)
  • /im convert - 将旧数据转换为新格式
  • /im decline [id/*] - 拒绝物品请求
  • /im delete [id/*] - 删除物品邮件 (ItemMail)
  • /im mb - 查看您的物品邮箱 (ItemMailBox)
  • /im mail-info [id] - 查看邮件的详细信息
  • /im open [id] - 打开物品邮件
  • /im rb - 查看您的物品请求箱 (ItemRequestBox)
  • /im request <player> <item[:damage]> [amount] - 向玩家请求物品
  • /im request-info [id] - 查看请求的详细信息
  • /im send <player> [item[:damage]] [amount] - 发送物品邮件

[id] 指的是玩家物品邮箱或物品请求箱中每个物品旁边的数字

星号 (*) 是“全部”的另一种说法。

权限

  • ItemMail.admin.convert - 允许玩家运行 '/im convert' 命令
  • ItemMail.general.mail.delete - 允许玩家删除物品邮件
  • ItemMail.general.mail.open - 允许玩家打开物品邮件
  • ItemMail.general.mail.send - 允许玩家发送物品邮件
  • ItemMail.general.mail.view-info - 允许玩家查看物品邮件的详细信息
  • ItemMail.general.mailbox.view - 允许玩家查看其物品邮箱
  • ItemMail.general.request.accept - 允许玩家接受物品请求
  • ItemMail.general.request.decline - 允许玩家拒绝物品请求
  • ItemMail.general.request.send - 允许玩家发送物品请求
  • ItemMail.general.request.view-info - 允许玩家查看物品请求的信息
  • ItemMail.general.requestbox.view - 允许玩家查看其物品请求箱

依赖项

ItemMail 需要 TacoAPI v2.4 或更高版本 才能运行。

提示

权限

可以使用星号 (*) 授予玩家以星号前所有内容开头的所有权限

示例

  • ItemMail.general.* - 给予玩家所有 'general' 权限
  • ItemMail.general.mail.* - 给予玩家所有与邮件相关的权限
  • ItemMail.general.request.* - 给予玩家所有与请求相关的权限
  • ItemMail.* - 给予玩家所有权限

发送邮件

当您有一个想要发送的物品,且它符合以下任一描述时:

  • 它有自定义名称
  • 它有附魔
  • 它是书,且里面有文字
  • 它是已填写的书
  • 它是附魔书
  • 它是皮革护甲,且已被染色

那么您需要将其放在快捷栏中,手持该物品,并使用 /im send <player> 来发送它。如果不这样做,可能会丢失部分数据,因此最好使用此方法。这类物品无论如何都无法堆叠,所以您有什么可损失的呢?

Unicode 字符

大多数 MySQL 服务器会使用 latin2 字符集创建数据库(具体取决于位置)。如果您的服务器有使用不同语言打字/说话的玩家,您可能希望使用 Unicode 字符集。以下是将字符集更改为 Unicode 的方法,具体取决于您使用的是 SQL Buddy 还是 phpMyAdmin

SQL Buddy

  1. 找出表所在的数据库。这可以通过引用 TacoAPI 的 config.yml 找到
  2. 登录 SQL Buddy 时,左侧 'Databases' 下应该有一个数据库列表。选择正确的数据库。
  3. 导航到 'itemmail' 表
  4. 您现在应该在页面顶部看到 'Browse'、'Structure'、'Insert'、'Query' 等选项。点击 'Structure'
  5. 您现在应该看到一个列名列表,旁边带有复选框。选中 'item' 旁边的复选框,然后点击表格上方的 'edit'
  6. 在下一页上,您将看到一个下拉框旁边的 'Charset:'。在下拉框中选择 'utf8'。
  7. 点击提交。

phpMyAdmin

  1. 找出表所在的数据库。这可以通过引用 TacoAPI 的 config.yml 找到
  2. 登录 phpMyAdmin 时,左侧应该有一个数据库列表。
  3. 导航到 'itemmail' 表
  4. 您现在应该在页面顶部看到 'Browse'、'Structure'、'Insert'、'Query' 等选项。点击 'Structure'
  5. 您现在应该看到一个列名列表,旁边带有复选框。找到 'item' 并点击 'Change'(铅笔旁边)
  6. 在 'Collation' 下,将其更改为 'utf8generalci'。
  7. 点击保存。

对于开发者

ItemMail 拥有自定义事件。这些事件包括:

  • ItemMailSentEvent - 当玩家发送邮件时触发
  • ItemMailOpenedEvent - 当玩家打开邮件时触发
  • ItemRequestSentEvent - 当玩家发送请求时触发
  • ItemRequestAcceptedEvent - 当玩家接受请求时触发
  • ItemRequestDeclinedEvent - 当玩家拒绝请求时触发

如果您计划调用以下任一方法 -

  • ItemMail.send()
  • ItemMail.open()
  • ItemRequest.send()
  • ItemRequest.accept()
  • ItemRequest.decline()

那么您需要根据需要移除或给予物品(TacoAPI 中提供,或者您可以使用自己的方法)。物品的移除/添加操作是在相应的 TacoCommand 类中完成的,而不是在 ItemMail/ItemRequest 类中。这样做是为了让开发者/我自己能够从一个不存在的玩家处发送 ItemMail。例如,如果插件将 ItemMail 用作一种奖励系统。

如果您打算在自己的插件中使用 ItemMail 作为奖励系统,最好使用 ItemMail.sendUnsafely()(静态方法)。使用此方法时不会触发 ItemMailSentEvent。

有用链接

ItemMail 是一个开源插件。源代码可以在 GitHub 找到

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源