[ESC] Extra Special Core

ExtraSpecialCore

为 ESS 系列模组提供共享字体和轻量级 UI 组件——统一字体样式、绘制更清晰的文本，并提供可复用的按钮和搜索框，避免每个模组重复实现相同的基础功能。

ExtraSpecialCore 是一个 前置库模组。它本身不添加游戏玩法、物品或“主要功能”。其他模组依赖它提供 字体资源 和 客户端 UI 辅助功能 ，让整个生态中的界面外观和操作保持一致。

功能介绍：

ESC 内置了 字体定义 （通过 Minecraft 的 Style#withFont），并提供相关辅助工具： EscText 用于绘制和换行显示带标签的文本； EscButtons 用于创建采用 ESC 样式消息的按钮； EscSearchBox 用于创建字体样式一致的搜索框；此外还有轻量级布局组件，例如 面板、矩形、滚动列表工具，以及一个简单的 UI 样式挂钩。EscActionWheel 是一个按住按键后瞄准的轮盘：依赖它的模组可以注册按键、选项和确认回调，ESC 会负责绘制轮盘、播放菜单提示音，并在轮盘打开时阻止快捷栏按键切换物品栏位置。模组作者可以使用这些工具，以更少的重复代码和统一的视觉基准来制作设置界面、诊断 UI、指南及类似面板。

工作原理：

ESC 会在自己的命名空间下注册 extraspecialcore 字体 JSON，并提供 ResourceLocation 常量（例如 Fira Code、 Monocraft、 Unifont，以及几种街机/终端风格字体）。辅助工具会将这些字体应用于 Components 和 FormattedCharSequence 文本行，确保 拆分、换行和绘制 保持一致。更高层的模组会在自己的代码中调用该 API；ESC 不会决定打开 什么 界面或 何时—它只负责界面组件显示时的 绘制方式。

使用方法：

• 玩家： 如果某个模组页面说明需要 ExtraSpecialCore，请添加作者测试过的 相同 Minecraft 和加载器（Forge / NeoForge）版本 。单独安装 ESC 不会新增菜单—其他模组需要它时，它才会发挥作用。
• 作者： 将 ESC 声明为前置依赖，根据需要使用 EscText / EscButtons / EscSearchBox 及其他基础组件，并从 EscFonts 或内置字体 ID 中选择字体。将 客户端逻辑保留在自己的模组中；ESC 始终保持通用。

重要提示：

ESC 是前置库，不是独立内容包。请确保 加载器和游戏版本 与依赖它的模组一致（Forge 和 NeoForge 版本彼此独立）。如果模组无法加载，请先检查 依赖 ESC 的模组 ，再确认 ESC 版本和加载器 与整合包匹配。许可证和字体署名信息请查看模组内的相关文件（有关再分发的说明见 FONT_LICENSES / 模组字体文件夹下的资源）。