Glypher
Glypher 是一个客户端侧的 Fabric 模组,用于在真实的原版 Minecraft GUI 预览中直接对齐自定义菜单标题字形。
作者:LmVictor20 x ChatGPT
Glypher 的用途
Glypher 帮助你定位各类菜单(如箱子、铁砧、信标、熔炉、漏斗、锻造台等)的标题字形位置。
你无需在 JSON 文件中猜测偏移量,而是可以:
- 选择原版菜单类型;
- 选择资源包提供程序模式;
- 输入你的资源包所使用的字形;
- 在真实 GUI 中预览标题;
- 调整
X 和 Y;
- 将结果保存为小型导出文件。
Glypher 的目标并非替代你的插件配置。
其目标是使对齐过程更加简便,然后导出一个可读的结果,让你清楚了解哪些值应填入你自己的资源包或插件配置中。
支持的设置
- Minecraft
1.21.3
- Fabric Loader
- Fabric API
安装方法
- 将 Glypher 模组的 jar 文件放入
mods 文件夹。
- 启用包含你的菜单字形的资源包。
- 确保你的资源包拥有有效的
assets/minecraft/font/default.json。
- 启动 Minecraft。
- 运行
/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 保存:
理解提供程序模式
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"
]
}
典型工作流
- 生成或准备你的资源包。
- 在
assets/minecraft/font/default.json 中找到标题字形。
- 启用该资源包启动 Minecraft。
- 运行
/glypher create。
- 选择菜单类型。
- 选择 provider 模式。
- 粘贴或输入来自
default.json 的字形。
- 在预览中调整
X 和 Y。
- 保存布局。
- 打开导出的文本文件。
- 将
Title 和 Ascent 转移到你自己的资源包或插件配置中。
命令
/glypher create - 创建新的标题布局
/glypher list - 打开已保存的布局
保存的文件
Glypher 存储:
- 布局数据在
config/glypher/layouts.json
- 导出文件在
config/glypher/exports/
LmVictor20 x ChatGPT
Glypher
Glypher is a client-side Fabric mod for aligning custom menu title glyphs directly inside real vanilla Minecraft GUI previews.
Authors: LmVictor20 x ChatGPT
What Glypher Is For
Glypher helps you position a title glyph for menus such as chests, anvils, beacons, furnaces, hoppers, smithing tables, and more.
Instead of guessing offsets inside a JSON file, you can:
- choose the vanilla menu type;
- choose the resource-pack provider mode;
- enter the glyph used by your resource pack;
- preview the title inside the real GUI;
- adjust
X and Y;
- save the result as a small export file.
The goal of Glypher is not to replace your plugin config.
The goal is to make alignment easier, then export a readable result so you understand what values should go into your own pack or plugin configuration.
Supported Setup
- Minecraft
1.21.3
- Fabric Loader
- Fabric API
Installation
- Put the Glypher mod jar into your
mods folder.
- Enable the resource pack that contains your menu glyphs.
- Make sure your pack has a valid
assets/minecraft/font/default.json.
- Start Minecraft.
- Run
/glypher create.
Before You Start
Glypher expects that your title glyph already exists in your active resource pack.
That means:
- if you use
Nexo/Oraxen, use the glyph already generated by that plugin's pack;
- if you use
ItemsAdder, use the glyph already generated by that plugin's pack;
- if you use
Plain, use the raw glyph that exists in your own default.json.
For the Glypher input field, the glyph should be taken from the generated resource pack default.json.
In other words, Glypher does not invent the glyph for you. It helps you align a glyph that already exists in your pack.
How Glypher Works
Step 1: Choose a menu
Run:
/glypher create
Then choose the vanilla inventory/menu type you want to preview.
Step 2: Choose a provider mode
Glypher supports three output modes:
Nexo/Oraxen
ItemsAdder
Plain
This only changes how the final exported Title string is written.
Step 3: Enter the glyph
Type the glyph used by your resource pack.
This should be the actual glyph from your generated default.json, not a texture path, not a placeholder name, and not the image file name.
Step 4: Preview and align
Glypher opens a real menu preview and lets you move the title:
X offset controls horizontal movement;
Y offset controls visual vertical movement in preview;
Ascent is the value you will usually transfer into your font config.
Step 5: Save
When the title looks correct, press Save.
Glypher saves:
- the layout in its config;
- a text export file with:
Understanding Provider Modes
Nexo/Oraxen
Use this mode if your final menu title will be handled through Nexo or Oraxen syntax.
Export format:
<shift:(x)><glyph:menu_title>
Example:
<shift:(-5)><glyph:menu_title>
Important:
- Glypher internally handles the visual
X offset in preview;
- the exported result is only meant to show you the final offset structure;
- the plugin side should use the offset part and resolve the glyph through its own configuration;
- the actual glyph name or glyph binding is still defined by your Nexo/Oraxen setup.
So in provider mode, Glypher is helping you understand the offset and final structure, while your plugin remains responsible for the real glyph mapping.
ItemsAdder
Use this mode if your final menu title will be handled through ItemsAdder syntax.
Export format:
:offset_(x)::menu_title:
Example:
:offset_(-5)::menu_title:
Important:
- Glypher visually previews the shift internally;
- the exported line is a helper output for your ItemsAdder configuration workflow;
- the offset is what Glypher is really helping you find;
- the glyph itself should already come from the resource pack/config generated by ItemsAdder.
Plain
Use this mode if you are working directly with normal font providers and want the mod to compose the visible title string itself.
In Plain mode, Glypher works the old way:
- it builds the title using internal shift glyphs;
- it composes the final string directly;
- the exported
Title is the literal string to use;
- the preview uses the exact composed title text.
This is the best option if you are not using a plugin-side provider system and want full direct control over the raw font output.
Very Important Difference Between Provider Modes and Plain
For Nexo/Oraxen and ItemsAdder:
- Glypher should mainly be treated as an alignment helper;
- the plugin/provider system is still responsible for resolving the final glyph from its own config;
- Glypher output exists to make the offset and structure easier to understand.
For Plain:
- Glypher output is the actual final title string you can use directly.
Resource Pack Preparation
Your active resource pack must contain:
assets/minecraft/font/default.json
If the file already exists, merge your new providers into it instead of replacing it blindly.
Minimal structure:
MyPack/
pack.mcmeta
assets/
minecraft/
font/
default.json
mynamespace/
textures/
gui/
title_example.png
Example Bitmap Provider
This is the kind of provider that usually defines the visible menu title glyph:
{
"type": "bitmap",
"file": "mynamespace:gui/title_example.png",
"ascent": 24,
"height": 256,
"chars": [
"\uE120"
]
}
The character in chars is the glyph you should copy into Glypher's input field.
Where The Input Glyph Comes From
When using Glypher, the glyph you type into the input field should come from the generated default.json inside the resource pack used by your plugin or your plain setup.
That means:
- open your generated pack;
- find
assets/minecraft/font/default.json;
- locate the provider for your title glyph;
- copy the actual character from
chars;
- use that character in Glypher.
How X Offset Works
In Plain mode
Glypher uses internal shift glyph composition and builds the final title string itself.
In Nexo/Oraxen and ItemsAdder mode
Glypher still lets you adjust the title visually, but the exported result is provider-style syntax.
That means the preview movement is internal, while the saved output is a clean provider-oriented title line.
How Y Offset / Ascent Works
Glypher previews vertical movement visually, then exports an Ascent value you can use in your font provider.
This is usually the number you will place into the matching bitmap provider inside default.json.
Example:
{
"type": "bitmap",
"file": "mynamespace:gui/title_example.png",
"ascent": 24,
"height": 256,
"chars": [
"\uE120"
]
}
Typical Workflow
- Generate or prepare your resource pack.
- Find the title glyph in
assets/minecraft/font/default.json.
- Launch Minecraft with the pack enabled.
- Run
/glypher create.
- Choose the menu type.
- Choose the provider mode.
- Paste or type the glyph from
default.json.
- Adjust
X and Y in preview.
- Save the layout.
- Open the exported text file.
- Transfer the
Title and Ascent into your own pack or plugin config.
Commands
/glypher create - create a new title layout
/glypher list - open saved layouts
Saved Files
Glypher stores:
- layout data in
config/glypher/layouts.json
- export files in
config/glypher/exports/
LmVictor20 x ChatGPT
评论 0
登录后参与评分
还没有评论,来抢沙发吧