查看“LeaderHeads”的源代码

{{待完善}}
{{Bukkit Plugin Infobox
|插件名=LeaderHeads
|图标=
|版本= 3.1.8.3
|前置插件= 
|兼容服务端版本=1.7-1.12
|作者= RobiRami
|網址= [https://www.spigotmc.org/resources/leaderheads.2079/ spigotmc]
}}
'''LeaderHeads'''是一款可以记录其他插件数据的插件，可以记录 全服的/每日/每周/每月 的数据并汇集成排行榜。并且你还可以给上榜的玩家配置自动奖励。

== 特点 ==
* '''支持'''至少618个插件的数据.
* '''安装方便''' 设置牌子和头颅方法直接明了.
* '''高效''' 插件被优化以同时处理大量数据，并且不会影响服务器性能.
* '''兼容主流版本''' 1.7-1.12
* '''不时更新插件''' 更新更多特性和支持更多插件的数据记录.
* '''效果极佳''' Leaderheads可以让你记录minecraft的数据所以你不需要其他的插件来记录这些数据.
* '''配置高度自定义''' 你可以自定义每个告示牌, 消息, 更新延迟, 菜单和更多. 你可以修改格式和间隔时间,甚至是高位数的格式.
* '''API''' 可以让插件开发者轻而易举地获得插件数据并创建排行榜.
* '''指令可配置''' 可通过配置的指令来打开指定的排行榜菜单.
* '''支持全息显示插件''' 支持HolographicDisplay变量
* '''盔甲架''' 用盔甲架来表示排行榜
* '''Citizens''' 支持NPC

== 指令&权限 ==
{| class="wikitable sortable"
|-
! 指令 !! 权限 !! 作用
|-
| /leaderheads update <all>/<leaderboard> ||leaderheads.update||更新特定或所有的排行榜.
|-
| /leaderheads armorstand <small>/<big>	||leaderheads.armorstand||创建盔甲架.你必须看着一块牌子才能使用.
|-
| /leaderheads setserver <服务器> ||leaderheads.setserver||使目标牌子与指定的子服同步.
|-
| /leaderheads removeserver||leaderheads.removeserver||移除与子服同步的牌子.
|-
| /leaderheads addexempt <玩家名>||leaderheads.addexempt||使指定的玩家不会出现在排行榜中.
|-
| /leaderheads removeexempt <name>	||leaderheads.removeexempt||使指定的玩家可再次出现在排行榜中.
|-
| /leaderheads resetexempts	||leaderheads.resetexempts||重置不会出现在排行榜中的玩家列表.
|-
| /leaderheads warnings	||leaderheads.warnings||显示插件可能检测到的错误.
|-
| /leaderheads reload||leaderheads.reload||重载整个插件.
|-
| /leaderheads menu <菜单名>||无需权限||手动打开特定的排行榜菜单.
|-
| /leaderheads ||leaderheads.help||显示总体信息和插件状态.
|-
|}

== 安装 ==
# 首先你需要放置一块牌子.
# 第一行写上 [LeaderHeads] .
# 第二行写上你想要显示的数据(如boat).
# 第三行写上一个数字. 这个数字代表排行榜的排名.
# 如果你想要创建一个全服排行榜, 只需在最后一行留空. 如果在第四行写 daily, weekly 或 monthly 将会创建指定世界的排行榜.
# 你可以在放置这块牌子的方块上或是直接在牌子上方放置一块头颅,这个头颅就会自动变为排行榜上玩家的皮肤头.
# 请参考配置页面来改变告示牌的相关配置.

=== 排行榜显示方法 ===
==== 盔甲架显示排行榜 ====

这是一种不错的方式来显示排行榜. LeaderHeads 可以简单地让你在一块告示牌上创建盔甲架.<br />
只需先 设置告示牌 并输入指令 ''<nowiki>/leaderheads armorstand <small>/<big></nowiki>'' 就可以创建一个大的或小的盔甲架.<br />
确认你在输入这个指令的时候已经对准了告示牌. 盔甲架的头颅会在排行榜刷新时同步刷新.请注意盔甲架**不会**受到这个插件的保护,你需要其他的插件来保护盔甲架(如worldguard）. 
你可以使用 [[https://www.spigotmc.org/resources/armor-stand-editor.7688/|这一工具]] 来自定义你的盔甲架.


==== NPC显示排行榜 ====
你可以通过 [https://www.spigotmc.org/resources/citizens.13811 Citizens]插件的 NPC来显示排行榜.<br />
只需先在一个方块上 设置告示牌, 然后站在这个方块上并输入 ''/npc create LeaderHeads''. NPC的名称会在排行榜刷新时同步刷新.<br />
你可以在构建NPC指令完成后改变NPC的类型.
==== 全息文字显示排行榜 ====
想要创建这个插件的全息文字, 你必须先安装 [https://dev.bukkit.org/projects/holographic-displays HolographicDisplays].

- 首先,使用 ''HolographicDisplays''的指令创建一个全息文字. 输入什么文字随意,你可以在之后更改
- 打开位于 ''/plugins/HolographicDisplays/database.yml'' 并关联全息文字
- 你现在可以深入地修改全息文字了. 要想显示插件数据,你必须使用 LeaderHeads的变量. 以下为使用方法. 你可以在以下内输入 ''/hd reload'' 来重载''HolographicDisplays'' 并查看变化. 这可能需要一点时间来检测新的全息文字.
* 对于 '''全服''' 排行榜,请使用以下变量.
* ''<{leaderboard}_name_{rank}>'' 显示指定排行榜的玩家 '''名称''' . ''{leaderboard}'' 代表排行榜 ''{rank}'' 代表排行榜名称:例如 ''<kills_name_1>''
* ''<{leaderboard}_score_{rank}>''来显示指定排行榜玩家的 '''分数'''.''{leaderboard}'' 代表排行榜 ''{rank}'' 代表排行榜名称. 例如: ''<kills_score_1>''
* 对于 '''全服''' 排行榜  '''数据同步''',请使用以下变量.
* ''<{leaderboard}_{server}_name_{rank}>'' 显示指定子服内排行榜的玩家 '''名称'''. ''{leaderboard}'' 代表排行榜, ''{rank}'' 代表排行榜名称 ''{server}'' 代表你同步的服务器. 例如: ''<kills_skywars_name_1>''
* ''<{leaderboard}_{server}_score_{rank}>'' 来显示指定子服内排行榜玩家的 '''分数'''. ''{leaderboard}'' 代表排行榜, ''{rank}'' 代表排行榜名称   ''{server}'' 代表你同步的服务器. 例如: ''<kills__skywars_score_1>''
* 对于 '''每日/每周/每月''' 排行榜, 请使用以下变量.
* ''<{leaderboard}_{time}_name_{rank}>'' 显示指定时间排行榜的玩家 '''名称''' . ''{leaderboard}'' 代表排行榜  ''{rank}'' 代表排行榜名称  ''{time}'' (选项: ''daily, weekly and monthly''). 例如: ''<kills_weekly_name_1>''
* ''<{leaderboard}_{time}_score_{rank}>'' 来显示指定时间排行榜玩家的 '''分数'''. ''{leaderboard}'' 代表排行榜  ''{rank}'' 代表排行榜名称, ''{server}'' 代表你同步的服务器  ''{time}'' (选项: ''daily, weekly and monthly''). 例如: ''<kills_weekly_score_1>''
* 对于 '''每日/每周/每月''' 排行榜 的 '''数据同步''', 请使用以下变量.
* ''<{leaderboard}_{server}_{time}_name_{rank}>'' 显示指定子服排行榜的玩家 '''名称''' . ''{leaderboard}'' 代表排行榜   ''{rank}'' 代表排行榜名称   ''{time}'' 代表时间间隔  (选项: ''daily, weekly and monthly''). 例如: ''<kills_weekly_name_1>''
* ''<{leaderboard}_{server}_{time}_score_{rank}>'' 来显示指定子服时间排行榜玩家的 '''分数'''. ''{leaderboard}'' 代表排行榜   ''{rank}'' 代表排行榜名称, ''{server}'' 代表你同步的服务器  ''{time}'' 代表时间间隔  (选项: ''daily, weekly and monthly'').

例如: ''<kills_weekly_score_1>''

=== 自定义图片显示 ===
需要[http://www.mcbbs.net/thread-705364-1-1.html Banner Board自定义图片](付费插件) 和[https://www.spigotmc.org/resources/bannerboard-leaderheads.22986/ BannerBoard LeaderHeads排行榜拓展插件](免费)

插件作者给的配置示例:
    configurable:
      renderers:
      - IMAGE -src background.png -height 768
      - COLOR -color 0,0,0,90
      - TEXT -text TOP KILLERS -size 110 -font Headline One -color 255,255,255 -strokeColor 0,0,0 -strokeThickness 1 -xOffset 215 -yOffset 105
      - IMAGE -src gold_block.png -xOffset 120 -yOffset 360
      - LEADERHEADS -texturesize 300 -xOffset 50 -yOffset 120 -leaderboardname kills -timeframe alltime -number 2 -skinurl http://www.skinrender.com:2798/fullskin-%name%-640-0-22-0-354-15-0-0-34-18-0-31-18-0-352-13-0-352-22 -font Headline Two -nameSize 45 -textOffset 60 -color 255,255,255 -strokeColor 0,0,0 -strokeThickness 1 -nameOffset 60
      - IMAGE -src diamond_block.png -xOffset 315 -yOffset 310
      - LEADERHEADS -texturesize 300 -xOffset 250 -yOffset 75 -leaderboardname kills -timeframe alltime -number 1 -skinurl http://www.skinrender.com:2798/fullskin-%name%-640-0-15-0-0-10-0-48-0-131-45-0-135-0-20-22-0-15-18 -font Headline Two -nameSize 55 -textOffset 60 -color 255,255,255 -strokeColor 0,0,0 -strokeThickness 1 -nameOffset 60
      - IMAGE -src iron_block.png -xOffset 510 -yOffset 360
      - LEADERHEADS -texturesize 300 -xOffset 460 -yOffset 135 -leaderboardname kills -timeframe alltime -number 3 -skinurl http://www.skinrender.com:2798/fullskin-%name%-640-0-328-0-349-333-0-0-338-18-0-340-20-78-8-6-78-6-8 -font Headline Two -nameSize 50 -textOffset 40 -color 255,255,255 -strokeColor 0,0,0 -strokeThickness 1 -nameOffset 60
      - IMAGE -src sword.png -xOffset 480 -yOffset 115 -width 65 -height 65

== 数据同步 ==

很多大型服务器有庞大的网络结构,而这就需要用到数据同步.以下为示例.
假如一个你拥有多个大厅和子服的空岛战争服务器. 因为玩家需要先到大厅,这里就是你放置排行榜的地方. 由于空岛战争的数据是在子服而不是在大厅, 而数据却显示在大厅. 所以这个插件就有了这个功能来解决这一问题. 按照以下步骤来正确地同步你的服务器数据.

# - 在你的服务器内的所有服务器安装这个插件(大厅和子服).
# - 在每个服务器内的''database.yml''里启用 MySQL 来确保所有服务器连接的是同一个数据库. 
# - 在每个服务器内的''database.yml'' 内配置''服务器''选项. 给你的每组服务器起一个名称. 你可以把你的所有空岛战争的服务器命名为 ''skywars'' 而不是''skywars1'', ''skywars2'' . 这一组的服务器数据就会共享.
# - 以空岛战争服务器为例,在所有你的想要同步数据的服务器内,在你想要启用同步记录的数据的文件内把 force-update 设置为true. 之后重载插件即可.
# - 在你想要显示排行榜的地方, 比如大厅服务器, 和平常一样放上排行榜的告示牌. 但之后的步骤略有不同.
# - 输入''/leaderheads setserver <name>'',  ''name''为你想要同步数据的服务器名, 比如 ''skywars''. 如果这是你的第一次操作, 插件会在 ''synced-statistics/servername/statistic.yml'' 内生成配置来记录数据.

== 数据 ==
=== 原版数据 ===
 jump: 显示跳跃次数
 
 last-death: 显示最近狗带的玩家
 
 traded: 显示与村民交易次数最多的玩家
 
 swim: 显示游得最远的玩家
 
 played: 显示在线时间最长的肝帝
 
 pig: 显示骑猪距离最长的玩家
 
 mob击杀次数最多的玩家: 显示杀怪最多的玩家
 
 minecart: 显示开车最熟练的玩家
 
 fish: 显示炸鱼最多的玩家
 
 horse: 显示骑马的汉子
 
 fly: 显示飞得更高的玩家
 
 elytra: 显示用鞘翅飞行最远的玩家
 
 joined: 显示加入游戏次数最多的玩家
 
 mine: 显示挖矿最多的玩家
 
 击杀次数最多的玩家: 显示杀人最多的玩家
 
 enchanted: 显示附魔最多物品的玩家
 
 drop: 显示丢弃物品最多的玩家
 
 dive: 显示潜水最深的玩家
 
 deaths: 显示狗带次数最多的玩家
 
 damage-give: 显示造成伤害最多的玩家
 
 damage-receive: 显示受伤最多的残疾人
 
 cake: 显示吃蛋糕最多的胖子
 
 climb: 显示爬得最高的玩家
 
 boat: 显示赛艇最远的船夫
 
 bred: 显示饲养动物最多的玩家
 
 walk: 显示走远了的玩家
 
 va-creeper: 显示杀死苦力怕最多的玩家
 
 va-skeleton: 显示骷髅击杀次数最多的玩家
 
 va-spider: 显示蜘蛛击杀次数最多的玩家
 
 va-zombie: 显示僵尸击杀次数最多的玩家
 
 va-slime: 显示史莱姆击杀次数最多的玩家
 
 va-ghast: 显示恶魂击杀次数最多的玩家
 
 va-pigzombie: 显示僵尸猪人击杀次数最多的玩家
 
 va-enderman: 显示末影人击杀次数最多的玩家
 
 va-cavespider: 显示洞穴蜘蛛击杀次数最多的玩家
 
 va-silverfish: 显示蠹虫击杀次数最多的玩家
 
 va-blaze: 显示烈焰人击杀次数最多的玩家
 
 va-magmacube: 显示岩浆怪击杀次数最多的玩家
 
 va-bat: 显示蝙蝠击杀次数最多的玩家
 
 va-witch: 显示女巫击杀次数最多的玩家
 
 va-endermite: 显示末影螨击杀次数最多的玩家
 
 va-guardian: 显示守卫者击杀次数最多的玩家
 
 va-pig: 显示杀猪最多的玩家
 
 va-sheep: 显示杀羊次数最多的玩家
 
 va-cow: 显示杀牛最多的玩家
 
 va-chicken: 显示杀鸡最多的玩家
 
 va-squid: 显示墨鱼击杀次数最多的玩家
 
 va-wolf: 显示杀死单身狗最多的玩家
 
 va-mushroomcow: 显示哞菇击杀次数最多的玩家
 
 va-ocelot: 显示豹猫击杀次数最多的玩家
 
 va-horse: 显示马击杀次数最多的玩家
 
 va-rabbit: 显示兔子击杀次数最多的玩家
 
 va-villager: 显示村民击杀次数最多的玩家
 
 va-shulker: 显示潜影贝击杀次数最多的玩家
 
 va-polarbear: 显示北极熊击杀次数最多的玩家
 
 va-elderguardian: 显示远古守卫者击杀次数最多的玩家
 
 va-witherskeleton: 显示凋灵骷髅击杀次数最多的玩家
 
 va-stray: 显示流髑击杀次数最多的玩家
 
 va-husk: 显示尸壳击杀次数最多的玩家
 
 va-zombievillager: 显示僵尸村民击杀次数最多的玩家
 
 va-skeletonhorse: 显示骷髅马击杀次数最多的玩家
 
 va-zombiehorse: 显示僵尸马击杀次数最多的玩家
 
 va-donkey: 显示杀驴最多的玩家
 
 va-mule: 显示杀骡最多的玩家
 
 va-evoker: 显示唤魔者击杀次数最多的玩家
 
 va-vex: 显示恼鬼击杀次数最多的玩家
 
 va-vindicator: 显示卫道士击杀次数最多的玩家
 
 va-llama: 显示杀羊驼最多的玩家
 
 va-parrot: 显示鹦鹉击杀次数最多的玩家
 
 va-illusioner: 显示击杀幻术士次数
 
 va-level: 显示经验等级

== 注释与外部链接 ==
* [[LeaderHeads/插件数据|插件数据]]
* [https://www.robindebaets.be/wiki/start 插件作者个人WIKI]
* [[LeaderHeads/网页插件]]

[[Category:综合]][[Category:角色]][[Category:付费]]