LOTRGuiLib

LOTRGuiLib 是一个为 Mevans 的《指环王》模组 (Lord of the Rings Mod) 创建的 Minecraft 1.7.10 子模组实用库。

它提供了共享的 GUI 组件、动态 UI 布局系统和渲染辅助工具，用于修复常见的界面错误，并简化自定义菜单、地图界面和玩家覆盖层的构建过程。

功能特性

• 动态布局与容器面板： 为基于中土风格主题的界面而设计的可自定义 GUI 容器面板、可滚动文本视图、下拉菜单和灵活的按钮控件。
• 完整的小部件集： 按钮、开关、标签、文本输入框、滑块、下拉菜单、列表视图、滚动窗格和可拖拽小部件——所有这些都带有主题样式，并全部由面板系统负责布局。
• 命名主题： 只需注册一次调色板，所有小部件、面板和覆盖层都可以通过名称使用它进行绘制。未知名称将回退到默认主题，而不会导致错误。
• 羊皮纸背景渲染： 实现了干净的 Tessellator 绘制方式来处理羊皮纸 GUI，以防止透明背景故障和 OpenGL 状态损坏。
• 纹理绑定回退机制： 使用反射进行纹理绑定（同时处理 MCP 和 SRG 方法名），确保子派系横幅图标在混淆的整合包环境中也能可靠渲染。
• 交互式地图与领土覆盖层： 为构建自定义地图覆盖层、封地/王国数据展示、航点信息面板和派系管理界面提供基础组件。覆盖层支持点击感知，多个模组可以并排注册它们。
• 为你绘制玩家覆盖层： 将 HUD 元素锚定到屏幕的任何角落或边缘，库就会渲染它——无需编写事件处理器。锚定位置会针对每帧的实时屏幕尺寸进行解析，因此在窗口调整大小和 GUI 缩放变化时也能保持位置固定，并且 HUD 渲染状态会在你的绘制代码周围进行保存和恢复。
• 对话界面： 可复用的 NPC 对话界面，包含发言者、对话内容和可链式回复列表，并可在对话中途重建以实现分支对话。
• 自定义合成台： 为你的自定义合成方块提供一个现成的 GUI 和容器配对，配方逻辑已处理，并使用池化 ID 以防止两个模组冲突。
• 更多功能…

环境要求

• Minecraft 1.7.10
• Forge 10.13.4.1614 或更高版本
• 《指环王》模组（Legacy 版）

使用方法

将 .jar 文件放入你的 .minecraft/mods 文件夹中，与主 LOTR 模组放在一起。

给模组开发者的说明

LOTRGuiLib 是保留所有权利 (All Rights Reserved) 的。在发布基于此库构建的模组之前，请先征求许可。

致谢与免责声明

• 《指环王》模组 由 Mevans 创建。LOTRGuiLib 是一个非官方附加组件，与他无关联，也未获得他的认可。
• 托尔金遗产基金会 (The Tolkien Estate) 拥有 J.R.R. 托尔金著作的底层文学版权。
• 中土企业 (Middle-earth Enterprises)（隶属于 恩布拉克集团 (Embracer Group)）拥有《指环王》(The Lord of the Rings) 和《霍比特人》(The Hobbit) 在全球范围内影视、电子游戏、舞台剧和周边商品的独家权利。
• 本项目是一个非商业性的粉丝作品，不主张对中土或其任何知识产权的所有权。