MapTags - GigCore 模组工具

MapTags - 一个 GigCore 点位创作工具

请原谅这个偷懒的介绍——说实话，我预计除了 gig 作者之外，不会有多少人对这个感兴趣，完整手册已附带在帮助文件中。

一个面向内容创作者的桌面工具，用于为使用 GigCore 的模组构建带标签的世界位置包。

在游戏中扫描地图，捕获并标记点位，导出一个位置包供你的模组——或任何人的模组——按标签查找。正在制作位置？这就是为你准备的。只想游玩？你不需要这个工具——像安装其他模组一样安装位置包即可。

MapTags 2.0 已经到来： 一个大幅增强的版本，彻底改版了你的整个工作流程，让一切...嗯...真正说得通。

在 1.0 版本中，你的工作主要存在于工具的内存文件中，这些文件伪装成你的"工作区"。这与"实时文件"的概念区分开来——"实时文件"是你的 gigcore 实际在使用的包。而你唯一能真正接触到自己数据的时刻，是当你随模组发布一个包的时候。一旦发布，如果任何内容发生变化，想把这些发布的数据重新导入你的 maptags 就非常痛苦。最后，如果你犯了错误……它会永远留在那里，而且极难清除诸如误加的 commonword 之类的东西，因为 .vocab 文件是一次写入、永久读取的。我个人在使用这个工具的过程中，越来越频繁地撞上自己设计的壁垒，感到非常沮丧。而且……它的外观也很糟糕。

那么 2.0 版本带来了什么？

• 你正在处理的所有 maptag 数据都存储在你自己的 .mt 文件中，保存在你选择的工作文件夹里。保存它、折腾它、和它结婚、删掉它，随便你；这是你的文件。再也不需要和隐藏的工具内存搏斗了。
• "实时模式"的概念已被重构，并缩减为少数几个"发布到实时安装"的操作，不再让你感觉像是要解除曲速核心的安全保险。
• .vocab 的所有权已完全翻转——这对你作为模组作者来说其实没什么影响，除了更容易撤销误加的 commonword。

‼️ 题外话，因为我觉得这非常非常重要。命名空间仍然是包内使用的推荐方式。如果你必须使用 commonword，请记住：commonword 只描述一个地方。命名空间才是你在该地点/对该地点做什么。

示例：使用命名空间：'MyMod-SkrapCarz: junkyard' —— 这个地方只是一个空停车场，我要往里面塞满汽车残骸作为任务地点。 示例：使用 commonword：'Junkyard' —— 这个位置实际上就是一个垃圾场。我必须为全世界标记它。‼️

还有什么？

• 你现在可以在多个包中标记你的位置，切换你正在编辑的包，打开、关闭、弹出，或通过点击一个小图标"发布到地图包"，而无需在菜单里层层翻找。
• 各种外观/感觉/生活质量改进和修复。
• 改进了 commonword 和命名空间分类管理。这些分类也会随 gigcore 发布，gigcore 可以识别它们，用于过滤数据以服务你现成的 gigcode。实际上，这对于 gig 的潜在位置管理来说相当重要。发挥你的想象力。
• 提供了一份迁移指南，教你如何将数据从工具内存工作区和地图包中导出，并导入到新的 MAPTAG 文件格式中（实际上很容易）……我特意把它做得很简单。
• 新增了旋转数据标题，这样你就可以让 NPC 和载具在生成时面向你捕获时的同一方向。这让你可以即时获取并应用每个点的旋转数据，无需在代码里折腾这些。这……相当不错。

---

运行它

需要 Python 3（仅标准库——无需安装任何东西）。

• python maptags_editor.py
• 或在 Windows 上双击 "MapTags Editor.bat"

编辑器会自动找到你安装的 GigCore。要进行实时捕获/传送，请在 设置 --> GigCore --> MapTags Authoring 下开启游戏内桥接，然后启动游戏。

完整指南

从帮助菜单打开用户手册（或阅读此文件夹中的 MANUAL.md）。它会详细介绍什么是位置包，如何一步步制作一个，何时使用共享标签vs自有标签，如何发布包，以及如何让你的点位与其他模组协同工作。

简略版

1. 文件 --> 新建点位集 -- 以你的模组命名（这将成为你的标签命名空间）。
2. 站在游戏中的某个位置 --> + 在我所在位置添加点位。标记它。重复此操作。
3. 文件 --> 导出可安装包 --> 随你的模组发布，或作为独立附加组件发布。

你的工作会保存在一个安全的工作副本中，直到你发布到实时——在你发布之前，不会有任何内容进入游戏，而且每次发布都会保留备份。

它生成什么

一个 GigCore 加载并服务给任何按标签查询的模组的位置包。玩家通过将包放入 GigCore 的 maptags.d/ 文件夹来安装——他们无需任何工具；模组管理器会自动完成。

需要安装 GigCore（它提供游戏内桥接和编辑器读取的共享标签词汇表）。MapTags 会自行发布和更新。