ScoreFixer

数据包

· 作者 SilicatYT

防止在玩家名称更改后分数丢失。

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

最新 1.3.1 · 26.3 · 数据包

一键开服(送7天)

ScoreFixer

一个强大的 Minecraft 数据包库,可防止玩家改名后计分板数值丢失。
如有咨询,请在 Discord 上联系 @silicatYT。

下载:Modrinth
问题追踪器:GitHub

为什么需要这个?

在 Minecraft 中,分数与用户名绑定而非 UUID。因此,更改你的名称会重置你之前持有的分数(这可能会破坏数据包或导致进度丢失),任何使用你旧名称加入的玩家都可以接管你之前的分数。
ScoreFixer 解决了这个问题,让你能够自动将分数转移到新名称而不会产生冲突。

功能

  • 在名称变更时,自动将特定计分板目标对象的数值转移给新玩家名称
  • 使用 UUID 或特定的计分板数值(例如 ID 分数)作为选择器来读取/写入离线玩家的分数
  • 事件(函数标签):#score_fixer:changed_name、#score_fixer:joined_game 和 #score_fixer:left_game

使用方法

使分数在改名时转移

要使 ScoreFixer 在名称变更时自动转移目标对象(例如 "foo" 和 "bar"),请运行 /function score_fixer:util/track_objectives {Objectives:["foo", "bar"]}。

若要取消跟踪目标对象,请运行 /function score_fixer:util/untrack_objectives {Objectives:["foo", "bar"]}。

或者,你可以直接向数据存储 score_fixer:objectives List 中添加或删除 {Name:"foo"}。

访问离线玩家的分数
加载

你可以通过运行 /function score_fixer:util/load_with_uuid {UUID:...}(支持十六进制和整数数组格式)并使用其 UUID 来访问离线玩家的分数。如果找到该玩家,其数据将被复制到 score_fixer:loaded Players。从这里,你可以进行修改(调整分数值、从列表中移除目标对象以重置它们等)。
或者,你可以手动复制符合自定义条件的每个玩家的数据,如下所示:

/data modify storage score_fixer:loaded Players append from storage score_fixer:zprivate Maps[{Objectives:[{Name:"foo",Value:10}]}]
保存

在对 score_fixer:loaded Players 中的目标对象应用更改后,运行 /function score_fixer:util/save 以一次性保存所有已加载玩家的数据。

事件
  • #score_fixer:changed_name: 当玩家使用新名称加入时,此函数标签将作为该玩家执行。数据存储 score_fixer:event Data 包含 Name、OldName 和 UUID。
  • #score_fixer:joined_game: 当玩家加入时,此函数标签将作为该玩家执行。数据存储 score_fixer:event Data 包含 Name 和 UUID。
  • #score_fixer:left_game: 当玩家离开时,此函数标签将执行。数据存储 score_fixer:event Data 包含 Name 和 UUID。

score_fixer:event Data 内部的数据也可以通过宏直接访问。

升级或卸载 ScoreFixer
  • 卸载: 运行 /function score_fixer:uninstall。
  • 升级:
    • 卸载当前版本(保留相关数据),用新版本替换数据包,然后运行 /reload。
    • (v1.2.0+) 从 v1.2.0 升级到更高版本无需先卸载当前版本。

须知

已知错误(仅限单人游戏)
  • 在崩溃后立即加入单人世界时,无法检测是否经过了任何时间。因此,除非发生了名称变更,否则如果在玩家离线期间没有经过时间,加入和离开事件将不会触发。
  • 在非常特殊的情况下,分数无法转移:
    • 玩家(John)通过停止服务器、离开单人世界或使其崩溃而离开
    • John 或另一名玩家(Steve)使用 John 的名称但大小写不同在单人世界中加入世界
  • 在与上一个错误类似的条件下(但必须是不同的玩家),John 的下一次加入将无法被检测到

无法在崩溃后检测先前在线玩家的加入的原因是他们会从服务器中移除,且其 leave_game 分数未增加。这是单人游戏独有的,因为只要玩家因崩溃离开和重新加入之间至少经过 1 个刻,就可以修复此问题,这在服务器上是有保证的。

当名称仅在大写上不同时无法转移分数的原因是 /scoreboard 命令会自动将名称的大小写转换为匹配在线玩家名称的大小写。这使得无法获取或设置离线玩家的分数,如果有人使用相同名称(但大小写不同)在线。这是单人游戏独有的,因为只要玩家离开和使用相同名称但大小写不同的玩家加入之间至少经过 1 个刻,就可以修复此问题,这在服务器上是有保证的。

ScoreFixer 的注意事项
  • 在玩家离线时手动设置的分数(例如 /scoreboard players set SilicatYT foo 1)如果玩家使用新名称加入,则无法转移。请改用 load 和 save 工具。
    • 原因:当玩家离线时,游戏对该名称不区分大小写,使得如果玩家仅更改了名称的大小写,则无法将分数从前一个名称复制到新名称。
Lantern Load

ScoreFixer 支持 Lantern Load,这是一种约定,允许你指定依赖项(包括版本)并控制数据包的运行顺序。务必确保 ScoreFixer 在你的数据包之前加载和刻执行,这样你的数据包在检查分数时,分数已经分配给了新的玩家名称。

  • 让 ScoreFixer 在你的数据包之前加载和刻执行: 将 ScoreFixer 指定为 Lantern Load 的依赖项(使其优先加载),并使你的 load 函数启动一个自调度的 tick 函数,而不是使用 #minecraft:tick。
  • #ScoreFixer load.status: 此分数在 ScoreFixer 加载后设置一次。其值告诉你 ScoreFixer 是否已加载。负值为错误代码:
    • 1: ScoreFixer 正确加载且可以使用
    • <unset>: ScoreFixer 无法加载(例如未安装)
    • -1: 安装了多个不兼容的 ScoreFixer 版本
    • -2: 尝试加载某个版本的 ScoreFixer,而之前已安装了一个更新版本且未手动卸载
    • -3: 尝试加载某个版本的 ScoreFixer,而之前已安装了另一个未知版本且未手动卸载
  • #ScoreFixer.Version load.status: 此分数在 ScoreFixer 加载后设置一次。其值告诉你 当前安装的 ScoreFixer 版本。它是一个整数,每当进行潜在的破坏性更改时(例如行为更改、工具函数重命名等),该整数值就会递增。如果该值没有变化(例如仅进行了优化),那么任何使用 ScoreFixer 的数据包也无需进行任何更改。

致谢

来自 CMDred:

  • SilicatYT

额外帮助:

  • Leinad677YT (咨询与创意)

许可证

根据 MIT 许可证,只要你注明原始作品的出处,你就可以重新分发、修改和使用 ScoreFixer。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源