Glypher

模组

· 作者 LmVictor20

Glypher 是一个仅客户端的 Fabric 模组,用于在原版 Minecraft GUI 屏幕中对齐自定义标题字符。

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

最新 1.0.8 · 1.21.4 · Fabric

一键开服(送7天)

Glypher

Glypher 是一个客户端侧的 Fabric 模组,用于在真实的原版 Minecraft GUI 预览中直接对齐自定义菜单标题字形。

作者:LmVictor20 x ChatGPT

Glypher 的用途

Glypher 帮助你定位各类菜单(如箱子、铁砧、信标、熔炉、漏斗、锻造台等)的标题字形位置。

你无需在 JSON 文件中猜测偏移量,而是可以:

  • 选择原版菜单类型;
  • 选择资源包提供程序模式;
  • 输入你的资源包所使用的字形;
  • 在真实 GUI 中预览标题;
  • 调整 X 和 Y;
  • 将结果保存为小型导出文件。

Glypher 的目标并非替代你的插件配置。

其目标是使对齐过程更加简便,然后导出一个可读的结果,让你清楚了解哪些值应填入你自己的资源包或插件配置中。

支持的设置

  • Minecraft 1.21.3
  • Fabric Loader
  • Fabric API

安装方法

  1. 将 Glypher 模组的 jar 文件放入 mods 文件夹。
  2. 启用包含你的菜单字形的资源包。
  3. 确保你的资源包拥有有效的 assets/minecraft/font/default.json。
  4. 启动 Minecraft。
  5. 运行 /glypher create。

开始之前

Glypher 期望你的标题字形已存在于当前激活的资源包中。

这意味着:

  • 如果你使用 Nexo/Oraxen,请使用该插件生成的资源包中的字形;
  • 如果你使用 ItemsAdder,请使用该插件生成的资源包中的字形;
  • 如果你使用 Plain,请使用你自己 default.json 中存在的原始字形。

对于 Glypher 的输入框,字形应从生成的资源包 default.json 中获取。

换句话说,Glypher 不会为你发明字形。它帮助你对齐已经存在于你资源包中的字形。

Glypher 的工作原理

第 1 步:选择菜单

运行:

/glypher create

然后选择你想要预览的原版库存/菜单类型。

第 2 步:选择提供程序模式

Glypher 支持三种输出模式:

  • Nexo/Oraxen
  • ItemsAdder
  • Plain

这仅改变最终导出的 Title 字符串的书写方式。

第 3 步:输入字形

输入你的资源包所使用的字形。

这应该是来自你生成的 default.json 的实际字形,而不是纹理路径、占位符名称或图像文件名。

第 4 步:预览和对齐

Glypher 会打开一个真实的菜单预览,并允许你移动标题:

  • X offset 控制水平移动;
  • Y offset 控制预览中的视觉垂直移动;
  • Ascent 是你通常将传输到字体配置中的值。

第 5 步:保存

当标题看起来正确时,按 Save。

Glypher 保存:

  • 其配置文件中的布局;
  • 一个文本导出文件,包含:
    • ID
    • Provider
    • Title
    • Ascent

理解提供程序模式

Nexo/Oraxen

如果你的最终菜单标题将通过 Nexo 或 Oraxen 语法处理,请使用此模式。

导出格式:

<shift:(x)><glyph:menu_title>

示例:

<shift:(-5)><glyph:menu_title>

重要提示:

  • Glypher 在内部处理预览中的视觉 X offset;
  • 导出的结果仅用于向你展示最终的偏移结构;
  • 插件端应使用偏移部分,并通过其自身的配置解析字形;
  • 实际的字形名称或字形绑定仍由你的 Nexo/Oraxen 设置定义。

因此,在提供程序模式下,Glypher 帮助你理解偏移量和最终结构,而你的插件则负责真正的字形映射。

ItemsAdder

如果你的最终菜单标题将通过 ItemsAdder 语法处理,请使用此模式。

