BetterTalismans • Custom heads! Recipes! Permissions! Model data! Boosts! Folia support! - BetterTalismans - 自定义护符

💡重要须知

本插件需要 NBTAPI 才能运行！不支持 Plugman 或类似插件。这些护身符基于 Minecraft 属性系统工作，无法添加自定义药水效果等。请注意，护身符是真实的物品，卸载插件不会移除物品或效果。请尊重我的工作，您不得在任何整合包中重新分发此插件。仅支持每个主要 Minecraft 版本的最新版（例如，仅支持 1.16.5，不支持 1.16.4）。严禁在 MCBBS 或类似网站发布、移动或复制本插件。如果您想贡献母语翻译，欢迎私信我。

你是否曾想使用鞘翅，但又想保留胸甲的保护？是否想给玩家提供增强能力的物品？本插件正是为此而生。它允许服务器所有者创建带有自定义增益效果的物品，这些效果通过 NBT 标签实现，并可以拥有自定义合成配方和权限。

🎮核心特性

兼容性与支持

• 多版本支持 (Beta)：支持从 1.8.8 到最新的 Minecraft 版本。请务必使用对应版本的最新构建（例如，用 1.8.8 而非 1.8）。
• Folia 支持：自 v1.0-BETA 起官方支持 Folia。
• 新版检测系统：代码已更新，能更轻松地检查和比较版本，确保对 2026 年及以后新版本的兼容性。

护身符管理

• 无限护身符：可创建无限数量的护身符（此前限制为 54 个）。
• 自定义权限：可为每个护身符设置解锁合成配方的权限。
• 护身符 GUI：在 GUI 中展示所有可用护身符。未解锁的护身符会以自定义头颅图标隐藏。
• AI 辅助：提供由 Gemini 驱动的 AI 聊天机器人，协助您创建护身符（请注意测试）。
• 配方发现 (Beta，1.13+)：默认启用，允许玩家在加入时自动发现其拥有权限的配方。若禁用，玩家将忘记所有护身符配方。

增益效果类型

护身符可从以下增益效果中选择（注意：物品不能同时拥有所有效果，部分效果不可叠加）：

• 基础效果 (1.8.8+)：

- `HEALTH_BOOST` - 增加生命值。

- `KNOCKBACK_RESISTANCE` - 增加击退抗性。

- `MOVEMENT_SPEED` - 增加移动速度。

- `ATTACK_DAMAGE` - 增加物品伤害。

• 进阶效果 (1.9.2+)：

- `ARMOR` - 增加护甲值。

- `ARMOR_TOUGHNESS` - 增加盔甲韧性。

- `ATTACK_SPEED` - 增加攻击速度。

- `LUCK` - 增加地牢宝箱运气。

• 扩展效果 (1.20+)：

- `MAX_ABSORPTION` - 增加吸收生命值。

- `SCALE` - 改变玩家大小。

- `STEP_HEIGHT` - 无需跳跃即可踏上方块。

- `BLOCK_INTERACTION_RANGE` - 增加方块交互距离。

- `ENTITY_INTERACTION_RANGE` - 增加实体交互距离。

- `GRAVITY` - 改变重力强度。

- `SAFE_FALL_DISTANCE` - 增加安全坠落高度。

- `FALL_DAMAGE_MULTIPLIER` - 改变坠落伤害。

- `BLOCK_BREAK_SPEED` - 加快方块破坏速度。

- `JUMP_STRENGTH` - 增加跳跃高度。

- `BURNING_TIME` - 改变着火持续时间。

- `EXPLOSION_KNOCKBACK_RESISTANCE` - 抵抗爆炸击退。

- `MINING_EFFICIENCY` - 提高整体挖掘效率。

- `MOVEMENT_EFFICIENCY` - 改善困难地形移动。

- `OXYGEN_BONUS` - 增加水下呼吸时间。

- `SNEAKING_SPEED` - 增加潜行速度。

- `SUBMERGED_MINING_SPEED` - 加快水下挖掘速度。

- `SWEEPING_DAMAGE_RATIO` - 改善横扫攻击效果。

- `WATER_MOVEMENT_EFFICIENCY` - 加快水中移动速度。

• 最新效果 (1.21+)：

- `CAMERA_DISTANCE` - 改变摄像机缩放。

- `WAYPOINT_TRANSMIT_RANGE` - 发送路径点的范围。

- `WAYPOINT_RECEIVE_RANGE` - 接收路径点的范围。

