[ESL] Extra Special LIB

ExtraSpecialLib

为 Extra Special Studio 模组提供共享的后端辅助工具——模组列表检查、小型注册表，以及可选的 Forge 配置构建器工具，避免每个 ES 模组重复实现相同的基础代码。

ExtraSpecialLib (ESL) 是一个前置库模组。它本身不会添加玩法、物品、界面或“主要功能”，也不负责任何面向玩家的配置文件。其他 Extra Special Studio 模组会依赖它提供轻量的共享后端工具，让软依赖和注册表在整个模组体系中保持一致。

功能介绍：

ESL 提供一套小型 Esl* API： EslMods 用于检查“某个模组是否已加载”以及注册存在时执行的钩子； EslRegistry 用于线程安全的键值注册表； EslStrings 提供简单的字符串辅助工具； EslConfig 则提供可选的 ForgeConfigSpec 构建器辅助工具（仅限 begin / push / pop）。此外，EslLobby / EslLobbyManager / EslLobbyEvent 用于服务端队伍会话（不含数据包或 GUI）；EslWaveSequence / EslWaveController / EslWaveManager 用于多轮防御波次；EslForceLoadRegistry 则用于按站点 ID 保持一个区块处于加载状态，并将其与地图一同保存，在服务器启动时重新应用。这些配置辅助工具仅用于搭建结构——不会定义任何键，也不会写入 TOML。实际设置始终由使用这些工具的模组管理（例如 ExtraSpecialCore 主题配置、ES Hub 客户端设置）。ESL 完全不含 GUI、渲染或界面循环代码。

工作原理：

依赖 ESL 的 ES 模组会在自身代码中调用 ESL。软集成使用 EslMods ，而非对类进行硬引用。当 ESS 体系中的模组需要共享配置区块的基础结构时，可以使用 EslConfig，同时仍由该模组自行声明并管理其 Forge 配置文件。ESL 不会打开菜单、绘制界面、决定游戏规则或集中管理整合包设置。

使用方法：

玩家：如果某个模组页面说明需要 ExtraSpecialLib / ESL（通常是因为 ExtraSpecialCore 需要它），请安装作者测试过的相同 Minecraft 版本和加载器（Forge / NeoForge）版本。单独安装 ESL 不会带来新菜单或新配置——它只是其他模组所需的前置库。
作者（Extra Special Studio / 未来的 ES 模组）：将 ESL 声明为依赖项；按需使用 EslMods / EslRegistry / EslStrings / EslLobby / EslWave / EslForceLoadRegistry。仅将 EslConfig 用作可选的构建器辅助工具——所有实际配置键和 TOML 文件都应由你自己的模组管理。ESS 体系以外的内容模组应完全自行管理配置。

重要提示：

ESL 是前置库，不是独立的内容整合包，也不是共享设置的集合。配置文件由各自的模组管理；只有 ESS 体系（ExtraSpecialCore、ES Hub、Extra Special GUI 及未来的 ES 模组）应使用 ESL 辅助工具。请确保加载器和游戏版本与依赖 ESL 的模组相匹配（如果 Forge 和 NeoForge 版本分别发布，它们就是不同版本）。如果模组无法加载，请先检查依赖 ESL 的模组，再确认 ESL 版本和加载器与整合包相匹配。