AdvancedGift - 高级礼物系统

本插件即将停止对 SpigotMC 的支持。有关此变更的详情，请点击此处阅读。

*************************************************************

v1.10 版本现已支持 MC 1.8.8！

赠送礼物从未如此先进…且简单！

厌倦了必须发送传送请求才能给玩家送礼吗？不想在传送到玩家身边时掉入死亡陷阱吗？只是想要一种简单的送礼方式？但找到的礼物插件要么过时，要么缺少你想要的功能？那么，不用再找了！AdvancedGift 就是为你准备的！它轻量级，并拥有许多其他礼物插件缺失的功能！只要我还在，它就会持续更新以支持新的服务器版本！

💡关于 AdvancedGift

我的目标是将此插件打造成一个易于使用、满足所有人需求的礼物插件。如果它缺少你想要的功能，或者你对现有功能不满意，欢迎在 Discord 服务器上提出建议！

⭐功能特性

• 完全可定制的插件消息！
• 远距离送礼！ 无需传送请求！
• 玩家可以发送手中的物品，或任意数量（只要他们拥有足够数量）！
• 可附加留言 到礼物中！
• 可以屏蔽来自特定玩家或所有人的礼物！
• 为管理员提供监视礼物交换的能力！
• 可选项：为送礼添加冷却时间！
• 可选项：审查留言内容！
• 可选项：限制不同世界群组间的礼物交换！
• 几乎所有的礼物活动都会记录在控制台中！
• 几乎完全可配置！
• 更多功能即将推出！

🔧教程/展示视频

如果你制作了关于 AdvancedGift 的视频，我很乐意将其添加至此！只需将你的教程链接通过私信发送给我即可。

视频列表：

• 1.9.5 版本演示
• 1.10 版本展示

✨安装指南

注意： 请务必仔细阅读并遵循指示。

• 下载 AdvancedGift 的最新版本。

- **注意：** 如果你的服务器同时使用 ArtMap 插件，请确保其已更新至最新版本！AdvancedGift 部分代码依赖的 ArtMap 功能在旧版本中可能不存在。

• （可选） 如果你的服务器版本为 1.12 或更低，可下载 Language Utils。

- **注意：** 主要下载链接适用于 1.12 版本。如果你使用 1.11 或更低版本，请在帖子中查找适用于你版本的正确下载链接。

- 对于 **1.13 或更高版本** 的服务器，可跳过此步。

• 将下载的文件放入服务器的 plugins 文件夹。
• 启动服务器，如果服务器已在运行则重启。
• 此时会创建一个名为 AdvancedGift 的新文件夹。

- 如果你添加了 Language Utils，还会出现一个名为 `LangUtils` 的文件夹，忽略即可。

• 在 AdvancedGift 文件夹内，应有两个文件：config.yml 和 playerinfo.json。打开配置文件 (config.yml)，并根据你的喜好进行编辑。

- **注意：** 请勿编辑 `playerinfo.json` 文件，这可能导致插件加载/读取时出现问题。

• 编辑完成后保存配置。
• 在控制台输入 agr（不带引号）并按回车。或者在游戏内执行 /agr。

- **注意：** 在游戏内使用此命令，你需要是 OP 或拥有 `advancedgift.reload` 权限。

- **切勿使用 `/reload`** 重载插件，这可能导致插件损坏或后续出现问题。

• 给予玩家相应的权限。可用权限列表请查看下方的“权限”部分。
• 完成！

🎮配置说明

以下是 AdvancedGift v1.12 版本配置文件 (config.yml) 的内容示例。

配置项详解：

# 插件与玩家通信时使用的前缀。支持颜色代码。
# 前缀后会自动添加一个空格，因此此处无需添加。
prefix: '&6[AdvancedGift] '

# 语言区域设置。
locale: en_US

# 是否在悬停于礼物通知时显示物品提示信息。
# 重启服务器后生效。
enable-tooltip: true

# 是否启用 /gift 命令的冷却时间。
# 冷却时间仅在玩家成功发送礼物后生效。
enable-cooldown: false

# 冷却时间长度（单位：秒）。建议设置在 5 到 60 秒之间。
# 如果你让冷却时间超过一分钟，那你真是个“魔鬼”。
# 设置为 0 秒毫无意义，只需将 “enable-cooldown” 设为 false 即可。
cooldown-time: 10

# 是否启用礼物留言功能。
# 如果为 true，玩家将能够随礼物发送一条留言。
# 如果为 false，插件将不会显示任何关于留言功能的提示。
allow-gift-message: true

# 是否启用留言审查。
# 如果为 true，插件将检查礼物留言中是否包含屏蔽词，并替换找到的词汇。
# 如果为 false，插件将原样发送留言。
# 插件将从下方的 “word-filter” 列表中读取屏蔽词。
# 检查时将忽略所有非字母数字字符。
message-censorship: false

# 决定插件如何处理包含屏蔽词的留言。
# WITH: 插件将发送经过审查（替换）后的留言及礼物。
# WITHOUT: 插件将移除留言，仅发送礼物。
# BLOCK: 插件将阻止玩家发送该礼物。
send-censored-message: BLOCK

