Leaderboard api 1.21-1.21.10

数据包

· 作者 mr_II

一个允许你创建自定义排行榜的工具

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

最新 v1.12 · 1.21.10 · 数据包

一键开服(送7天)

请务必阅读此内容

使用方法
命令 在游戏中执行:
/function highscore:leaderboard/copy.example

以获取所有可执行命令的访问权限。

召唤(Summoning) 请注意,即使使用相同的分数名称,您也可以在世界中召唤多个排行榜。但是,它们的统计数据不会从一个排行榜转移到另一个排行榜。

目前有两个召唤命令:

summon_10(始终在排行榜中召唤 10 个槽位)

summon(允许您自定义排行榜中的槽位数量)

summon_10 示例:

/function highscore:leaderboard/summon_10 {"score":"deaths","billboard":"center","toptolow":1,"format":"default"}

summon 示例:

function highscore:leaderboard/summon {"score":"deaths","billboard":"center","toptolow":1,"format":"default","slots":5}

宏及其功能说明

  1. format 将控制排行榜的外观 (有两种选项:format1(简洁版)和 default(稍微定制版)。您还可以添加自己的格式(请参阅 formats 以了解如何操作)) 示例: ,"format":"format1"

  2. 如果您将函数更改为 "/function highscore:leaderboard/summon",则需要添加另一个宏 "slots",并在其后指定您希望排行榜拥有的槽位数量 示例: ,"slots":5

  3. billboard 决定排行榜如何面向玩家,参见 Minecraft Wiki, billboard NBT tag for display entities 基本上,"center" 表示始终面向玩家,"horizontal" 表示在垂直平面上面向玩家,"vertical" 表示在水平平面上面向玩家,"fixed" 表示始终面向同一方向 示例: ,"billboard":"fixed"

  4. score 决定此排行榜将从玩家的哪个分数目标中获取数据,例如,如果是击杀数,它将获取玩家在 "kills" 记分板目标中的击杀数。 例如: ,"score":"kills"

  5. toptolow 决定排行榜是按从高到低(排行榜顶部到最低)还是从低到高排序(与前者相同但相反) 例如,如果您想按从高到低排序分数,请执行: ,"toptolow":1 。 如果您想按从低到高排序,请执行: ,"toptolow":0 。

击杀排行榜 有三个用于销毁排行榜的命令:

1

/function highscore:leaderboard/kill.all

销毁世界中的所有排行榜。

2

/function highscore:leaderboard/kill.nearest

销毁离你最近的排行榜。

3

/function highscore:leaderboard/kill.score {"score":"deaths"}

销毁所有具有相同分数名称的排行榜。

将玩家添加到排行榜

- 要添加玩家:

/function highscore:add_player/start {"score":"deaths"}

您需要以玩家身份运行此函数,这将把玩家添加到所有具有相同 "score" 名称的排行榜中(这也控制它从哪个记分板目标中获取数据),因此如果它是 {"score":"deaths"},它将把你的 "deaths" 记分板目标数据添加到具有相同 "score" 名称的排行榜中。

- 要添加假人(Fake Players),您可以执行:

/execute at @s as @n[tag=leaderboard.marker] at @s run function highscore:parts/orginize1/start {"name":"#nothing","score":"deaths","score_num":1}

name 将是假人的名字 所以如果你想把名字改成 brain,你需要将 "name":"#nothing" 改为 "name":"brain",

score 控制分数,这不是必需的(我认为),但只是为了更清晰,例如: ,"score": "kills" 对应于排行榜 kills

score_num 确定他们的分数,例如: ,"score_num": 1

*请注意,这只会将分数添加到最近的排行榜中。如果您希望特定的排行榜运行此操作,则必须以如下方式运行下面的函数 *另外,如果您希望它按从低到高排序,请将函数名称更改为

function highscore:parts/orginize2/start <macros here>

- 要让玩家自动添加自己的分数,您需要执行: 您需要在 tick.mcfunction(或 main.mcfunction 或重复命令方块)中以玩家身份 (@a) 运行以下命令:

execute unless score @s z.leaderboard.copy.<score name here> = @s <score name here> run function highscore:refresh_score/sync_init {"score":"<score name here>","score1":"z.leaderboard.<score name here>"}

这将刷新玩家到所有具有相同分数名称的排行榜中。 只需将 <score name here> 替换为您的分数名称即可。

*请注意,在函数 "highscore:player_tick" 的第 4 行,有一个针对 deaths 的设置(如果您难以让自定义设置正常工作,或者只是不希望 deaths 每刻刷新)。

*此外,这仅在您的分数发生变化时才会刷新(以节省性能)。

在版本 1.02 中,命令已缩短为:

