items-counter

插件

· 作者 der3kyy

工具、武器和护甲的计数器。追踪已破坏的方块、生物与玩家击杀数以及受到的伤害。包含排行榜、里程碑奖励及 PlaceholderAPI 支持。

0 本站下载 0 关注 更新于 1 个月前

最新 1.0.1 · 26.3 · Paper / Purpur

一键开服(送7天)

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。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源