# 屏蔽词列表。
# 支持通配符 (*)。详情见下文。
word-filter:
  - fuck*
  - shit*
  - ass
  - dumbass
  - bitch
  - bastard

# 是否限制不同世界间的礼物交换。
restrict-interworld-gift: false

# 世界群组列表。
# 礼物交换将不会在不同群组的世界之间进行。
# 任何未列出的世界将被视为黑名单，所有礼物活动在这些世界将被阻止。
world-group-list:
  - test1
  - 'test2, test3'
  - 'world, world_nether, world_the_end'

通配符使用说明

在屏蔽词列表中，通配符 * 会影响插件读取和比对礼物留言的方式。

• **关键词：插件将检查留言中的词语是否在任何位置**包含该屏蔽词。

- **示例：** 屏蔽词：`*fuck*`，留言：“这真是场精神折磨 (mind-fuckery)。”，审查后留言：“这真是场***。”

• ***关键词：插件将检查留言中的词语是否以该屏蔽词结尾**。

- **示例：** 屏蔽词：`*ass`，留言：“你是个蠢货 (dumbass)。”，审查后留言：“你是个***。”

• **关键词*：插件将检查留言中的词语是否以该屏蔽词开头**。

- **示例：** 屏蔽词：`shit*`，留言：“给你个糟糕 (shitty) 的礼物。”，审查后留言：“给你个***的礼物。”

• 无通配符的关键词：只有当留言中的词语完全匹配屏蔽词时才会被替换。

- **示例：** 屏蔽词：`bitch`，留言：“你只会抱怨 (bitching) 一切。别这么刻薄 (bitch)。”，审查后留言：“你只会抱怨 (bitching) 一切。别这么***。”

注意： 如果在词语开头使用通配符，需要用引号将整个词括起来（例如 '*关键词'），否则配置文件可能无法正确加载。

🔧命令列表

• /gift [玩家] <数量 | hand | all> <留言>

- **别名：** `sendgift`, `giftsend`

- **功能：** 向第一个参数指定的目标玩家发送礼物，并可附加留言。目标必须在线。

- **参数说明：**

- `玩家`：目标玩家名。

- `数量 | hand | all`：可选。`hand` 发送手中物品；`all` 发送背包中所有与手中物品相同的物品；`数量` 为具体数字，必须是大于零的整数。

- `留言`：随礼物发送的留言内容。

• /togglegift

- **别名：** `gifttoggle`, `tg`, `gt`

- **功能：** 切换你接收礼物的能力。支持 `on/off` 和 `enable/disable`。`on` 或 `enable` 启用接收，允许所有人发送礼物；`off` 或 `disable` 禁用接收，阻止所有人发送礼物。

• /giftblock

- **别名：** `blockgift`, `gblock`

- **功能：** 屏蔽特定玩家，使其无法向你发送礼物。

• /giftunblock

- **别名：** `unblockgift`, `gunblock`, `ungblock`

- **功能：** 解除对特定玩家的屏蔽，允许他们向你发送礼物。

• /giftblocklist

- **别名：** `gblocklist`, `gblist`

- **功能：** 列出你已屏蔽送礼的玩家。在命令后添加 `clear` 可清空屏蔽列表。

• /giftspy

- **别名：** `gspy`

- **功能：** 监视礼物交换，以发现绕过过滤器的违规礼物或留言。支持 `on/off` 和 `enable/disable`。

• /agreload

- **别名：** `agr`

- **功能：** 重载 AdvancedGift 的配置文件。

• /agtranslate <语言区域>

- **功能：** 以指定的语言区域创建可定制的翻译文件。若留空，则使用配置文件中设置的区域。

❓权限节点

• advancedgift.gift.send：允许玩家发送礼物。如果目标没有接收权限则会失败。默认所有玩家拥有。
• advancedgift.gift.receive：允许玩家接收礼物。默认所有玩家拥有。
• advancedgift.gift.message：允许玩家随礼物发送留言。默认所有玩家拥有。
• advancedgift.gift.spy：允许玩家监视礼物交换。默认 OP 拥有。
• advancedgift.bypass.cooldown：允许玩家忽略 /gift 命令的冷却时间。
• advancedgift.bypass.world.restriction：允许玩家绕过世界群组限制，在不同群组的世界间发送礼物。
• advancedgift.bypass.world.blacklist：允许玩家无视黑名单世界限制发送礼物（无论自己或目标是否在黑名单世界）。
• advancedgift.bypass.vanish：允许玩家向处于隐身状态的玩家发送礼物。默认 OP 拥有。
• advancedgift.reload：允许玩家重载 AdvancedGift 的配置。默认 OP 拥有。
• advancedgift.translate：允许使用 /agtranslate 命令创建可定制的翻译文件。默认 OP 拥有。

🔧支持与反馈

喜欢这个插件吗？太好了！请考虑留下评论。

发现 Bug 或需要帮助？联系我的最佳方式是通过 Discord：https://discord.gg/wvFNxAaEAu

请在 Discord 上报告你遇到的任何插件问题或 Bug。也欢迎在那里提出建议。我不常活跃于本论坛，因此如果你在此发帖，我可能需要很长时间才能看到。