物品自定义

• 自定义效果槽位 (1.9+)：可将增益效果限定在特定装备槽位生效（1.8.x 无效）。

- `MAIN_HAND` - 主手持有时生效。

- `OFF_HAND` - 副手持有时生效。

- `HEAD` / `CHEST` / `LEGS` / `FEET` - 对应盔甲槽位生效。

• 预设示例：默认包含“铁质/钻石/下界合金装甲鞘翅”（即鞘翅附带对应胸甲保护）和“提供额外速度的纹理头颅”。
• 显示与描述：可为每个护身符设置自定义显示名称和描述。
• 合成与材料：每个护身符可设置独立的合成配方和基础材料。
• 自定义头颅：支持使用自定义头颅纹理。
• 耐久度 (Beta)：可设置物品耐久（例如："DIAMOND_SWORD:50"），允许在旧版本使用染色物品，在新版本使用损坏物品。
• 染色物品 (Beta)：可为皮革盔甲、火焰弹、药水（仅新版本）设置颜色（注意：药水无法添加自定义效果）。
• 自定义模型数据：支持 1.14+ 版本的自定义纹理。
• 附魔与物品标签 (Beta)：可为护身符添加附魔，并选择要隐藏的物品标签（默认：ALL）。

功能与交互

• 命令别名 (Beta)：主命令为 /bettertalismans，默认别名 /btalismans。更改后需重启服务器生效。
• 配方查看：点击护身符 GUI 可查看合成配方。
• 给予命令：可通过命令将护身符给予玩家（控制台也可用）。
• 配方库存自定义 (Beta)：可设置填充空槽位的物品，并添加“返回护身符”按钮。
• 物品交互白名单 (Beta)：默认允许与武器、工具、盔甲及 PVP 相关物品交互。
• 实用子命令 (Beta)：

- `dropatlocation` - 在指定位置掉落护身符。

- `dropatplayer` - 在玩家位置掉落护身符。

• 配置自动更新：插件更新时配置文件会自动更新（注释会被移除）。
• 更新检查器：有新版本时会收到通知。

🔧配置文件

主要配置文件

• config.yml
• talismans.yml

✨安装与使用

安装步骤

• 从 SpigotMC.org 下载插件。
• 将 jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 按需编辑配置文件。
• 再次重启服务器。
• 权限可在配置文件中配置。

命令列表

• /bettertalismans test

- 给予所有护身符用于测试。

- 权限：仅 OP

• /bettertalismans talismans <玩家>

- 打开护身符 GUI。

- 权限：无（可配置）

• /bettertalismans give <玩家> <护身符>

- 将指定护身符给予玩家。

- 权限：`bettertalismans.admin`

• /bettertalismans reload

- 重载配置文件。

- 权限：`bettertalismans.admin`

❓常见问题

• 为什么标记为 Beta？有漏洞吗？

- 答：没有漏洞，我只是喜欢在发布插件时使用“BETA”标签。

• 为什么之前限制 54 个护身符？

- 答：因为库存最大容量是 54，而这是一个简单的插件，之前没考虑添加多页库存。**现在已取消限制**。

• 我可以将某些护身符限制给特定玩家使用吗？

- 答：只能限制合成和配方查看。使用是自由的，所有玩家都可以使用所有护身符。

• 我可以在 MCBBS 上发布这个插件吗？

- 答：**不可以**。

• 你确定吗？

- 答：是的，我确定。您不被允许发布它。

• 求助，插件在我的服务器上不工作！

- 答：请在评价前确保已安装所有依赖。如果错误仍然存在，请将启动时的控制台日志粘贴到 https://sourceb.in/ 并在讨论区发布，或加入我的 Discord 服务器。

⭐开发者相关

• 依赖：本插件需要 NBT API 来操作 NBT 标签。
• API 访问：可通过 com.alonsoaliaga.bettertalismans.api.BetterTalismansAPI 访问。
• 开发者文档：请查看我们的 GitHub 页面上的 DeveloperAPI。
• 漏洞与建议：如果您发现任何漏洞、错误或想请求新功能，请加入我的 Discord 或使用问题跟踪器。评价区不是报告错误的地方。

💡条款与条件

下载此资源即表示您同意以下所有条款

• 您不得以任何形式重新分发本插件，包括作为任何软件包的一部分。
• 您不得以任何形式反编译或修改本插件。
• 您不得声称此资源是您自己的创作。