远端地址配置（remote.baseUrl）

基本信息

属性 值
配置分类 remote
配置键 baseUrl
完整键名 remote.baseUrl
默认值 http://127.0.0.1:8123

本 mod 只有这 1 个配置项（Config.synchronizeConfiguration，:15-27）。

作用

指定 GTNH-Web-Map 地图服务器的基址，本 mod 向其发起两类 HTTP GET 请求 （见 远端 HTTP 协议）：

  • {baseUrl}/up/configuration —— 地图目录 JSON
  • {baseUrl}/tiles/... —— PNG 瓦片

生效方式

⚠️ 见 命令条目 的同步缺陷：该配置项与静态字段 RemoteConfiguration.baseUrl 不是同一个存储。 修改本配置后必须用 /gwmc <url> 触发，否则不会改变实际请求地址。

源码核对（2026-10-01 审计）

  • 定义：Config.java:19-20 configuration.get("remote", "baseUrl", "http://127.0.0.1:8123")。 默认值硬编码在此处，与 RemoteConfiguration.baseUrl（:17）的 默认值是两处独立字面量，源码中无共用常量。
  • synchronizeConfiguration 有 if (configuration == null) 与 if (remoteUrlProperty == null) 双重懒初始化（:17, :19）， 即多次调用不会覆盖已加载的值——FML 重复触发 preInit 时配置不刷新。
  • 读取配置的 getString() 之后没有类型/空值校验； 玩家在配置里写空串会得到 baseUrl = ""， 请求将退化为 "/up/configuration" 相对路径并抛 MalformedURLException （被包成 RuntimeException）。