Create: Track Map (UNOFFICIAL FORK)

Create Track Map：非官方分支

分支说明

这是 jenchanws/create-track-map 的一个分支。虽然我已获得许可，可以在单独的 Modrinth/CurseForge 页面上公开发布我的修改，但此分支并未得到 jenchanws 的认可——请不要就本分支的问题联系她，所有关于此版本模组的问题都应提交到这里，而不是原仓库

简介

Create Track Map（CTM）是一个多加载器模组，可在你的世界中显示机械动力列车的轨道地图，包括所有轨道、信号、车站和列车。信号和列车会（几乎）实时更新。

使用方法

CTM 可在 Modrinth 和 CurseForge 上下载。请确保你下载的是适用于你的加载器、Minecraft 版本和机械动力版本的版本。以下是机械动力版本的兼容性图表：

| | CTM 1.5 | CTM 2.0 |
|:—————–|:——-:|:——-:|
| Create 0.5.1 | ✅ | ❌ |
| Create 6.0.0 | ❌ | ✅ |

安装

只需像其他模组一样，将 .jar 文件放入你的 mods 文件夹（或使用模组加载器安装）即可！CTM 旨在作为服务端模组使用，但也可以在单人世界和局域网服务器中运行。它默认在端口 3876 上运行一个 Web 服务器，但这可以配置。如果你想查看地图，必须转发此端口。（我该怎么做？）

地图本身可在根路径查看（默认为 http://localhost:3876/）。如果使用代理来提供地图服务，请确保将其配置为允许服务器发送事件（Server-Sent Events）通过。

单人游戏

地图托管在你的计算机上，因此在 Minecraft 打开时，在浏览器中输入 http://localhost:3876/。

多人游戏

A) 本地（局域网）服务器\
地图仍托管在你的计算机上，因此在游戏打开时，在浏览器中输入 http://localhost:3876/。\
你家里的其他人可以在浏览器中输入 http://[你计算机的 IPV4 地址]:3876/ 来查看地图。\
如何查看我计算机的 IPV4 地址？

B) 服务器运行在我的电脑上\
地图仍托管在你的电脑上，因此只要服务器处于运行状态，就可以在浏览器中输入 http://localhost:3876/ 来查看地图。\
同一住户中的其他人可以在浏览器中输入 http://[your computer's IPV4 address]:3876/ 来查看地图。\
住户以外的人可以在浏览器中输入 http://[your public IPV4 address]:3876/ 来查看地图。\
如何查看我的公网 IPV4 地址？

C) 服务器托管在托管服务商处\
地图与服务器一起托管在该服务商处。只要服务器正在运行，你就可以通过 [your server address]:3876/ 查看地图。\
注意：你的服务商必须支持额外的端口转发。你可以联系服务商的客服、查阅相关文档，或者直接用 Google 搜索。如果服务商不支持此功能，那就没办法了。你可以更换服务商，或者尝试自行托管。

特别说明：IPV4 地址两侧的方括号不要输入！例如：192.168.0.0:3876

寻求帮助前请先阅读！

要使用此模组，除了 Minecraft 服务器端口外，你还必须能够开放第二个端口，供 CTM 运行其 Web 服务器。如果你使用 Aternos，则无法开放此端口。如果你使用共享托管服务商，请联系服务商协助开放端口。对于开放端口或诊断非模组 Bug 导致的问题，我们不提供支持。

进阶用法

CTM API

CTM 提供以下 API，也可通过同一端口访问：

• /api/network、/api/network.rt：所有轨道部件和火车站列表
• /api/signals、/api/signals.rt：所有铁路信号列表，包括其状态（绿色、黄色、红色）
• /api/blocks、/api/blocks.rt：所有信号控制区段列表，以及区段是否被火车占用或预留
• /api/trains、/api/trains.rt：所有已组装火车的列表，包括其名称和位置
• /api/style.css：根据已配置的颜色和字体生成的 CSS 样式表
• /api/config.json：地图配置

.rt 版本通过服务器发送事件（SSE）实时更新。

配置

CTM 的配置选项位于服务器配置目录中的 create-track-map.json 文件。如果该文件不存在，系统会在启动时自动创建。

可用选项如下：

{
  // 是否实际启动监视器和服务器。
  "enable": false,

  // 两次轨道数据更新之间的等待时间。
  "watch_interval_seconds": 0.5,
  // 内部 Web 服务器监听的端口。
  "server_port": 3876,

  "map_style": {
    // 地图 UI 使用的字体。必须是有效的 CSS 字体栈。
    "font": "ui-monospace, \"JetBrains Mono\", monospace",
    // 地图各组成部分的颜色。必须是有效的 CSS 颜色。
    // 任何 CSS 颜色格式都可以使用，例如命名颜色和 rgb()。
    "colors": {
      "background": "#888",
      "track": {
        "occupied": "red",
        "reserved": "pink",
        "free": "white"
      },
      "signal": {
        "green": "#71db51",
        "yellow": "#ffd15c",
        "red": "#ff5f5c",
        "outline": "black"
      },
      "portal": {
        "primary": "purple",
        "outline": "white"
      },
      "station": {
        "primary": "white",
        "outline": "black"
      },
      "train": "cyan",
      "lead_car": "darkturquoise"
    }
  },

  "map_view": {
    "initial_dimension": "minecraft:overworld",
    "initial_position": { "x": 0, "z": 0 },

    // 缩放级别必须是整数，但可以为负数。
    // 每个缩放级别是前一个的两倍大。
    // 0 是一个不错的最小值，但对于大型网络可能不实用。
    // 3 是查看双线网络的合理默认值。
    "initial_zoom": 3,
    "min_zoom": 0,
    "max_zoom": 4,

    // 屏幕上是否应显示缩放控件。
    "zoom_controls": true,

    // 信号应显示在轨道的哪一侧。
    // 有效值为 LEFT 或 RIGHT（全大写）。
    "signals_on": "RIGHT"
  },

  "dimensions": {
    // 维度名称必须带命名空间。
    "minecraft:overworld": {
      // 在图层切换器中显示的标签。
      "label": "Overworld"
    },
    "minecraft:the_nether": {
      "label": "Nether"
    },
    "minecraft:the_end": {
      "label": "End"
    }
  },

  "layers": {
    "tracks": {
      "label": "Tracks",
      "min_zoom": 0,
      "max_zoom": 4
    },
    "blocks": {
      "label": "Track Occupancy",
      "min_zoom": 0,
      "max_zoom": 4
    },
    "signals": {
      "label": "Signals",
      "min_zoom": 0,
      "max_zoom": 4
    },
    "portals": {
      "label": "Portals",
      "min_zoom": 0,
      "max_zoom": 4
    },
    "stations": {
      "label": "Stations",
      "min_zoom": 0,
      "max_zoom": 4
    },
    "trains": {
      "label": "Trains",
      "min_zoom": 0,
      "max_zoom": 4
    }
  }
}

通过运行 /ctm reload（需要管理员权限）可以在不重启服务器的情况下重新加载配置。