导出格式:

:offset_(x)::menu_title:

示例:

:offset_(-5)::menu_title:

重要提示:

  • Glypher 在内部视觉上预览位移;
  • 导出的行是 ItemsAdder 配置工作流的辅助输出;
  • 偏移量是 Glypher 真正帮助你找到的内容;
  • 字形本身应已来自 ItemsAdder 生成的资源包/配置。

Plain

如果你直接使用普通字体提供程序并希望模组本身组合可见的标题字符串,请使用此模式。

在 Plain 模式下,Glypher 以旧式方式工作:

  • 它使用内部位移字形构建标题;
  • 它直接组合最终的字符串;
  • 导出的 Title 是要使用的字面字符串;
  • 预览使用精确组合的标题文本。

如果你不使用插件端的提供程序系统,并希望完全直接控制原始字体输出,这是最佳选项。

提供程序模式与 Plain 之间的重要区别

对于 Nexo/Oraxen 和 ItemsAdder:

  • Glypher 主要应被视为对齐辅助工具;
  • 插件/提供程序系统仍负责从其自身配置中解析最终字形;
  • Glypher 的输出旨在使偏移量和结构更易于理解。

对于 Plain:

  • Glypher 的输出是你可直接使用的实际最终标题字符串。

资源包准备

你当前的资源包必须包含:

assets/minecraft/font/default.json

如果该文件已存在,请将你的新提供程序合并进去,而不是盲目替换。

最小结构:

MyPack/
  pack.mcmeta
  assets/
    minecraft/
      font/
        default.json
    mynamespace/
      textures/
        gui/
          title_example.png

位图提供程序示例

这是通常定义可见菜单标题字形的提供程序类型:

{
  "type": "bitmap",
  "file": "mynamespace:gui/title_example.png",
  "ascent": 24,
  "height": 256,
  "chars": [
    "\uE120"
  ]
}

chars 中的字符是你应复制到 Glypher 输入框中的字形。

输入字形的来源

使用 Glypher 时,你在输入框中输入的字形应来自插件或纯设置所使用的资源包内生成的 default.json。

这意味着:

  • 打开你生成的资源包;
  • 找到 assets/minecraft/font/default.json;
  • 定位到你的标题字形的 provider;
  • 从 chars 中复制实际字符;
  • 在 Glypher 中使用该字符。

X 偏移量工作原理

Plain 模式

Glypher 使用内部移位字形组合,并自行构建最终的标题字符串。

Nexo/Oraxen 和 ItemsAdder 模式

Glypher 仍允许你视觉调整标题,但导出的结果是 provider 风格的语法。

这意味着预览中的移动是内部的,而保存的输出是一个干净的、面向 provider 的标题行。

Y 偏移量 / Ascent 工作原理

Glypher 会可视化地预览垂直移动,然后导出一个 Ascent 值,你可以在字体 provider 中使用它。

这通常是你放入 default.json 中对应位图 provider 的数值。

示例:

{
  "type": "bitmap",
  "file": "mynamespace:gui/title_example.png",
  "ascent": 24,
  "height": 256,
  "chars": [
    "\uE120"
  ]
}

典型工作流

  1. 生成或准备你的资源包。
  2. 在 assets/minecraft/font/default.json 中找到标题字形。
  3. 启用该资源包启动 Minecraft。
  4. 运行 /glypher create。
  5. 选择菜单类型。
  6. 选择 provider 模式。
  7. 粘贴或输入来自 default.json 的字形。
  8. 在预览中调整 X 和 Y。
  9. 保存布局。
  10. 打开导出的文本文件。
  11. 将 Title 和 Ascent 转移到你自己的资源包或插件配置中。

命令

  • /glypher create - 创建新的标题布局
  • /glypher list - 打开已保存的布局

保存的文件

Glypher 存储:

  • 布局数据在 config/glypher/layouts.json
  • 导出文件在 config/glypher/exports/

LmVictor20 x ChatGPT

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源