execute unless score @s z.leaderboard.copy.<score name here> = @s <score name here> run function highscore:refresh_score/sync_init {"score":"<score name here>"}
格式(Format) 在 load.mcfunction 函数的末尾附近,您将看到向名为 leaderboard:formats 的存储添加内容的命令。为了添加您自己的格式,您可以复制粘贴 example_format 并更改子存储的名称(我不确定它的正式名称是什么)

一旦创建了您的格式,在召唤命令中将 format 更改为您新创建的存储的子存储名称。 例如,如果您创建了一个名为 "format_here" 的新格式,那么在召唤命令 -> format 中执行 ,"format":"format_here"}

现在关于格式的

如果您已安装 v1.02,则可以通过密钥 "remove_0s" 更改排行榜是否显示分数为 0 的玩家:值为 1 表示不显示分数为 0 的玩家,值为 0 表示显示分数为 0 的玩家。

示例: "remove_0s:0"

text_color 将控制标题的颜色、粗体和斜体(编辑方式类似于 JSON 文本)。此外,我认为如果添加一个新字段 "text",它将覆盖原始文本。

示例: "text_color:',\"color\":\"blue\"}' " -> 将使标题变为蓝色

spacing 控制每个数字前的字符,因此您可以在槽位编号前更改其内容。

示例: "spacing: '{\"text\":\"→ \",\"color\":\"white\"}' "

numbers 字段包含两项内容:

  1. default:排行榜数字槽位默认使用的 JSON 格式。

示例: "default:',\"color\":\"white\"}' \"

2 个覆盖项,将为列表中添加的特定槽位生成异常 JSON 格式。你需要添加两个包含两个键的项目:num(将为其创建异常的槽位编号)和 text(要应用的 JSON 格式异常)。

示例: "{num:1,\"text\":{\\\"color\\\":\\\"red\\\",\\\"bold\\\":true}}"}

每个 JSON 格式的结尾需要以 " }" 结束,开头需要以 , 开始(空格除外,因为空格不能以逗号开头)。

清除排行榜 你必须以拥有标签 `"leaderboard.marker"` 的 **排行榜标记实体** 身份运行这些命令。即执行类似 `"execute as @e[tag=leaderboard.marker,type=marker] run ..."` 的命令。如果你想清除整个排行榜,则使用 `<as the marker>`(即以该标记的身份执行)。
function highscore:clear/clear_all

或者,如果你想移除特定的槽位,请执行:

function highscore:clear/clear_id {"id":1}

其中 ID 数字用于控制槽位的 ID。如果将其更改为 2,则会移除位于第 2 槽位的任何玩家,并将后续所有玩家依次前移。

如果您已安装 1.02 版本,则有一个新的清除命令“clear_zero”,该命令会移除所有得分为 0 的槽位。

function highscore:clear/clear_zero
限制 排行榜 API 不支持多个分数数值,因此你无法让它显示如 00:00:00.00 这样的时间格式(未来可能会添加实现此功能的方法)。 你无法直接传送至排行榜实体,必须重新生成它。 如果你召唤了一个新的排行榜(具有相同的分数),原有排行榜的数据不会自动复制到新排行榜中,因此你需要手动将它们粘贴到其他排行榜中(很抱歉)——仅对可见的槽位进行此操作即可,无需为每个玩家单独处理。

你可以使用以下命令来复制数据(顺便一提,排行榜中的假玩家和真实玩家在排行榜内部是同一概念,因此它可以覆盖普通玩家的分数)。

/execute at @s as @n[tag=leaderboard.marker] at @s run function highscore:parts/orginize1/start {"name":"#nothing","score":"deaths","score_num":1}

如果你将某个玩家或假玩家的分数更改为更低,而该排行榜是按从高到低排序的,那么即使其分数低于前一个槽位的玩家分数,它仍会停留在原槽位。

从排行榜获取数据 如果你想获取完整的排行榜列表,请执行:
data get entity @n[type=minecraft:marker,tag=leaderboard.marker] data.score_list

或者,如果你想获取特定槽位的数据,请执行:

data get entity @n[type=minecraft:marker,tag=leaderboard.marker] data.score_list[{id:3}]

然后在末尾加上一个点号和你想获取的字段名。例如,如果你想获取最高分玩家的分数数值,请执行:

data get entity @n[type=minecraft:marker,tag=leaderboard.marker] data.score_list[{id:1}].score_num
致谢
  • mr_II - 本 API 的作者。

  • Phoenic - 贡献了移除零值的代码。

希望这些信息已经足够,如果你还需要帮助,随时在 Discord 上联系我 @mr_ii,我会尽力提供帮助。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源