SubwaySim Wiki

This section provides everything you need to build maps for SubwaySim 2 — from creating a new level to preparing it for use in the game.

You will learn how to:

• create and prepare a new level
• migrate assets safely into your own plugin
• build railway infrastructure using the Railtool
• prepare stations, signals, and AI-relevant data
• define map logic and AI services via Map.lua
• visually build out and refine your map using editor tools
• package and test your map in SubwaySim 2

The following chapters guide you step by step through the complete map creation workflow.

• Creating a Level

Learn how to create and prepare a level inside the Modding SDK, including world partition setup, editor lighting, and basic level configuration.

• Migrating Assets into a User Plugin

Understand how to safely migrate assets between plugins without breaking references.

• Railtool

The central tool for building railway infrastructure.

• Creating a Superstructure

Defines the physical and visual properties of tracks used by the Railtool.

• Laying Tracks

Place track splines, curves, switches, and assign required data layers.

• Importing Switches

Optional and only required for complex switch constructions such as double crossovers or special layouts.

• Prepare a Map for SubwaySim

Final preparation steps inside the level, including:

• tracks and layout validation
• signals and speed limits
• station definitions and platforms

  This step ensures the map is technically ready for AI logic and runtime use.

• Create Map.lua

Define the runtime logic of the map:

• map registration
• station and platform data
• AI timetables and services
• dispatching and depot logic

After the technical foundation is in place, you can further build out and refine the map visually using dedicated editor tools.

These tools are optional but strongly recommended for creating believable stations and environments.

• Prop Placing Tool

Place platforms, station elements, props, and environment assets directly in the editor.

Editor tools can be used in parallel with Map.lua development and testing.

• Build a Mod to Pak-File

Package your map into a final `.pak` file and test it inside SubwaySim 2.

Together, these chapters provide a complete overview of the entire map creation pipeline — from the first empty level to a fully functional, playable, and packaged map.