Piñata - 彩罐插件

💡项目已归档

本项目已于 2019 年 5 月 19 日根据社区投票归档。不再提供支持，项目已停止维护。

🎮简介

这是一个独特的皮纳塔插件！你可以购买或生成配置好的皮纳塔，打破它们以获得掉落物。插件高度可定制，允许你创建多种类型的皮纳塔（例如食物/金钱皮纳塔）。你可以使用多种掉落类型，如物品、命令、枪械或金钱。皮纳塔生物可以是任何生物类型（如果是绵羊，还可以染成 16 种不同的颜色）。想把它用作皮纳塔箱子插件？没问题！自 2.0.0 版本起，你可以创建皮纳塔箱子。

✨主要特性

• 权限控制的皮纳塔
• 自定义皮纳塔生物类型 (v2.3.0+)
• 个人皮纳塔与全局皮纳塔类型 (v1.2.0+)
• 用于预览掉落物和皮纳塔列表的 GUI (v1.2.2+)
• 可配置大部分消息
• 可购买的皮纳塔 (需要 Vault)
• 皮纳塔验证器 (防止创建错误的皮纳塔)
• 4 种掉落类型 (物品、命令、金钱、枪械)
• 绵羊的 16 种染料颜色 (参见创建皮纳塔部分)
• 禁用世界功能 (v2.2.10+)
• 支持 1.9 - 1.13 版本
• 插件 API (v1.3.0+)
• 皮纳塔箱子 (v2.0.0+)
• 失明效果，用于更真实的皮纳塔打破体验 (v2.2.7+)
• 多语言支持 (本地化 - l12n) (v2.6.0+)
• 编辑命令，用于在游戏内编辑皮纳塔 (v3.0.0+)
• 通过编辑命令创建皮纳塔 GUI (v3.0.0+)
• 皮纳塔与掉落物颜色支持 (v3.0.0+)

可选依赖

• Holographic Displays (自 v2.0.4 起可选)
• Vault (可选)
• CrackShot (可选)

🔧命令

命令格式说明：[必选参数]， <可选参数>

• /pinata new [pinata] - 创建一个新的皮纳塔
• /pinata create [pinata] <目标玩家> - 创建已存在的皮纳塔。或 /pinata create [世界] [x坐标] [y坐标] [z坐标] [pinata] - 在自定义位置创建皮纳塔
• /pinata edit [pinata] - 编辑皮纳塔
• /pinata buy [pinata] - 购买已存在的皮纳塔 (需要 Vault)
• /pinata list - 列出所有皮纳塔
• /pinata preview [pinata] - 预览皮纳塔掉落物
• /pinata reloadconfig - 重载配置文件
• /pinata setcrate - 在指定位置设置皮纳塔箱子
• /pinata cratelist - 显示所有已创建的箱子
• /pinata setchance - 设置皮纳塔掉落物的几率

⭐权限

• pinata.* - 所有皮纳塔命令和权限的权限包 (包括管理员命令)
• pinata.player.* - 箱子和命令权限包
• pinata.player.crate - 授予使用箱子的权限
• pinata.player.sign - 使用皮纳塔告示牌的权限
• pinata.command.* - 授予使用所有命令的权限
• pinata.command - 使用 /pinata 命令的主要权限
• pinata.command.list - /pinata list 命令权限
• pinata.command.buy - /pinata buy 命令权限
• pinata.command.preview - /pinata preview 命令权限
• pinata.admin.* - 授予所有管理员权限
• pinata.admin.reload - /pinata reloadconfig 命令权限
• pinata.admin.create - /pinata create 命令权限
• pinata.admin.create.others - 为其他玩家创建皮纳塔的权限
• pinata.admin.notify - 加入服务器时接收插件更新通知的权限
• pinata.admin.freeall - 免费购买所有皮纳塔的权限
• pinata.admin.crate.destroy - 销毁箱子的权限
• pinata.admin.crate.list - /pinata cratelist 命令权限
• pinata.admin.crate.set - /pinata setcrate 命令权限
• pinata.admin.sign.set - 设置皮纳塔告示牌的权限
• pinata.admin.sign.destroy - 销毁皮纳塔告示牌的权限
• pinata.admin.newpinata - 创建新皮纳塔的权限
• pinata.admin.edit - 编辑皮纳塔的权限
• pinata.use.default - 使用预配置的“default”皮纳塔的权限 (可为每个皮纳塔编辑权限)

❓配置与文件

