建筑笔记

BuildNotes

一个轻量级的游戏内笔记与建筑追踪模组，适用于 Minecraft，基于 Fabric 加载器构建。BuildNotes 提供了一种无缝的方式来记录你的想法、追踪建筑进度并分享信息，而无需离开游戏。它可在单人游戏中运行，也可以安装在服务器上以实现共享、协作笔记。

功能

BuildNotes 被设计为一款面向玩家和服务器管理员的灵活工具。所有笔记和建筑都按“范围（Scope）”进行分类，这决定了它们的保存位置以及谁可以看到它们。

笔记与建筑范围

• 世界范围（World Scope）： 单人游戏的默认选项。笔记和建筑保存在特定世界的文件夹中，使其与该世界绑定。
• 全局范围（Global Scope）： 笔记和建筑保存到你的全局 Minecraft 配置文件夹中。这使得它们可以在你所有的世界中访问，甚至在服务器上也可用，相当于一个个人、持久的游戏内记事本。
• 服务器范围（Server Scope）： 当客户端和专用服务器都安装了该模组时，笔记和建筑可以保存到服务器本身。所有安装了该模组的已连接玩家都可以看到这些内容，使其成为社区公告板、服务器导览或协作项目规划的完美工具。

固定与屏幕 HUD

你可以固定一条笔记和一个建筑，使它们在你的列表中保持在顶部以便快速访问。此外，当前固定的笔记会在常规游戏过程中显示在屏幕 HUD 上。这使你无需打开模组菜单即可参考方块配色方案、坐标或待办事项列表。当 F1（隐藏 GUI）、F3（调试屏幕）或任何菜单打开时，HUD 会自动换行并隐藏自身。

客户端配置

BuildNotes 包含位于 config/buildnotes 文件夹中的本地配置文件。通过 config.json，你可以完全自定义固定的笔记 HUD，包括：

• 位置（Position）： 将 HUD 锚定到 9 个不同的屏幕位置（例如 BOTTOM_RIGHT、TOP_LEFT、CENTER）。
• 大小（Size）： 调整 HUD 在你的屏幕上允许占用的最大宽度和高度。
• 内边距（Padding）： 调整 HUD 与屏幕边缘之间的距离。
• （UI 颜色也可以通过颜色配置进行自定义。）

高级文本编辑器

所有文本字段均由自定义多行文本编辑器提供支持。它包括以下便捷功能：

• 完整的撤销/重做支持（Ctrl+Z / Ctrl+Y）。
• 双击选择单词，三击选择整行。
• 直观的选择和导航（例如，Ctrl + 方向键逐词移动）。

建筑追踪器

建筑追踪器不仅仅是一个简单的笔记。它包含以下专用字段：

• 建筑名称
• 坐标与维度
• 描述与设计者署名
• 图片库： 为每个建筑上传多张截图。在服务器上时，这些图片会自动分享给查看该建筑的其他玩家。
• 自定义字段： 添加你需要的任何额外字段，用于追踪材料、农场效率或其他项目特定数据。

服务器管理与权限

安装在 Fabric 服务器上时，BuildNotes 提供完整的权限系统来控制谁可以创建、编辑和删除服务器范围的笔记。

• 管理员访问权限： 服务器管理员默认可以编辑服务器笔记。
• 权限命令： 命令系统允许管理员授予或撤销特定玩家的编辑权限。
• 允许全部模式： 一个简单的命令开关，允许服务器上的所有玩家编辑笔记，非常适合规模较小、值得信任的社区。

管理员命令：

/buildnotes allow <player>
/buildnotes disallow <player>
/buildnotes list
/buildnotes allow_all <true|false>

截图

笔记

建筑

下载

你可以从以下位置下载 BuildNotes 的最新版本：

• Modrinth
• CurseForge

依赖项

• Fabric API： 所有功能都需要。

未来计划

• 用于客户端设置的游戏内配置界面。
• 对笔记进行分类或添加标签以便更好地组织。
• 可能与其他模组集成（例如，与世界地图模组集成以创建路径点）。

许可证

本项目采用 MIT 许可证。详情请参见 LICENSE。