killCounter [Owner & Kills in item lore] Now with Placeholder API support! - killCounter - 击杀计数器

ItemStats 是一款为 Minecraft 物品添加击杀计数和所有者追踪功能的插件。它支持高度自定义的 Lore 显示、基于条件的动作触发，并与 PlaceholderAPI 完美集成，让你的武器和工具记录下每一次荣耀或诅咒。

💡核心功能

• 击杀计数：为物品记录击杀数，可区分玩家与生物击杀。
• 所有者系统：物品可绑定所有者，并可在特定条件下（如击杀原主）转移所有权。
• 高度可配置的 Lore：在物品 Lore 中动态显示所有者、击杀数、最后击杀坐标等信息，支持 PlaceholderAPI 占位符。
• 条件化动作系统：可配置在攻击、击杀或所有者变更时，根据击杀数、目标、PAPI 条件等触发命令、药水效果或消息。
• 物品白名单：可限制只有特定类型的物品（如剑、弓）才能获得击杀计数器。
• 全面的权限控制：每个功能都有独立的权限节点。
• 多版本兼容：支持从 1.4.7 到 1.8 的多个服务端版本。

🎮配置说明

以下为配置文件 config.yml 的主要选项详解。

基本设置

• position：击杀计数器信息在物品 Lore 中的位置，可选 above（在原有 Lore 上方）或 under（在下方）。
• mode：统计哪种击杀，可选 ALL（全部）、PLAYER_ONLY（仅玩家）、MOB_ONLY（仅生物）。
• changeOwner：设置为 true 时，当新玩家击杀物品原主，物品所有权将转移给新玩家。
• ownerDefault：新物品的默认所有者显示，通常设为 "none"。
• update-placeholderapi：设置为 true 时，每次击杀都会更新 PAPI 占位符；false 则仅在首次击杀时更新。
• update-on-equip：设置为 true 时，当玩家装备物品时会更新 Lore。
• disable-killcounter：包含此文本的 Lore 的物品将被插件忽略，不会获得击杀计数器。

物品 Lore 格式

item-lore 部分定义了显示在物品上的文本行。支持颜色代码和 PlaceholderAPI 占位符。

例如

item-lore:
- "&4---------------------------"
- "&4Owner: &c%itemStats_owner%"
- "&4Kills: &c%itemStats_kills%"
- "&4Last kill: &cX %player_x%&4, &cY %player_y%&4, &cZ %player_z%"
- "&4---------------------------"

物品白名单

• useWhitelist：设置为 true 以启用白名单功能。
• whitelist：列出允许获得击杀计数器的物品材料名（如 DIAMOND_SWORD, BOW）。材料列表请参考 Spigot API 文档。

动作与条件系统

在 actions 部分，你可以创建自定义动作，在特定事件（ATTACK, KILL, OWNER_CHANGE）下触发。

每个动作可以包含

• conditions：触发条件，例如击杀数范围（"KILLS 1 - 10"）、目标是否为所有者（"OWNER", "NON_OWNER"）或复杂的 PlaceholderAPI 条件。
• console_cmds / player_cmds：触发时执行的控制台或玩家命令，可使用 {0}（持有者）、{1}（目标）等占位符。
• potions：给予持有者的药水效果，格式为 "效果类型, 持续时间(刻), 等级"。
• chance：触发几率（0-100）。
• messages：发送给玩家的消息。
• permission：触发此动作所需的权限，设为 "none" 则无需权限。

**PAPI 条件示例**

conditions:
- "STRING(%player_hasitem-mat:TOTEM-amt:1%) = STRING(yes)"  # 仅当持有者拥有1个不死图腾时
- "STRING(%player_item_in_hand%) = STRING(DIAMOND_SWORD)" # 仅当持有者手持钻石剑时

对于数值比较，请使用 DOUBLE() 函数；对于字符串/布尔值比较，请使用 STRING() 函数。

消息自定义

在 messages 部分，你可以修改插件发送的所有提示信息，或通过设置为 "none" 来完全禁用某条消息。

🔧命令与权限

玩家命令

• /killcounter set [所有者] [击杀数]：为主手物品添加或修改击杀计数器。所有者与击杀数为可选参数。
• /killcounter reload：重载插件配置（需要管理员权限）。

权限节点

• killcounter.player.create：在首次击杀时获得击杀计数器的权限。
• killcounter.player.count：击杀被计入统计的权限。
• killcounter.player.own：通过击杀原主成为物品新所有者的权限。
• killcounter.player.use：触发 killCounter 动作的权限。
• killcounter.player.*：包含上述所有玩家权限。
• killcounter.admin.*：包含所有命令的管理员权限。

✨占位符支持

插件支持以下 PlaceholderAPI 占位符，可在 Lore 或消息中使用：

• %itemStats_owner%：物品当前所有者。
• %itemStats_kills%：物品总击杀数。
• %player_x%, %player_y%, %player_z%：玩家坐标（通常用于最后击杀位置）。

❓注意事项与未来计划

支持版本

本插件兼容 Spigot/CraftBukkit 1.4.7, 1.5, 1.6, 1.7 和 1.8 版本。

待开发功能

开发者计划在未来版本中添加

• 更优化的配置文件。
• 更多的动作类型和触发条件。
• 更多的命令和可配置消息。
• 扩展 PlaceholderAPI 占位符。

---

致谢：如果您觉得这个插件有用，可以考虑通过 Spigot 资源页面支持开发者。页面装饰协助可私信联系。