殖民镇：ColonyWeb
用于管理你的Minecolonies殖民地（colony）的实时网页仪表板（Web dashboard）。
查看大图
ColonyWeb
一个仅限服务端的 Minecraft 模组，适用于 1.20.1 (Forge) 和 1.21.1 (NeoForge)，为 MineColonies 殖民地添加实时网页仪表盘。可在任意浏览器中打开，查看建筑进度、资源需求、居民、研究、防御统计和仓库库存——所有数据均通过服务器发送事件（SSE）实时更新。
玩家使用 /colonyweb sync 生成的配对码登录，并且只能看到自己所属的殖民地。该模组无需安装在客户端。
如需支持，请勿联系官方 MineColonies 支持团队。请使用 问题反馈选项 报告问题。
功能特性
八个标签页，全部实时更新——殖民地数据通过 SSE 流式传输，无需手动刷新。
概览
殖民地全貌一览无余。居民、幸福度、建筑、防御、仓库和研究等统计卡片位于建筑工人列表上方，所有工作订单按活动状态排序——正在进行的项目排在顶部。当前进行中的研究和建筑任务一目了然，让您随时掌握动态。
地图
殖民地的俯视渲染图，每个像素代表一个方块，支持平移和缩放。建筑标记标注了每座建筑，居民圆点会实时移动。可独立开关建筑、居民和标签显示，自动缩放以适应殖民地范围，或直接定位到市政厅。
建筑
殖民地所有建筑以可扫描的卡片网格呈现。可按名称搜索，筛选在建建筑或装饰物，并按状态、名称、进度或等级排序。点击任意卡片即可查看其仍需要的具体资源——精确到物品数量。
需求
所有在建建筑当前所需资源的汇总视图，已进行聚合和去重。无需逐个点击建筑查看，即可一目了然地看到殖民地缺少什么资源——以及具体缺多少。
居民
完整居民名册，支持按职业筛选和文本搜索。点击任一居民可打开详情面板，查看其技能详情、生命值和幸福度条，以及背包和装备栏。可查看谁在忙碌、谁在空闲，以及他们随身携带了什么。
研究
大学的所有研究分支以进度条形式呈现，并带有状态标签——排队中、进行中或已完成——以及每项解锁所需的物品消耗图标。可立即查看当前正在研究什么，以及后面排队等待的研究。
战斗
哨塔驻守情况一目了然——正常、需要补给或空缺——同时显示每个守卫的生命值，以及记录自上次袭击以来夜晚数量的袭击横幅。在下一次袭击到来之前，了解您的防御是否已准备就绪。
仓库
殖民地所有货架和仓库方块中的物品库存汇总，支持搜索，并可按数量或字母顺序排序。无需亲自走到仓库，即可查看您需要确认的库存信息。
依赖项
以下三个均为必需项——请与 ColonyWeb 一同安装。
| 模组 | 备注 |
|---|---|
| KotlinForForge | 提供模组编译所依赖的 Kotlin 运行时。1.20.1 请使用 Forge 版本，1.21.1 请使用 NeoForge 版本。 |
| MineColonies | 仪表盘所渲染的所有殖民地数据的来源。 |
| Domum Ornamentum | 提供 MineColonies 建筑使用的动态纹理装饰方块。仪表盘会显示其图标。 |
安装方法
- 将 ColonyWeb 的 jar 文件及其依赖项放入服务器的
mods/文件夹。 - 启动服务器——配置文件
config/colonyweb-common.toml将自动生成。 - 在任意浏览器中打开
http://your-server-ip:8723。 - 在游戏内运行
/colonyweb sync，并在网页上输入配对码。
配置
文件：config/colonyweb-common.toml
| 选项 | 默认值 | 描述 |
|---|---|---|
httpPort |
8723 |
HTTP 服务器端口 |
bindAddress |
0.0.0.0 |
绑定地址（生产环境可设为 127.0.0.1 并使用反向代理） |
publicHost |
(空白) | /colonyweb 命令打印的链接中使用的主机名。留空则使用服务器检测到的地址 |
refreshIntervalSeconds |
3 |
殖民地数据重新扫描并通过 SSE 推送的频率 |
autoDownloadVanillaAssets |
true |
首次启动时下载匹配的原版客户端 jar，以便显示原版物品/方块图标 |
mapEnabled |
true |
是否显示殖民地地图标签页 |
mapRadius |
256 |
地图覆盖的殖民地中心周围范围（以方块为单位） |
authEnabled |
true |
是否要求配对码认证。关闭后，任何能访问该端口的人都可公开查看仪表盘 |
sessionDays |
30 |
浏览器在输入配对码后保持登录状态的天数 |
loginCodeMinutes |
10 |
/colonyweb sync 生成的配对码保持有效的时长 |
游戏内命令
| 命令 | 权限 | 描述 |
|---|---|---|
/colonyweb |
所有人 | 打印仪表盘链接 |
/colonyweb sync |
所有人 | 为本人生成一次性配对码 |
/colonyweb port |
所有人 | 显示仪表盘监听的端口 |
/colonyweb sync <玩家> |
OP | 为其他玩家生成配对码 |
/colonyweb access grant <玩家> <殖民地> |
OP | 按 ID 授予玩家访问某个殖民地的权限 |
/colonyweb access revoke <玩家> <殖民地> |
OP | 撤销该访问权限 |
/colonyweb access list <玩家> |
OP | 显示玩家可以查看哪些殖民地 |
/colonyweb logout <玩家> |
OP | 使玩家的所有网页会话失效 |
/colonyweb status |
OP | 显示服务、认证和会话统计信息 |
登录方式
- 在游戏内运行
/colonyweb sync。聊天栏会出现一个短代码（例如3B7X-K2L9）。 - 在浏览器中打开服务器的仪表盘 URL。
- 在配对屏幕中输入该代码。代码不区分大小写。
代码为一次性使用，默认在 10 分钟后过期（由 loginCodeMinutes 控制）。输入后，浏览器将保持登录状态 sessionDays 天（默认 30 天）。
故障排除
| 症状 | 可能原因 |
|---|---|
| 页面无法加载 / 连接被拒绝 | 服务器端口无法访问——请检查防火墙和端口转发设置 |
| “没有可显示的殖民地” | 玩家尚未加入任何 MineColonies 殖民地，或配对码是针对其他玩家的 |
| 配对码不被接受 | 代码已过期（loginCodeMinutes，默认 10 分钟）或已被使用——请重新运行 /colonyweb sync |
| 仪表盘可加载但所有标签页均为空 | 服务器上未安装 MineColonies 或模组未加载 |
| 图片 / 纹理缺失 | 首次加载时会下载原版资源——网络较慢时可能需要一分钟 |
请查看服务器日志（latest.log）中带有 [ColonyWeb] 前缀的行。
许可证
GNU 通用公共许可证 v3.0
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表，这里同步展示。