config.yml

模块设置:

• 此部分控制哪些模块处于活动状态:

  • nameplates，backgrounds，bubbles，bossbars，actionbars，和 images 都设置为 true，表示这些功能已启用。修改这些设置可能会影响资源包的生成，因此如果遇到问题，可能需要重新安装资源包。

modules:
  nameplates: true
  backgrounds: true
  bubbles: true
  bossbars: true
  actionbars: true
  images: true

插件集成:

• resource-pack: 在这里，您可以选择是否集成来自特定插件（如ItemsAdder和Oraxen）的资源包。

• 聊天集成: 可以集成支持的聊天插件来实现黑名单频道和忽略功能等功能。

integrations:
  resource-pack: ...
  chat: ...

资源包生成设置:

• disable-generation-on-start: 设置为 false，允许在服务器启动时生成资源包。

• namespace: 该字段定义资源包的命名空间，此处设置为 "nameplates"。

• font: 指定要使用的字体。默认字体设置为 "default"。

• initial-char: 定义自定义字体的起始字符。这里使用뀁，这不会影响聊天时的正常韩语字符。

• image-path: 指定各种资产（铭牌、背景、图像等）的 PNG 文件的生成位置。这些路径有助于维护有序的资源包结构。

• transparent-bossbar: 生成透明boss栏的设置

• legacy-unicodes: 在 Minecraft 1.20+ 客户端中启用对旧版 Unicode 字符的支持，为您的资源包大小增加约 900KB。

resource-pack:
  disable-generation-on-start: false
  namespace: "nameplates"
  font: "default"
  initial-char: '뀁'
  image-path:
    nameplates: 'font/nameplates/'
    backgrounds: 'font/backgrounds/'
    images: 'font/images/'
    bubbles: 'font/bubbles/'
    space-split: 'font/base/'
  shader:
    enable: true
    hide-scoreboard-number: false # 1.19.4 - 1.20.3
    animated-text: false
    ItemsAdder-text-effects: false
  transparent-bossbar:
    color: YELLOW
    "1_20_2+": true
    "1_17-1_20_1": true
  legacy-unicodes: true

其他设置:

• legacy-color-code-support: 启用对旧版 Minecraft 颜色代码的支持（使用 &）。禁用此功能可以提高颜色格式化性能。

• send-delay: 指定 actionbar/bossbar 的延迟以确保与其他插件的兼容性。

• catch-other-plugin-actionbar: 设置为 true 以捕获来自其他插件的操作栏。

• unsafe-chat-event: 设置插件是否应该监听由未知插件取消的聊天事件。

• refresh intervals: 定义条件和占位符的默认刷新间隔。

other-settings:
  legacy-color-code-support: true
  send-delay: 0
  catch-other-plugin-actionbar: true
  unsafe-chat-event: false
  default-condition-refresh-interval: 1
  default-placeholder-refresh-interval: 1
  placeholder-refresh-interval:
    "%player_name%": 100
    "%vault_prefix%": 1

字体模板:

• font-templates: 此部分定义系统如何​​加载不同的字体，例如space、unihex和bitmap 字体。您可以在此处添加新配置或替换现有字体模板。它管理 Minecraft Font Providers 提供的各种字符类型

• 字体配置选项:

  • file: 指的是位于 /CustomNameplates/font 目录中的文件。

  • custom: 指定是否使用客户端提供的默认 PNG 位图字体。

  • generate: 指示是否在生成的资源包中包含此字体的副本。

other-settings:
  font-templates:
    space:
      space:
        ' ': 4
        ‌: 0
    unihex:
      unifont:
        file: "unifont.zip"
        generate: false
        size_overrides:
        - from: "、"
          to: "ヿ"
          left: 0
          right: 15
        - from: "㈀"
          to: "鿿"
          left: 0
          right: 15
        - from: "ᄀ"
          to: "ᇿ"
          left: 0
          right: 15
        - from: "㄰"
          to: "㆏"
          left: 0
          right: 15
        - from: "ꥠ"
          to: "꥿"
          left: 0
          right: 15
        - from: "ힰ"
          to: "퟿"
          left: 0
          right: 15
        - from: "가"
          to: "힯"
          left: 1
          right: 15
        - from: "豈"
          to: "﫿"
          left: 0
          right: 15
        - from: "！"
          to: "～"
          left: 0
          right: 15
      unifont_jp:
        file: "unifont_jp.zip"
        generate: false
        filter:
          jp: true
        size_overrides:
        - from: "㈀"
          to: "鿿"
          left: 0
          right: 15
        - from: "豈"
          to: "﫿"
          left: 0
          right: 15
    bitmap:
      ascii:
        codepoints: "ascii"
        file: "ascii.png"
        height: 8
        custom: false # 这是非默认的 Minecraft 字体吗？如果启用，插件将在生成的资源包中创建新的字体图像
      ascii_sga:
        codepoints: "ascii_sga"
        file: "ascii_sga.png"
        height: 8
        custom: false
      asciillager:
        codepoints: "asciillager"
        file: "asciillager.png"
        height: 8
        custom: false
      nonlatin_european:
        codepoints: "nonlatin_european"
        file: "nonlatin_european.png"
        height: 8
        custom: false
      accented:
        codepoints: "accented"
        file: "accented.png"
        height: 12
        custom: false
    legacy_unicode:
      legacy_unicode:
        file: "unicode_page_%02x.png"
        height: 8
        custom: false
    unicode:
      unicode:
        file: "unicode_page_%02x.png"
        sizes: "glyph_sizes.bin"
    ttf:
      example:
        generate: false
        file: "example.ttf"
        size: 10.0
        oversample: 8.0
        skip: []

下降字体:

详见下降文本

other-settings:
  shift-fonts:
    shift_0:
      - space
      - nonlatin_european:7
      - accented:9
      - ascii:7
      - unifont_jp
      - unifont
    shift_1:
      - space
      - nonlatin_european:3
      - accented:6
      - ascii:3
      - legacy_unicode:3
    shift_2:
      - space
      - ascii:-15