从2.2版本迁移到2.3版本指南

第一部分：玩家数据

情况1：我正在使用 YAML

步骤1：停止服务器并安装 CustomNameplates 步骤2：运行 /nameplates data export-legacy YAML 步骤3：运行 /nameplates data import exported-xxxx-xx-xx-xx-xx.json.json.gz

情况2：我正在使用 MySQL/MariaDB

步骤1：停止服务器并安装 CustomNameplates 步骤2：配置 /CustomNameplates/database.yml 并 重载 插件 步骤3：运行 /nameplates data export-legacy MySQL/MariaDB 步骤4：停止服务器并从数据库中删除 "nameplates_data" 表 步骤5：启动服务器并运行 /nameplates data import exported-xxxx-xx-xx-xx-xx.json.json.gz

常见问题： 问：如果我无法迁移数据，玩家的名牌会丢失吗？ 答：不会，您玩家的名牌和气泡所有权由权限存储。

第二部分：配置

我宁愿自己写更多的代码，也不愿让用户感到痛苦。因此，当您重新启动服务器时，几乎 99% 的配置都会自动转换。但在将服务器恢复到生产环境之前最好先查看这些文件。

① custom-placeholders.yml vanilla-hud

为了提高性能，Vanilla hud 不再支持图片部分的占位符。如果您使用其他插件的图片，请在 customnameplates 中注册它们。

旧配置

新配置

② custom-placeholders.yml descent-unicode

如果您收到警告 "Duplicated key 'xxx' found during migration. Please manually fix that."，这是因为在合并两个部分时存在相同的键，下面是为什么会出现这种情况的示例。

旧配置

新配置

③ image-width.yml 现在改为 font-width-data.yml

2.3 版本开始支持字体宽度数据，因此旧配置在新版本中不再生效。当您成功将字符转移到新文件中后，可以安全地删除 image-width.yml。我之所以不自动为您转换是因为 image-width.yml 包含的数据太多了。它们被新的 "template-loading-sequence" 选项所取代。

④ 现在您可以在 actionbar.yml 中最多创建 1 个 actionbar 配置。如果您有多个配置，插件将给出警告。

⑤不再支持 <font:unicode_ascent_x> </font>

为了减小资源包的大小，字体已合并，因此这些 unicode_ascent_x 字体已不再支持。

custom-placeholders.yml

之前:

static-text:  
  income_actionbar:
    position: middle
    text: "<font:nameplates:unicode_ascent_8>%nameplates_actionbar%</font>"
    value: 180

之后:

static-text:
  income_actionbar:
    position: middle
    text: "%nameplates_actionbar%"
    value: 180

contents/bubbles/chat.yml

之前:

text-format:
  start: '<black><font:nameplates:unicode_ascent_8>'
  end: '</font></black>'

之后:

text-format:
  start: '<black>'
  end: '</black>'

现在迁移已完成。您需要做的是从插件文件夹中删除 README.txt 并重新启动服务器！