疑难解答
本页汇总 云北城建：豹猫指示牌 的免责声明与使用过程中的常见问题。遇到问题可以先在这里找一找，若仍无法解决，请到项目仓库的 Issues 页面反馈。
免责声明
本模组仅提供与道路标识相关的框架和功能。玩家或服务器服主通过资源包导入的任何自定义内容（包括但不限于图片、字体、文案等）均由使用者自行承担全部责任。严禁利用本模组制作、传播任何违法违规内容，由使用者自行制作的内容引发的纠纷，模组作者概不负责。
本模组的问题反馈请提交至 云北城建：豹猫指示牌 仓库的 Issues 页面，请勿提交至原 豹猫指示牌 的仓库。
尽管我们在发布前已进行了测试，但修改游戏内容始终伴随风险。强烈建议您在安装或更新模组前备份您的游戏存档。因模组冲突、操作不当等原因导致的数据丢失或存档损坏，作者无法承担相关责任。
常见问题
Q1：为什么告示牌上的图案颜色，和告示牌方块本身的颜色有色差？
这是由 Minecraft 游戏底层的渲染特性决定的，属于正常现象。本模组作为 云北城建 的附属，继承了其基于原版的文本组件机制。即使文本和方块在代码里设定了完全相同的颜色（色号），由于它们经过的渲染通道不同，最终在屏幕上呈现的视觉效果依然会存在差异。
- 方块使用的是世界着色器（World Shaders），它会根据周围方块的光照等级进行平滑插值，计算出真实的阴影和明暗变化。
- 告示牌上的文本或图案是作为第二图层 画 在方块上的，使用的是独立字体着色器，对环境光的响应远不如方块灵敏。
要彻底解决这个问题，需要完全重写底层的渲染机制，难度极高且容易产生其他模组冲突，因此目前无法完美消除色差。
Q2：为什么安装了 Caxton、Modern UI 之类的模组后，告示牌的排版和对齐会变化？
本模组的字体渲染排版，很大程度上取决于 Minecraft 原版的字体渲染引擎，而上述模组会深度替换或修改底层的文字渲染机制。不同的渲染引擎对字距、行高和字符大小的计算方式不同，切换渲染机制自然会导致原本对齐的字体偏移、排版错乱或大小改变。
目前暂无通用的解决方案，建议在同一个存档或服务器中，始终保持一种字体渲染环境，不要中途随意切换此类模组。
Q3：为什么看不到告示牌上的图案，或者字变成了方框，甚至完全不显示？
这通常是因为资源包未正确加载导致的。
如果你加入的是多人服务器，或正在游玩特定存档，说明该内容调用了自定义的资源包。请确保你已经在游戏的 资源包 界面中，正确放入并启用了对应的资源包。如果资源包缺失，游戏找不到对应的图片或字体文件，就会显示为错误方框或直接隐形。
Q4：本模组的后续开发计划是什么？
云北城建：豹猫指示牌 是 豹猫指示牌 的非官方分支，由云北团队移植到 云北城建 生态。主体功能已趋于稳定，短期内不会做大规模功能更新，后续重点为高版本移植、bug 修复以及少量内容补充。受精力限制，不会跟进全部游戏版本，只会选取部分主流版本更新。
请注意：以上均为 云北城建：豹猫指示牌 的开发计划，与 云北城建 本体的计划无关。有关 云北城建 的计划，请以 云北城建 模组作者发布的内容为准。
Q5：本模组支持哪些加载器？在 Forge / NeoForge 上运行需要注意什么？
云北城建 生态提供多个平台的构建产物：云北城建本体按游戏版本分别提供 Fabric、Forge、NeoForge 版本； 云北城建：豹猫指示牌 基于 Architectury 开发，目前提供 Fabric 与 Forge 两个版本。
使用前请核对以下两点：
- 下载与你的加载器对应的 jar。Fabric 版与 Forge 版不能混用，装错了会直接无法启动或加载失败。
- 前置模组《云北城建》的加载器与游戏版本要与本模组一致，两者不匹配同样会报错。
如果在这两个平台上出现崩溃，多数情况是构建产物与加载器不对应，或前置模组版本不符，先排查这两项即可。请尽量使用官方发布的最新版本，避免使用第三方修改或重新打包的构建产物。
Q6：如何排查问题来自前置模组《云北城建》还是《云北城建：豹猫指示牌》？
排查步骤：
- 禁用 云北城建：豹猫指示牌 ，查看问题是否还会出现。
- 同时禁用 云北城建：豹猫指示牌 及其前置《云北城建》，查看问题是否还会出现。
注意：若确认问题由前置模组《云北城建》导致，请前往 云北城建 的反馈渠道提交问题；如果确认是 云北城建：豹猫指示牌 的问题，请前往本项目仓库的 Issues 页面提交。两者都请附上游戏日志、模组版本、游戏版本以及复现步骤，方便开发者排查处理。