主要配置文件

• config.yml
• pinatas.yml

翻译文件

翻译文件的“版本”号越高，翻译过时的程度越低。

• language.yml (默认) (英语 en-GB) (始终最新)
• language_pl.yml (波兰语 pl-PL) (版本 9)
• language_fr.yml (法语 fr-FR) (版本 9) (感谢 @OzaX_0maZa)
• language_de.yml (德语 de-DE) (版本 9) (感谢 @Elternbrief)
• language_nl.yml (荷兰语 nl-NL) (版本 9) (感谢 @TomTheDeveloper)
• language_es.yml (西班牙语 es-AR) (版本 9) (感谢 @adolfo_garolfo)
• language_hu.yml (匈牙利语 hu) (版本 11) (感谢 montlikadani)

**注意**

• (2.6.0+) 使用这些翻译文件的方式现已弃用。插件已实现本地化支持。
• (3.0.0+) 插件已重新实现本地化支持。你可以向我发送更新或新的语言文件，我会尽快添加。

config.yml 示例片段

# 是否对每个皮纳塔使用权限？
using-permissions: true
# 通知插件更新吗？
Update-Notifier:
  Enabled: true
  Notify-Beta-Versions: true
# 你可以在此修改插件的默认区域设置。
# 可用的区域设置：
# en - 英语 (默认)
# pl - 波兰语 / Polski
# fr - 法语 / Français
# de - 德语 / Deutsch
# nl - 荷兰语 / Nederlands
# es - 西班牙语 / Español
# hu - 匈牙利语 / Magyar
locale: en

创建皮纳塔

皮纳塔的创建在 pinata_storage.yml 文件中有详细说明。如果你需要更多信息或有不明白的地方，可以发送私信联系我。

🔧常见问题

在哪里报告漏洞或提出建议？

• 点击此处向我发送私信。

我的皮纳塔没有生成！

• 确保没有任何插件（例如 WorldGuard）在你所在的位置阻止生物生成。如果是，请确保允许在那里生成生物。

有占位符吗？

• 你可以在命令掉落物和全息名称中使用 %player% 占位符。

你会更新这个插件吗？

• 是的！我已经添加了更新通知器，所以当有更新时你会收到通知！

如何使用 Pinata API？ (v1.3.0+)

• 关于事件和方法，请查看此 Java 文档：https://jd.plajer.xyz/minecraft/pinata/

如何使用皮纳塔箱子？ (v2.0.0+)

• 在选定的位置放置一个箱子。
• 看着放置的箱子，输入命令 /pinata setcrate <箱子名称>。
• 完成！现在你可以在箱子里购买皮纳塔了！

(要移除箱子，只需破坏它，不要使用 WorldEdit 等工具来移除箱子！！)

如何启用/禁用万圣节模式？ (v2.1.0+)

• 默认情况下万圣节模式是禁用的，你可以在 config.yml 中启用它。
• 只需在你的 config.yml 中添加这行：halloween-mode: true (自 v2.2.7 起配置会自动更新)
• 输入 /pinata reloadconfig 即可！

如何创建皮纳塔告示牌？ (v2.4.0+)

在告示牌的各行按顺序输入以下信息

• 第 1 行 - [Pinata]
• 第 2 行 - all 或 皮纳塔名称
• all - 将打开包含所有皮纳塔的 GUI
• 皮纳塔名称 - 将购买指定名称的皮纳塔 (价格在 pinata_storage.yml 中配置)

如何在随机自定义位置生成皮纳塔？ (v2.5.1+)

• 只需在 X、Y 或 Z 坐标中使用 ~ 字符。
• 例如：/pinata create world 14~50 80 100 default
• 这将在 X 坐标 14 到 50 之间随机、Y 坐标 80、Z 坐标 100 的位置创建皮纳塔。

如何更改插件区域设置？有多少种区域设置？ (v2.6.0+)

• 目前有：英语、波兰语、德语、法语、西班牙语和荷兰语区域设置。
• 要启用区域设置，请编辑 config.yml 中的 locale 值为以下前缀：
• 英语 - en
• 波兰语 - pl
• 德语 - de
• 法语 - fr
• 西班牙语 - es
• 荷兰语 - nl

关于数据统计

• 本插件使用 bStats 发送匿名数据。请不要禁用它，因为这能激励开发者！

---

版权信息 ⓒ 2019 - Plajer‘s Lair， Pinata 项目由 @Plajer 创建。