[ESH] 特殊中心

**ExtraSpecialHUB**

---

Extra Special Studio 出品 ExtraSpecialHub。一个按键打开工作室菜单，统一的 ESC 布局，展示 ESC（以及即将推出的 ESG）能做什么，并为其他模组提供一个接入点。

它主要为了将所有 Extra Special Studio 的菜单和工作室功能整合到一个按键（F9）下，并提供统一的布局，而不是一堆风格不一的界面和快捷键。ExtraSpecialHub (ESH) 是工作室的起始菜单，而非内容包——它不会添加物品、生物群系或游戏玩法循环。游戏物品的 UI 仍然保留在对应的物品上。

---

它的功能：

按下 F9。工作室文档、ESC 演示、主题调谐器，以及其他 Extra Special Studio 工具都集中在一个中心里。布局配置和颜色来自 ESC，因此中心内的所有内容看起来都协调一致。托管的菜单有返回中心的途径，这样你不会被直接丢回游戏世界。它还展示了 ExtraSpecialCore (ESC) 的可能——主题、布局、动画、界面装饰——以及未来用于创作这些界面的 ExtraSpecialGUI (ESG)。

---

它的工作原理：

ESH 列出其他模组注册的窗口，并打开它们提供的界面。布局和主题装饰来自 ESC；ESH 只是在 F9 下托管它们。第三方模组在客户端设置时通过 EshApi.registerModWindow 接入。第三方菜单请使用 EshSection.MODS（其他模组），或者运维工具请使用 EshSection.UTILITY。

---

如何使用：

玩家：安装 ExtraSpecialHub，并搭配与你所用加载器（Forge / NeoForge 是分开的）匹配的 ExtraSpecialCore (ESC) 和 ExtraSpecialLIB (ESL)。在游戏中按 F9。如果某个模组的页面列出了 ESH，你需要在中心里找到该模组的菜单以及工作室文档。作者：依赖 extraspecialhub（以及 extraspecialcore 和 extraspeciallib）。在客户端设置时，注册一个窗口——ESH 会列出它并打开你提供的界面。

EshApi.registerModWindow(EshWindowSpec.builder(
        "yourmodid",
        "your_window",
        "Your Menu Title"
)
.section(EshSection.MODS)
.author("Your name")
.factory(parent -> new YourScreen(parent))
.build());

可选：

.group("family", "Family name") 用于嵌套相关窗口，.subtitle("…") 用于副标题，.icon(...) 用于图标。离开托管的界面时，优先使用 EshApi.openHub()。如果你已经有自己的“返回”控件，请实现 EshOwnsHubNav（或 ESC 的 EscOwnsBackNav），这样 ESH 就不会注入“← Hub”按钮。

---

重要：

ESH 是一个中心，不是一个独立的内容包。请匹配 ESC 和 ESL 的 Minecraft 版本与加载器（如果如此发布，Forge 和 NeoForge 版本是分开的）。如果按 F9 没反应，请确认 ESH 已安装在客户端，并且 ESC/ESL 版本与包匹配。