config.yml

模块设置:

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

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

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

插件集成:

  • resource-pack: 在这里,您可以选择是否集成来自特定插件(如ItemsAdderOraxen)的资源包。

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

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: 此部分定义系统如何​​加载不同的字体,例如spaceunihexbitmap 字体。您可以在此处添加新配置或替换现有字体模板。它管理 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

最后更新于