原创 闭源 BTTalismans - 高度可配置的背包护符系统 | 180+ 效果、117 个触发器、139 个条件 0.2.53

声明: 该插件的想法参考了talismans，但仅限于玩法，并未使用任何该插件中的的代码！

[MD] > 把物品放进背包，就能让它真正成为一枚护符。 BTTalismans 是一款面向 Paper 1.18.x-1.21.x 的自定义护符插件。玩家不需要装备护符，只要将它放在背包、末影箱或潜影盒中，就可以获得持续属性、战斗技能、条件增益、事件奖励等效果。 所有护符均通过 YAML 配置。你可以组合效果、触发器、条件、目标选择器、概率、冷却、延迟与数值表达式，制作从简单属性饰品到完整套装、职业被动和随机词条装备等玩法，无需编写 Java 代码。 ## 核心特色 ### 放在背包即可生效 护符可以从以下位置读取，每种来源都能独立开关： - 玩家背包，包括快捷栏、盔甲栏和副手 - 玩家末影箱 - 背包内潜影盒，自动展开一层 背包点击、拾取、丢弃、切换副手、穿脱装备、死亡重生等状态变化会实时刷新，低频扫描仅用于兜底。 ### 永久效果与触发式效果 同一套配置同时支持两种效果模型： - **永久效果**：不配置 `triggers`，持有护符期间持续生效，移除护符后自动撤销。 - **触发式效果**：配置一个或多个 `triggers`，在攻击、受伤、击杀、挖掘、交互、移动等事件发生时执行。 触发式效果可统一使用概率、经济消耗、次数间隔、表达式门槛、冷却、延迟、优先级和重复执行等参数。 ### 丰富的组合能力 当前 Wiki 已收录： - **180 个效果**：属性、伤害、治疗、药水、经济、物品、粒子、传送、范围技能、弹射物等 - **117 个触发器**：战斗、方块、物品、移动、钓鱼、聊天、生命周期及周期触发等 - **139 个条件**：玩家状态、权限、世界、实体、物品、经济、点数、PlaceholderAPI 比较等 - **目标管线**：选择目标后继续过滤和转换，可让效果作用于自身、受害者、附近实体、方块或事件位置 这些模块可以自由组合 ### 双层条件系统 条件可以写在护符根节点，也可以只限制某一条效果： - 护符级条件控制整枚护符是否生效 - 效果级条件只控制当前效果 - 所有条件支持 `inverse: true` 取反 - 条件不满足时可以执行 `not-met-effects` 备用效果 - 永久效果会随条件变化自动启用和回滚 例如可以制作“生命值低于 30% 时获得抗性，恢复后自动移除”的护符。 ### 完整的物品自定义 支持名称、Lore、材质、附魔光泽、自定义模型、Tooltip 样式、真实 NBT、物品标志、盔甲纹饰、颜色、耐久、最大堆叠等配置。 还可以设置随机或加权物品变量。变量结果会保存在物品自身，后续可用于名称、Lore、效果数值、条件和目标管线，非常适合制作随机品质与随机词条装备。 ### 等级覆盖与护符图鉴 通过 `higherLevelOf` 可以声明护符等级关系。玩家同时持有 I、II、III 级护符时，可只让最高等级生效，避免重复叠加。 内置可分页、可搜索的护符图鉴。管理员或玩家可以查看全部护符，普通点击领取 1 个，Shift 点击领取最大堆叠数量。 ### PlaceholderAPI 与内置点数 效果参数、条件、物品字段和目标管线均可使用 PlaceholderAPI。插件还提供： - 玩家自定义点数与服务器全局点数 - 当前护符物品的独立点数 - 护符数量、指定护符持有状态和生效状态变量 - BTStats 属性值读取与属性效果联动 ## 配置示例 ### 最简单的永久护符 下面这枚护符放在背包期间提供 10% 移速，移出背包后自动恢复： ```yaml 疾风护符: material: FEATHER name: "&b疾风护符" lore: - "&7持有期间移动速度 +10%" glow: true effects: - id: movement_speed_multiplier args: multiplier: 1.1 ``` ### 带概率与冷却的战斗护符 玩家近战命中目标时，有 30% 概率追加 4 点伤害，并进入 5 秒冷却： ```yaml 猎手徽记: material: RABBIT_FOOT name: "&6猎手徽记" effects: - id: add_damage args: amount: 4 chance: 30 cooldown: 100 cooldown_message: "&7技能冷却中，还剩 &f%seconds% &7秒" triggers: - melee_attack ``` ### 条件、目标与范围效果 潜行攻击时，使受害者周围 5 格内的敌对生物中毒： ```yaml 瘟疫核心: material: FERMENTED_SPIDER_EYE name: "&2瘟疫核心" effects: - id: potion_effect args: effect: POISON amplifier: 0 duration: 100 triggers: - melee_attack conditions: - id: is_sneaking targets: selector: id: nearby_entities args: source: victim radius: 5 filters: - living_entity - hostile - not_self ``` ### PlaceholderAPI 动态数值 数值参数支持 PlaceholderAPI 和表达式： ```yaml 成长护符: material: NETHER_STAR name: "&d成长护符" effects: - id: max_health args: amount: "20 + (%player_level% / 2)" ``` ## 可选兼容 插件核心功能可以独立运行，以下插件均为可选联动： - PlaceholderAPI - Vault 与 Vault 经济插件 - PlayerPoints - MythicMobs - NeigeItems - MMOItems - ItemsAdder - CraftEngine - CraneAttribute - BTStats - BTEconomy - BTDungeons - WorldGuard 同时提供开发者 API，可由其它插件注册自定义效果、触发器和条件。 ## 常用命令 | 命令 | 用途 | |---|---| | `/btt give <玩家> <护符ID> [数量]` | 给予护符 | | `/btt givesilent <玩家> <护符ID> [数量]` | 静默给予护符 | | `/btt list` | 查看已加载护符及效果绑定 | | `/btt gui` | 打开护符图鉴 | | `/btt active` | 查看当前生效护符 | | `/btt reload` | 重载配置 | 所有命令均支持 Tab 补全，提示文本可在 `messages.yml` 中修改或关闭。 ## 适合哪些服务器 BTTalismans 适合 RPG、生存、空岛、地牢、冒险、装备养成和赛季制服务器。它既可以只承担一个轻量的背包饰品系统，也可以作为职业被动、套装核心、随机词条、成长装备与事件技能的配置底层。 [/MD]