Create Track Map

Мод Create Track Map (CTM) представляет собой кроссплатформенное решение, которое создает интерактивную веб-карту железнодорожной системы из мода Create в вашем мире Minecraft. На карте отображаются все пути, сигналы, станции и поезда с практически мгновенным обновлением состояния сигналов и движения составов.

Как использовать

Для работы мода требуется открытие дополнительного порта (по умолчанию 3876), на котором запускается веб-сервер. Карта доступна по корневому адресу (обычно http://localhost:3876/).

Установка

Просто поместите файл .jar в папку mods, как и любой другой мод. CTM предназначен для работы на стороне сервера, но также функционирует в одиночных мирах и локальных сетях.

Одиночная игра: Карта размещается на вашем компьютере. Откройте http://localhost:3876/ в браузере, пока Minecraft запущен.

Многопользовательская игра:

• Локальный сервер: Используйте http://localhost:3876/ или http://[ваш IPv4-адрес]:3876/ для других пользователей в вашей сети
• Сервер на вашем ПК: Аналогично локальному серверу, внешние пользователи могут получить доступ через ваш публичный IP-адрес
• Хостинг-провайдер: Карта размещается вместе с сервером, доступ по адресу [адрес сервера]:3876/

Расширенные возможности

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 обновляются в реальном времени через Server-Sent Events.

Настройка

Конфигурация находится в файле create-track-map.json в директории config сервера. Доступные опции:

{
  // Включение/выключение мода
  "enable": false,

  // Интервал обновления данных о путях
  "watch_interval_seconds": 0.5,
  // Порт веб-сервера
  "server_port": 3876,

  "map_style": {
    // Шрифт для интерфейса карты
    "font": "ui-monospace, \"JetBrains Mono\", monospace",
    // Цвета элементов карты
    "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 },

    // Уровни масштабирования
    "initial_zoom": 3,
    "min_zoom": 0,
    "max_zoom": 4,

    // Элементы управления масштабом
    "zoom_controls": true,

    // Сторона отображения сигналов
    "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 (требуются права оператора).