ItemCounters
用于工具、武器和护甲的计数器。追踪已破坏的方块、击杀生物与玩家的数量以及受到的伤害。包含排行榜、里程碑奖励及 PlaceholderAPI 支持。
Русское описание / Russian description
ItemCounters
用于工具、武器和护甲的计数器:已破坏的方块、生物与玩家击杀数、所受伤害。提供排行榜、成就奖励及 PlaceholderAPI 支持。
要求: Minecraft 1.21.10,Paper/Purpur,Java 21。PlaceholderAPI 为可选。
安装与使用
将插件 JAR 文件放入 plugins/ 文件夹并启动服务器。设置将在 plugins/ItemCounters/config.yml 中生成,语言翻译文件位于 plugins/ItemCounters/lang/。
通过命令 /counter give <玩家> 发放计数器。在铁砧中,将合适的物品放在左侧,将已发放的计数器放在右侧,然后取出结果。默认使用指南针。应用免费。普通指南针及仅复制名称的物品不适用。每次消耗一个计数器;禁止对同一物品重复应用。
统计内容
| 物品 |
统计数据 |
| 镐、铲、锄 |
所有已破坏的方块 |
| 斧头 |
所有已破坏的方块,包括石头 |
| 剑、巨锤、弓、弩、三叉戟 |
分别统计生物与玩家击杀数 |
| 头盔、胸甲、护腿、靴子 |
所受伤害(以心为单位):1 ❤ = 2 HP |
仅统计带有计数器的物品。经过减免和吸收后的伤害会在佩戴的带计数器护甲部件间分配;在玩家排行榜中,该伤害仅计算一次。对于箭矢和三叉戟,会记录发射它们的武器。切换手持物品不会将击杀转移至其他物品。
被取消的操作不计入统计。创造模式下计数默认关闭。旁观者模式不起作用。不支持鞘翅、剪刀和狼铠。物品的名称、附魔及其他描述信息得以保留。计数器随物品一起传递;没有死亡掉落保护。
命令与权限
<...> 中的参数为必填,[...] 中的参数为选填。物品命令作用于选定在线玩家的主手。若未指定玩家名,则操作你的主手。从控制台执行时,必须指定玩家名。
| 命令 |
作用 |
/counter help |
帮助信息 |
/counter give <玩家> |
发放一个计数器 |
/counter apply [玩家] |
无需使用铁砧即可应用计数器 |
/counter remove [玩家] |
从物品上移除计数器 |
/counter inspect [玩家] |
查看物品的统计数据 |
/counter set <属性> <数值> [玩家] |
设置值 |
/counter add <属性> <数值> [玩家] |
增加值 |
/counter subtract <属性> <数值> [玩家] |
减少值 |
/counter top <类别> <daily|weekly|alltime> [页码] |
打开排行榜 |
/counter reload |
重新加载配置与翻译文件 |
可用属性:blocks(方块)、wood(木材)、mob_kills(生物击杀)、player_kills(玩家击杀)、damage(伤害)。请根据物品类型选择合适的属性。value 可替代 blocks/wood/damage;total_kills 会自动计算得出。对于方块数量与击杀数需使用整数,伤害值允许为小数。所有数值不会低于零。管理员的修改操作不会影响玩家的排名成绩。
默认情况下,所有玩家均拥有 itemcounters.use(查看帮助)和 itemcounters.top(查看排行榜)权限。管理员权限包括:itemcounters.admin.give、.apply、.remove、.inspect、.reload、.edit。以 itemcounters.admin 开头的命令对应 .edit 权限,该权限允许执行 set/add/subtract 操作。所有管理员权限默认仅授予 OP(管理员玩家)。itemcounters.admin 权限将整合上述所有管理功能。
排行榜
支持类别:pickaxe(镐)、shovel(锹)、hoe(锄)、axe(斧)、sword(剑)、mace(战锤)、bow(弓)、crossbow(弩)、trident(三叉戟)、armor(护甲)、mixed(混合)。通用类别 blocks、wood、kills、damage 同样可用。
时间周期:daily(每日)、weekly(每周)、alltime(历史总计)。mixed 类别会针对每位玩家展示其在各类工具中取得的最高单项数值,且不会累加不同计数器的结果。示例命令:/counter top mixed alltime。
排行榜归属权绑定于玩家账号:即使交易或转移物品,也不会改变该物品的排名归属。每日与每周统计数据的结算依据服务器时区或配置文件中指定的时区进行切换。
PlaceholderAPI:手持物品
物品相关的占位符将读取玩家主手所持的物品。此扩展已内置于插件中,无需通过 eCloud 单独下载。
| 占位符 |
结果 |
%counter_has% |
是否存在计数器:true/false |
%counter_type% |
blocks(方块)、wood(木材)、weapon(武器)或 armor(护甲) |
%counter_value% |
带格式化的主要数值 |
%counter_raw_value% |
不带格式化的原始主要数值 |
%counter_mob_kills% |
生物击杀数 |
%counter_player_kills% |
玩家击杀数 |
%counter_total_kills% |
总击杀数 |
%counter_damage% |
以心数为单位的伤害量 |
%counter_unit% |
带有正确词形的单位标签 |
%counter_id% |
物品的唯一 ID |
%counter_block_word%, %counter_kill_word% |
“方块” / “击杀” 的词形变化 |
%counter_mob_word%, %counter_player_word%, %counter_heart_word% |
“生物” / “玩家” / “心” 的词形变化 |
排行榜占位符
排行榜通过 PlaceholderAPI 实现,且不依赖于手持物品。格式为:%counter_top_<类别>_<周期>_<排名>_<字段>%。排名从 1 开始。
示例:Alex 在总榜中排名第一,使用镐子采集了 2 个方块。插件语言设置为 ru_RU,采用默认样式。以下是占位符的字面返回值。请将 mixed、alltime 和 1 替换为所需的类别、周期和排名。
| Плейсхолдер |
Что показывает |
Пример ответа |
%counter_top_mixed_alltime_1_name% |
Ник игрока |
Alex |
%counter_top_mixed_alltime_1_value% |
Число с действием |
2 блока киркой |
%counter_top_mixed_alltime_1_raw% |
Число без форматирования |
2 |
%counter_top_mixed_alltime_1_position% |
Место |
1 |
%counter_top_mixed_alltime_1_category% |
Категория результата |
pickaxe |
%counter_top_mixed_alltime_1_action% |
Подпись действия |
блока киркой |
%counter_top_mixed_alltime_1_line% |
Готовая строка с цветами |
&61. &eAlex &7— &62 блока киркой |
На голограмме последняя строка выглядит как 1. Alex — 2 блока киркой с цветами из языкового файла. Ник, место, число и действие зависят от статистики. Текст и цвета задаются в leaderboard.row, leaderboard.value и units.
Категории: mixed, pickaxe, shovel, hoe, axe, sword, mace, bow, crossbow, trident, armor; общие: blocks, wood, kills, damage. Периоды: daily, weekly, alltime.
Примеры: %counter_top_mixed_alltime_1_line%, %counter_top_pickaxe_daily_1_value%, %counter_top_sword_weekly_1_name%. Для голограммы используйте %counter_top_mixed_alltime_1_line%, затем такие же строки с местами 2, 3 и далее.
Короткая форма %counter_top_1_value% и другие поля берут категорию/период из leaderboards.default-category/default-period. Для отсутствующего места возвращается leaderboards.empty-placeholder (по умолчанию —). Плейсхолдеры предмета без счётчика возвращают placeholderapi.empty-item (по умолчанию 0), а %counter_has% возвращает false.
Настройки и оформление
| Раздел |
Что меняется |
general.language |
ru_RU, en_US или свой файл языка |
anvil |
enabled, материал counter-material, блеск counter-glow, цена level-cost (от 0 до 39 уровней) |
counting.creative |
Подсчёт в Creative |
supported-items |
Включение blocks, wood, kills, damage |
entity-exclusions |
Исключённые сущности: types и регулярные выражения patterns |
number-format |
Разделители тысяч/дробей, damage-decimals |
leaderboards |
Часовой пояс, начало недели, категория/период по умолчанию, размеры топа/страницы, обновление и хранение старых периодов |
storage |
SQLite/MySQL, имя файла, flush-seconds, импорт legacy-import и параметры подключения MySQL |
milestones |
Награды за пороги на отдельных предметах |
placeholderapi |
enabled и ответ без предмета empty-item |
counter-glow: false по умолчанию; настройка влияет на вновь выданные счётчики. Блеск не добавляет зачарований. Числа округляются только для отображения.
В языковом файле редактируются messages, usage, help, counter-item (выдаваемый предмет), item-lore, inspect, units, categories, periods, leaderboard и forms. Цвета задаются кодами &; курсив по умолчанию выключен, &o включает его.
Переменные описания/просмотра: {value}, {raw_value}, {mob_kills}, {player_kills}, {total_kills}, {damage}, {unit}, {type}, {id}, {block_word}, {kill_word}, {mob_word}, {player_word}, {heart_word}. В просмотре также есть {player}.
forms.rule выбирает russian/english. Словари block/kill/mob/player/heart содержат one/few/many/other: «1 блок», «2 блока», «5 блоков»; дробные значения, включая 1.0, используют other. Шаблон units.pickaxe: '{block_word} киркой' подбирает форму автоматически. Для своего словаря можно использовать {имя_word} и %counter_имя_word%.
Шаблоны рейтинга используют следующие переменные: header принимает {category}, {period}, {page}; row принимает {position}, {player}, {value}; value принимает {value}, {unit}. Подсказки команд поддерживают {usage}, ответы используют переменные соответствующего действия.
После правок выполните /counter reload. Подключение хранилища, интервал сохранения, часовой пояс/начало недели, интервал обновления топа и регистрация PAPI требуют перезапуска. Настройки и собственные переводы сохраняются при обновлении файлов; ошибочный reload оставляет прежние настройки.
Награды и хранение
Награды по умолчанию выключены. Пример: алмаз за 100 убийств на предмете.
milestones:
trigger-on-admin-change: false
kills:
'100':
commands:
- 'console:minecraft:give {player} diamond 1'
Категории наград: blocks, wood, kills, damage. Для дробного порога используйте '100_5' вместо 100.5. Каждый порог срабатывает один раз для предмета. console: запускает команду от консоли, player: выполняет её с правами игрока; слеш не нужен. Переменные: {player}, {uuid}, {item}, {threshold} и переменные предмета выше. trigger-on-admin-change разрешает награды при административном изменении значения.
По умолчанию статистика игроков хранится в SQLite (counters.db). Для MySQL задайте storage.type: mysql и подключение в storage.mysql, затем перезапустите сервер. Смена типа сама не переносит данные. legacy-import однократно импортирует старый JSON в пустую базу, сохраняя исходный файл и резервную копию. Перед обновлениями сохраняйте миры, данные игроков и базу вместе; аварийное завершение может потерять последние несохранённые действия.
Для интеграций с другими плагинами доступен Java API: чтение, добавление, изменение и удаление счётчиков. Изменения через API не увеличивают рейтинги.
Лицензия
Можно бесплатно устанавливать плагин на свои серверы, включая коммерческие, и менять его для собственного использования. Перепродажа и распространение копий требуют письменного разрешения der3kyy. Полные условия и лицензии библиотек указаны в LICENSE.
Requirements: Minecraft 1.21.10, Paper/Purpur, Java 21. PlaceholderAPI is optional.
Installation and use
Put the plugin JAR in plugins/ and start the server. Settings are created in plugins/ItemCounters/config.yml, with translations in plugins/ItemCounters/lang/.
使用 /counter give <player> 给予计数器。在铁砧中,将支持的物品放在左侧,将已发放的计数器放在右侧,然后取出结果。默认计数器是一个指南针。应用它默认不消耗经验值。普通的指南针或带有复制名称的物品无效。一个计数器会被消耗。物品不能重复添加计数器。
统计内容
| 物品 |
统计项 |
| 镐、铲、锄 |
所有破坏的方块 |
| 斧 |
所有破坏的方块,包括石头 |
| 剑、锤、弓、弩、三叉戟 |
分别追踪生物和玩家击杀数 |
| 头盔、胸甲、护腿、靴子 |
受到的伤害(以心为单位):1 ❤ = 2 HP |
仅拥有计数器的物品会被追踪。减少后和吸收后的伤害会在带有计数器的装备 armor 部件之间分配。玩家的排行榜只计算一次。箭矢和三叉戟会记住发射它们的武器。切换物品不会将击杀转移给其他物品。
取消的操作不计入。创造模式下的计数默认禁用。旁观者模式永不计入。鞘翅、剪刀和狼铠不受支持。来自其他插件的现有名称、附魔和描述文本会被保留。当物品易手时,计数器仍随物品保留。它们不能防止物品在死亡时掉落。
命令与权限
<...> 中的参数为必填。[...] 中的参数为可选。物品命令使用选中在线玩家的主手。如果没有提供玩家名称,则使用你的主手。控制台命令需要提供玩家名称。
| 命令 |
操作 |
/counter help |
显示帮助信息 |
/counter give <player> |
给予一个计数器 |
/counter apply [player] |
无需铁砧即可应用计数器 |
/counter remove [player] |
移除物品上的计数器 |
/counter inspect [player] |
查看物品统计数据 |
/counter set <stat> <number> [player] |
设置数值 |
/counter add <stat> <number> [player] |
增加数值 |
/counter subtract <stat> <number> [player] |
减少数值 |
/counter top <category> <daily|weekly|alltime> [page] |
查看排行榜 |
/counter reload |
重载配置和翻译文件 |
统计项:blocks(方块)、wood(木头)、mob_kills(生物击杀)、player_kills(玩家击杀)、damage(伤害)。请使用该物品支持的统计项。value 是 blocks/wood/damage 的别名。total_kills 会自动计算。方块数和击杀数使用整数。伤害可以使用小数。数值不能低于零。管理性更改不会增加玩家在排行榜中的分数。
权限 itemcounters.use(帮助)和 itemcounters.top(排行榜)默认授予所有人。管理员权限:itemcounters.admin.give、.apply、.remove、.inspect、.reload、.edit。缩写名称均以 itemcounters.admin 开头。.edit 权限允许执行 set/add/subtract 操作。所有管理员权限默认仅限 OP。itemcounters.admin 授予完整的管理员权限集。
排行榜
分类:pickaxe、shovel、hoe、axe、sword、mace、bow、crossbow、trident、armor、mixed。此外还提供聚合分类 blocks、wood、kills 和 damage。
周期:daily(天)、weekly(周)、alltime(全部时间)。mixed 排行榜每位玩家仅列出一次,取其在各工具分类中的最高数值结果。不同的计数器不会累加。例如:/counter top mixed alltime。
分数属于玩家。交易物品不会转移排行榜排名。每日和每周周期遵循服务器时区或在设置中选择的时区。
PlaceholderAPI:手持物品
物品占位符读取玩家主手物品。该扩展已内置于插件中,无需从 eCloud 下载。
| 占位符 |
结果 |
%counter_has% |
该物品是否有计数器:true/false |
%counter_type% |
blocks, wood, weapon 或 armor |
%counter_value% |
格式化后的主要数值 |
%counter_raw_value% |
未格式化的主要数值 |
%counter_mob_kills% |
怪物击杀数 |
%counter_player_kills% |
玩家击杀数 |
%counter_total_kills% |
总击杀数 |
%counter_damage% |
伤害值(以心为单位) |
%counter_unit% |
带有正确词形的数值标签 |
%counter_id% |
唯一物品 ID |
%counter_block_word%, %counter_kill_word% |
“block” / “kill” 的词形 |
%counter_mob_word%, %counter_player_word%, %counter_heart_word% |
“mob” / “player” / “heart” 的词形 |
排行榜占位符
排行榜使用 PlaceholderAPI,不依赖你手中的物品。格式为:%counter_top_<category>_<period>_<position>_<field>%。位置从 1 开始。
示例:Alex 在混合排行榜中排名第一,使用镐子破坏了 2 个方块。插件语言设置为 en_US 且未更改格式化方式。以下是占位符的字面结果。将 mixed、alltime 和 1 替换为你需要的分类、周期和位置。
| 占位符 |
含义 |
示例结果 |
%counter_top_mixed_alltime_1_name% |
玩家名称 |
Alex |
%counter_top_mixed_alltime_1_value% |
数字与动作 |
2 blocks with a pickaxe |
%counter_top_mixed_alltime_1_raw% |
未格式化的数字 |
2 |
%counter_top_mixed_alltime_1_position% |
排名位置 |
1 |
%counter_top_mixed_alltime_1_category% |
结果分类 |
pickaxe |
%counter_top_mixed_alltime_1_action% |
动作标签 |
blocks with a pickaxe |
%counter_top_mixed_alltime_1_line% |
包含颜色代码的完整行 |
&61. &eAlex &7— &62 blocks with a pickaxe |
在全息显示中,最后一行显示为 1. Alex — 2 blocks with a pickaxe,颜色取自语言文件。名称、位置、数字和动作取决于统计数据。文本和颜色在 leaderboard.row、leaderboard.value 和 units 中设置。
分类:混合、镐、锹、锄、斧、剑、战锤、弓、弩、三叉戟、盔甲;聚合分类:方块、木头、击杀数、伤害值。时段:每日、每周、全部时间。
更多示例:%counter_top_mixed_alltime_1_line%、%counter_top_pickaxe_daily_1_value%、%counter_top_sword_weekly_1_name%。对于全息显示,使用 %counter_top_mixed_alltime_1_line%,然后依次重复位置 2、3 等。
短格式 %counter_top_1_value% 及其他字段使用 leaderboards.default-category/default-period。缺失的排行榜位置返回 leaderboards.empty-placeholder(默认值:—)。当没有计数器时,物品占位符返回 placeholderapi.empty-item(默认值:0)。%counter_has% 返回 false。
设置与格式化
| 设置项 |
选项 |
general.language |
ru_RU、en_US 或自定义语言文件 |
anvil |
enabled(启用)、counter-material(计数器材质)、counter-glow(计数器发光)、level-cost(等级消耗,范围 0 至 39) |
counting.creative |
在创造模式中进行计数 |
supported-items |
启用方块、木材、击杀、伤害统计 |
entity-exclusions |
排除的生物类型及正则表达式模式 |
number-format |
千位分隔符和小数分隔符、伤害小数位数 |
leaderboards |
时区、每周起始日、默认分类/周期、缓存/页面大小、刷新间隔及旧周期的保留时间 |
storage |
SQLite/MySQL、文件名、flush-seconds(刷盘秒数)、legacy-import(旧版导入)及 MySQL 连接设置 |
milestones |
针对单个物品达到阈值时的奖励 |
placeholderapi |
启用状态及 empty-item(空物品)响应 |
counter-glow: false 为默认值。该设置仅影响新发放的计数器。发光效果不会添加附魔。数字仅在显示时进行四舍五入。
语言文件包含 messages(消息)、usage(用法)、help(帮助)、counter-item(发放的物品)、item-lore(物品描述)、inspect(检查)、units(单位)、categories(分类)、periods(周期)、leaderboard(排行榜)和 forms(表单)。颜色使用 & 代码。斜体默认关闭;&o 可启用斜体。
描述/检查变量:{value}、{raw_value}、{mob_kills}、{player_kills}、{total_kills}、{damage}、{unit}、{type}、{id}、{block_word}、{kill_word}、{mob_word}、{player_word}、{heart_word}。检查功能还支持 {player}。
forms.rule 用于选择俄语/英语。block/kill/mob/player/heart 字典包含 one/few/many/other(一/少/多/其他)。例如俄语中会显示 “1 блок”、“2 блока”、“5 блоков”。包括 1.0 在内的小数值均使用 other 形式。俄语模板 units.pickaxe: '{block_word} киркой' 会自动选择词形变化;其英文对应形式为 '{block_word} with a pickaxe'。自定义字典可作为 {name_word} 和 %counter_name_word% 使用。
排行榜模板变量:header 接受 {category}、{period}、{page};row 接受 {position}、{player}、{value};value 接受 {value}、{unit}。命令提示支持 {usage}。回复内容使用对应操作的变量。
编辑后请运行 /counter reload。存储连接、保存间隔、时区/每周起始日、排行榜刷新间隔以及 PAPI 注册需要重启服务器。更新文件时,设置和自定义翻译将被保留。无效的重载将保留之前的设置。
奖励与存储
奖励默认禁用。示例:对某物品达成 100 次击杀奖励一颗钻石。
milestones:
trigger-on-admin-change: false
kills:
'100':
commands:
- 'console:minecraft:give {player} diamond 1'
奖励分类:blocks(方块)、wood(木材)、kills(击杀)、damage(伤害)。若需设定 100.5 这样的小数阈值,请使用 '100_5'。每个阈值对每个物品仅触发一次。console: 以控制台身份执行命令。player: 以玩家权限执行命令。请勿包含前导斜杠。可用变量:{player}、{uuid}、{item}、{threshold} 以及上述列出的物品变量。trigger-on-admin-change 启用后,管理修改数值的行为也会触发奖励。
玩家统计数据默认使用 SQLite(counters.db)。如需使用 MySQL,请在 storage.type 设置为 mysql 并在 storage.mysql 中配置连接信息,然后重启服务器。更改存储类型不会迁移数据。legacy-import 会将旧的 JSON 文件一次性导入到空数据库中,同时保留原始文件和备份。更新前,请一起备份世界、玩家数据和数据库。突然关机可能导致最新的未保存操作丢失。
提供 Java API,可用于与其他插件集成:读取、应用、编辑和移除计数器。通过 API 进行的更改不会增加排行榜分数。
许可证
您可以免费在自己的服务器上安装本插件(包括商业服务器),并可出于个人目的对其进行修改。转售和重新分发副本需获得 der3kyy 的书面许可。完整条款及库许可证详见 LICENSE。
ItemCounters
Counters for tools, weapons and armor. Track broken blocks, mob and player kills, and damage taken. Includes leaderboards, milestone rewards and PlaceholderAPI support.
Русское описание / Russian description
ItemCounters
Счётчики для инструментов, оружия и брони: сломанные блоки, убийства мобов и игроков, полученный урон. Есть рейтинги, награды за достижения и поддержка PlaceholderAPI.
Требования: Minecraft 1.21.10, Paper/Purpur, Java 21. PlaceholderAPI необязателен.
Установка и применение
Положите JAR плагина в папку plugins/ и запустите сервер. Настройки появятся в plugins/ItemCounters/config.yml, переводы находятся в plugins/ItemCounters/lang/.
Выдайте счётчик командой /counter give <игрок>. В наковальне положите подходящий предмет слева, выданный счётчик справа, затем заберите результат. По умолчанию используется компас. Применение бесплатное. Обычный компас и копия названия не подходят. Расходуется один счётчик; повторное применение к тому же предмету запрещено.
Что считается
| Предмет |
Статистика |
| Кирки, лопаты, мотыги |
Все сломанные блоки |
| Топоры |
Все сломанные блоки, включая камень |
| Мечи, булавы, луки, арбалеты, трезубцы |
Убийства мобов и игроков отдельно |
| Шлемы, нагрудники, поножи, ботинки |
Полученный урон в сердцах: 1 ❤ = 2 HP |
Учитывается только предмет со счётчиком. Урон после уменьшений и поглощения делится между надетыми частями брони со счётчиками; в рейтинге игрока он учитывается один раз. Для стрел и трезубцев запоминается оружие выстрела. Смена предмета в руке не переносит убийство на другой предмет.
Отменённые действия не учитываются. В Creative подсчёт по умолчанию выключен. В Spectator он не работает. Элитры, ножницы и волчья броня не поддерживаются. Имя, зачарования и чужое описание предмета сохраняются. Счётчик передаётся вместе с предметом; защиты от потери при смерти нет.
Команды и права
Аргументы в <...> обязательны, в [...] необязательны. Команды предметов работают с основной рукой выбранного онлайн-игрока. Если имя не указано, используется ваша рука. Из консоли имя обязательно.
| Команда |
Действие |
/counter help |
Справка |
/counter give <игрок> |
Выдать один счётчик |
/counter apply [игрок] |
Добавить счётчик без наковальни |
/counter remove [игрок] |
Удалить счётчик с предмета |
/counter inspect [игрок] |
Посмотреть статистику предмета |
/counter set <характеристика> <число> [игрок] |
Задать значение |
/counter add <характеристика> <число> [игрок] |
Прибавить значение |
/counter subtract <характеристика> <число> [игрок] |
Вычесть значение |
/counter top <категория> <daily|weekly|alltime> [страница] |
Открыть рейтинг |
/counter reload |
Перечитать настройки и переводы |
Характеристики: blocks, wood, mob_kills, player_kills, damage. Выберите характеристику, подходящую предмету. value заменяет blocks/wood/damage; total_kills вычисляется автоматически. Для блоков и убийств используются целые числа, для урона можно указать дробное. Значения не опускаются ниже нуля. Административные изменения не увеличивают рейтинг игрока.
Права itemcounters.use (справка) и itemcounters.top (рейтинги) доступны всем по умолчанию. Права администратора: itemcounters.admin.give, .apply, .remove, .inspect, .reload, .edit. Сокращения начинаются с itemcounters.admin, право .edit разрешает set/add/subtract. Все права администратора по умолчанию у OP. itemcounters.admin объединяет их.
Рейтинги
Категории: pickaxe, shovel, hoe, axe, sword, mace, bow, crossbow, trident, armor, mixed. Общие категории blocks, wood, kills, damage тоже доступны.
Периоды: daily (день), weekly (неделя), alltime (всё время). mixed показывает каждого игрока один раз по его лучшему числовому результату среди инструментов, без сложения разных счётчиков. Пример: /counter top mixed alltime.
Рейтинг принадлежит игроку: передача предмета не передаёт его место. Дневные и недельные результаты сменяются по часовому поясу сервера или выбранному в настройках.
PlaceholderAPI: предмет в руке
Плейсхолдеры предмета читают основную руку игрока. Расширение встроено в плагин. Скачивать его через eCloud не нужно.
| Плейсхолдер |
Результат |
%counter_has% |
Есть ли счётчик: true/false |
%counter_type% |
blocks, wood, weapon или armor |
%counter_value% |
Основное значение с форматированием |
%counter_raw_value% |
Основное значение без форматирования |
%counter_mob_kills% |
Убийства мобов |
%counter_player_kills% |
Убийства игроков |
%counter_total_kills% |
Общее число убийств |
%counter_damage% |
Урон в сердцах |
%counter_unit% |
Подпись значения с нужной формой слова |
%counter_id% |
Уникальный ID предмета |
%counter_block_word%, %counter_kill_word% |
Форма слова «блок» / «убийство» |
%counter_mob_word%, %counter_player_word%, %counter_heart_word% |
Форма слова «моб» / «игрок» / «сердце» |
Плейсхолдеры топов
Топы работают через PlaceholderAPI и не зависят от предмета в руке. Формат: %counter_top_<категория>_<период>_<место>_<поле>%. Места начинаются с 1.
Пример: Alex занимает первое место общего топа с результатом 2 блока киркой. Язык плагина ru_RU, оформление стандартное. Ниже указаны буквальные ответы плейсхолдеров. Меняйте mixed, alltime и 1 на нужную категорию, период и место.
| Плейсхолдер |
Что показывает |
Пример ответа |
%counter_top_mixed_alltime_1_name% |
Ник игрока |
Alex |
%counter_top_mixed_alltime_1_value% |
Число с действием |
2 блока киркой |
%counter_top_mixed_alltime_1_raw% |
Число без форматирования |
2 |
%counter_top_mixed_alltime_1_position% |
Место |
1 |
%counter_top_mixed_alltime_1_category% |
Категория результата |
pickaxe |
%counter_top_mixed_alltime_1_action% |
Подпись действия |
блока киркой |
%counter_top_mixed_alltime_1_line% |
Готовая строка с цветами |
&61. &eAlex &7— &62 блока киркой |
На голограмме последняя строка выглядит как 1. Alex — 2 блока киркой с цветами из языкового файла. Ник, место, число и действие зависят от статистики. Текст и цвета задаются в leaderboard.row, leaderboard.value и units.
Категории: mixed, pickaxe, shovel, hoe, axe, sword, mace, bow, crossbow, trident, armor; общие: blocks, wood, kills, damage. Периоды: daily, weekly, alltime.
Примеры: %counter_top_mixed_alltime_1_line%, %counter_top_pickaxe_daily_1_value%, %counter_top_sword_weekly_1_name%. Для голограммы используйте %counter_top_mixed_alltime_1_line%, затем такие же строки с местами 2, 3 и далее.
Короткая форма %counter_top_1_value% и другие поля берут категорию/период из leaderboards.default-category/default-period. Для отсутствующего места возвращается leaderboards.empty-placeholder (по умолчанию —). Плейсхолдеры предмета без счётчика возвращают placeholderapi.empty-item (по умолчанию 0), а %counter_has% возвращает false.
Настройки и оформление
| Раздел |
Что меняется |
general.language |
ru_RU, en_US или свой файл языка |
anvil |
enabled, материал counter-material, блеск counter-glow, цена level-cost (от 0 до 39 уровней) |
counting.creative |
Подсчёт в Creative |
supported-items |
Включение blocks, wood, kills, damage |
entity-exclusions |
Исключённые сущности: types и регулярные выражения patterns |
number-format |
Разделители тысяч/дробей, damage-decimals |
leaderboards |
Часовой пояс, начало недели, категория/период по умолчанию, размеры топа/страницы, обновление и хранение старых периодов |
storage |
SQLite/MySQL, имя файла, flush-seconds, импорт legacy-import и параметры подключения MySQL |
milestones |
Награды за пороги на отдельных предметах |
placeholderapi |
enabled и ответ без предмета empty-item |
counter-glow: false по умолчанию; настройка влияет на вновь выданные счётчики. Блеск не добавляет зачарований. Числа округляются только для отображения.
В языковом файле редактируются messages, usage, help, counter-item (выдаваемый предмет), item-lore, inspect, units, categories, periods, leaderboard и forms. Цвета задаются кодами &; курсив по умолчанию выключен, &o включает его.
Переменные описания/просмотра: {value}, {raw_value}, {mob_kills}, {player_kills}, {total_kills}, {damage}, {unit}, {type}, {id}, {block_word}, {kill_word}, {mob_word}, {player_word}, {heart_word}. В просмотре также есть {player}.
forms.rule выбирает russian/english. Словари block/kill/mob/player/heart содержат one/few/many/other: «1 блок», «2 блока», «5 блоков»; дробные значения, включая 1.0, используют other. Шаблон units.pickaxe: '{block_word} киркой' подбирает форму автоматически. Для своего словаря можно использовать {имя_word} и %counter_имя_word%.
Шаблоны рейтинга используют следующие переменные: header принимает {category}, {period}, {page}; row принимает {position}, {player}, {value}; value принимает {value}, {unit}. Подсказки команд поддерживают {usage}, ответы используют переменные соответствующего действия.
После правок выполните /counter reload. Подключение хранилища, интервал сохранения, часовой пояс/начало недели, интервал обновления топа и регистрация PAPI требуют перезапуска. Настройки и собственные переводы сохраняются при обновлении файлов; ошибочный reload оставляет прежние настройки.
Награды и хранение
Награды по умолчанию выключены. Пример: алмаз за 100 убийств на предмете.
milestones:
trigger-on-admin-change: false
kills:
'100':
commands:
- 'console:minecraft:give {player} diamond 1'
Категории наград: blocks, wood, kills, damage. Для дробного порога используйте '100_5' вместо 100.5. Каждый порог срабатывает один раз для предмета. console: запускает команду от консоли, player: выполняет её с правами игрока; слеш не нужен. Переменные: {player}, {uuid}, {item}, {threshold} и переменные предмета выше. trigger-on-admin-change разрешает награды при административном изменении значения.
По умолчанию статистика игроков хранится в SQLite (counters.db). Для MySQL задайте storage.type: mysql и подключение в storage.mysql, затем перезапустите сервер. Смена типа сама не переносит данные. legacy-import однократно импортирует старый JSON в пустую базу, сохраняя исходный файл и резервную копию. Перед обновлениями сохраняйте миры, данные игроков и базу вместе; аварийное завершение может потерять последние несохранённые действия.
Для интеграций с другими плагинами доступен Java API: чтение, добавление, изменение и удаление счётчиков. Изменения через API не увеличивают рейтинги.
Лицензия
Можно бесплатно устанавливать плагин на свои серверы, включая коммерческие, и менять его для собственного использования. Перепродажа и распространение копий требуют письменного разрешения der3kyy. Полные условия и лицензии библиотек указаны в LICENSE.
Requirements: Minecraft 1.21.10, Paper/Purpur, Java 21. PlaceholderAPI is optional.
Installation and use
Put the plugin JAR in plugins/ and start the server. Settings are created in plugins/ItemCounters/config.yml, with translations in plugins/ItemCounters/lang/.
Give a counter with /counter give <player>. In an anvil, place a supported item on the left and the issued counter on the right, then take the result. The default counter is a compass. Applying it costs no XP by default. A regular compass or an item with a copied name will not work. One counter is consumed. An item cannot receive a counter twice.
What is counted
| Item |
Statistic |
| Pickaxes, shovels, hoes |
All broken blocks |
| Axes |
All broken blocks, including stone |
| Swords, maces, bows, crossbows, tridents |
Mob and player kills tracked separately |
| Helmets, chestplates, leggings, boots |
Damage taken in hearts: 1 ❤ = 2 HP |
Only items with a counter are tracked. Damage after reductions and absorption is split between equipped armor pieces with counters. The player's leaderboard counts it once. Arrows and tridents remember the weapon used to fire them. Switching items does not transfer a kill to another item.
Cancelled actions do not count. Counting in Creative is disabled by default. Spectator never counts. Elytra, shears and wolf armor are unsupported. Existing names, enchantments and lore from other plugins are preserved. Counters stay with the item when it changes hands. They do not protect items from dropping on death.
Commands and permissions
Arguments in <...> are required. Arguments in [...] are optional. Item commands use the selected online player's main hand. Without a player name, they use your hand. Console commands require a player name.
| Command |
Action |
/counter help |
Show help |
/counter give <player> |
Give one counter |
/counter apply [player] |
Apply a counter without an anvil |
/counter remove [player] |
Remove a counter from an item |
/counter inspect [player] |
View item statistics |
/counter set <stat> <number> [player] |
Set a value |
/counter add <stat> <number> [player] |
Increase a value |
/counter subtract <stat> <number> [player] |
Decrease a value |
/counter top <category> <daily|weekly|alltime> [page] |
View a leaderboard |
/counter reload |
Reload settings and translations |
Stats: blocks, wood, mob_kills, player_kills, damage. Use a stat supported by the item. value is an alias for blocks/wood/damage. total_kills is calculated automatically. Blocks and kills use whole numbers. Damage can use decimals. Values cannot fall below zero. Administrative changes do not increase the player's leaderboard score.
Permissions itemcounters.use (help) and itemcounters.top (leaderboards) are granted to everyone by default. Admin permissions: itemcounters.admin.give, .apply, .remove, .inspect, .reload, .edit. The abbreviated names all start with itemcounters.admin. The .edit permission allows set/add/subtract. All admin permissions default to OP. itemcounters.admin grants the full set.
Leaderboards
Categories: pickaxe, shovel, hoe, axe, sword, mace, bow, crossbow, trident, armor, mixed. Aggregate categories blocks, wood, kills and damage are also available.
Periods: daily (day), weekly (week), alltime (all time). The mixed leaderboard lists each player once using their highest numerical result across tool categories. Different counters are not added together. Example: /counter top mixed alltime.
Scores belong to players. Trading an item does not transfer a leaderboard position. Daily and weekly periods follow the server timezone or the timezone chosen in the settings.
PlaceholderAPI: held item
Item placeholders read the player's main hand. The expansion is built into the plugin. No eCloud download is needed.
| Placeholder |
Result |
%counter_has% |
Whether the item has a counter: true/false |
%counter_type% |
blocks, wood, weapon or armor |
%counter_value% |
Formatted primary value |
%counter_raw_value% |
Unformatted primary value |
%counter_mob_kills% |
Mob kills |
%counter_player_kills% |
Player kills |
%counter_total_kills% |
Total kills |
%counter_damage% |
Damage in hearts |
%counter_unit% |
Value label with the correct word form |
%counter_id% |
Unique item ID |
%counter_block_word%, %counter_kill_word% |
Word form for “block” / “kill” |
%counter_mob_word%, %counter_player_word%, %counter_heart_word% |
Word form for “mob” / “player” / “heart” |
Leaderboard placeholders
Leaderboards use PlaceholderAPI and do not depend on the item in your hand. Format: %counter_top_<category>_<period>_<position>_<field>%. Positions start at 1.
Example: Alex is first on the mixed leaderboard with 2 blocks broken using a pickaxe. The plugin language is en_US and the formatting is unchanged. These are the literal placeholder results. Replace mixed, alltime and 1 with the category, period and position you need.
| Placeholder |
Meaning |
Example result |
%counter_top_mixed_alltime_1_name% |
Player name |
Alex |
%counter_top_mixed_alltime_1_value% |
Number and action |
2 blocks with a pickaxe |
%counter_top_mixed_alltime_1_raw% |
Unformatted number |
2 |
%counter_top_mixed_alltime_1_position% |
Position |
1 |
%counter_top_mixed_alltime_1_category% |
Result category |
pickaxe |
%counter_top_mixed_alltime_1_action% |
Action label |
blocks with a pickaxe |
%counter_top_mixed_alltime_1_line% |
Complete line with color codes |
&61. &eAlex &7— &62 blocks with a pickaxe |
On a hologram, the last line appears as 1. Alex — 2 blocks with a pickaxe with colors from the language file. Names, positions, numbers and actions depend on the statistics. Text and colors are set in leaderboard.row, leaderboard.value and units.
Categories: mixed, pickaxe, shovel, hoe, axe, sword, mace, bow, crossbow, trident, armor; aggregate categories: blocks, wood, kills, damage. Periods: daily, weekly, alltime.
More examples: %counter_top_mixed_alltime_1_line%, %counter_top_pickaxe_daily_1_value%, %counter_top_sword_weekly_1_name%. For a hologram, use %counter_top_mixed_alltime_1_line%, then repeat with positions 2, 3 and so on.
The short form %counter_top_1_value% and the other fields use leaderboards.default-category/default-period. Missing leaderboard positions return leaderboards.empty-placeholder (default: —). Item placeholders return placeholderapi.empty-item (default: 0) when there is no counter. %counter_has% returns false.
Settings and formatting
| Setting |
Options |
general.language |
ru_RU, en_US or a custom language file |
anvil |
enabled, counter-material, counter-glow, level-cost (0 to 39 levels) |
counting.creative |
Counting in Creative |
supported-items |
Enable blocks, wood, kills, damage |
entity-exclusions |
Excluded entity types and regular expressions in patterns |
number-format |
Thousands and decimal separators, damage-decimals |
leaderboards |
Timezone, week start, default category/period, cache/page sizes, refresh interval and retention of old periods |
storage |
SQLite/MySQL, file name, flush-seconds, legacy-import and MySQL connection settings |
milestones |
Rewards for thresholds reached on individual items |
placeholderapi |
enabled and empty-item response |
counter-glow: false is the default. The setting affects newly issued counters. Glowing does not add enchantments. Numbers are rounded for display only.
Language files contain messages, usage, help, counter-item (the issued item), item-lore, inspect, units, categories, periods, leaderboard and forms. Colors use & codes. Italics are off by default; &o enables them.
Lore/inspection variables: {value}, {raw_value}, {mob_kills}, {player_kills}, {total_kills}, {damage}, {unit}, {type}, {id}, {block_word}, {kill_word}, {mob_word}, {player_word}, {heart_word}. Inspection also supports {player}.
forms.rule selects russian/english. The block/kill/mob/player/heart dictionaries contain one/few/many/other. For Russian, this gives “1 блок”, “2 блока”, “5 блоков”. Decimal values, including 1.0, use other. The Russian template units.pickaxe: '{block_word} киркой' selects the word form automatically; its English equivalent is '{block_word} with a pickaxe'. Custom dictionaries can be used as {name_word} and %counter_name_word%.
Leaderboard template variables: header accepts {category}, {period}, {page}; row accepts {position}, {player}, {value}; value accepts {value}, {unit}. Command hints support {usage}. Replies use variables for the corresponding action.
Run /counter reload after editing. Storage connections, the save interval, timezone/week start, leaderboard refresh interval and PAPI registration require a restart. Settings and custom translations are preserved when files are updated. An invalid reload keeps the previous settings.
Rewards and storage
Rewards are disabled by default. Example: one diamond for 100 kills on an item.
milestones:
trigger-on-admin-change: false
kills:
'100':
commands:
- 'console:minecraft:give {player} diamond 1'
Reward categories: blocks, wood, kills, damage. Use '100_5' for a decimal threshold of 100.5. Each threshold triggers once per item. console: runs the command as console. player: runs it with the player's permissions. Do not include a leading slash. Variables: {player}, {uuid}, {item}, {threshold} and the item variables listed above. trigger-on-admin-change enables rewards for administrative value changes.
Player statistics use SQLite (counters.db) by default. For MySQL, set storage.type: mysql and the connection in storage.mysql, then restart the server. Changing the storage type does not migrate data. legacy-import imports an old JSON file once into an empty database, preserving the original file and a backup. Before updates, back up worlds, player data and the database together. An abrupt shutdown can lose the latest unsaved actions.
A Java API is available for integration with other plugins: read, apply, edit and remove counters. API changes do not increase leaderboard scores.
License
You can install the plugin on your own servers, including commercial servers, and modify it for personal use free of charge. Reselling and redistributing copies require written permission from der3kyy. Full terms and library licenses are in LICENSE.
评论 0
登录后参与评分
还没有评论,来抢沙发吧