SubwaySim Wiki

User Tools

Site Tools

Trace:
manual:subwaysim:vehicle_development:simple_vehicle_blueprint

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
manual:subwaysim:vehicle_development:simple_vehicle_blueprint [2025/12/19 10:09] – [Assigning the Bogie Scene Components] dcsmanual:subwaysim:vehicle_development:simple_vehicle_blueprint [2026/01/07 09:36] (current) – dcs
Line 1: Line 1:
 ====== Creating a Simple Vehicle Blueprint ====== ====== Creating a Simple Vehicle Blueprint ======
 +
 +===== Overview =====
  
 In this chapter, we will create a **Simple Vehicle Blueprint**. In this chapter, we will create a **Simple Vehicle Blueprint**.
Line 14: Line 16:
  
 ---- ----
- 
 ===== Creating the Vehicle Blueprint ===== ===== Creating the Vehicle Blueprint =====
 +
 +==== Creating the Blueprint Asset ====
  
 As a first step, we create an empty Vehicle Blueprint. As a first step, we create an empty Vehicle Blueprint.
Line 41: Line 44:
  
 ---- ----
 +===== Vehicle Blueprint Setup =====
  
-===== Opening the Vehicle Blueprint =====+==== Opening the Vehicle Blueprint ====
  
 Open the newly created Vehicle Blueprint. Open the newly created Vehicle Blueprint.
Line 49: Line 53:
 This is expected and serves as the foundation for assembling the vehicle. This is expected and serves as the foundation for assembling the vehicle.
  
----- +==== Setting the Lua Class Name ====
- +
-===== Setting the Lua Class Name =====+
  
 Before adding any components, we must define which Lua class this vehicle belongs to. Before adding any components, we must define which Lua class this vehicle belongs to.
  
-In the **Details** panel of the Vehicle Blueprint, locate the field: **Lua Class Name**+In the **Details** panel of the Vehicle Blueprint, locate the field **Lua Class Name** and set it to:
  
-Set this value to:`RailVehicle`+`RailVehicle`
  
 {{:manual:subwaysim:simple_vehicle_blueprint:vehiclebp_3.png?direct&300|}} {{:manual:subwaysim:simple_vehicle_blueprint:vehiclebp_3.png?direct&300|}}
Line 64: Line 66:
  
 ---- ----
- 
 ===== Adding Required Components ===== ===== Adding Required Components =====
  
-To ensure the vehicle can be placed correctly on the tracks and function properly in SubwaySim 2 (including AI usage), several components must be added. +==== Skeletal Mesh Component ====
- +
----- +
- +
-===== Skeletal Mesh Component =====+
  
 Add a Skeletal Mesh component: Add a Skeletal Mesh component:
Line 80: Line 77:
  
 Example: Example:
-  * **Exterior** (for the exterior vehicle mesh)+  * **Exterior** – exterior vehicle mesh
  
 In the **Details** panel: In the **Details** panel:
   * Assign the Skeletal Mesh that was imported earlier   * Assign the Skeletal Mesh that was imported earlier
  
----- +==== Assigning the Animation Blueprint ====
- +
-===== Assigning the Animation Blueprint =====+
  
 To enable animations (including the Control Rig), the Animation Blueprint must be assigned manually. To enable animations (including the Control Rig), the Animation Blueprint must be assigned manually.
  
 In the **Details** panel of the Skeletal Mesh component: In the **Details** panel of the Skeletal Mesh component:
-  * Locate the field **Anim Class**+  * Locate **Anim Class**
   * Select the **Animation Blueprint (ABP_)** created earlier   * Select the **Animation Blueprint (ABP_)** created earlier
  
-Use the Animation Blueprint defined in the chapter: [[manual:subwaysim:vehicle_development:simple_animation_blueprints|Creating a Simple Animation Blueprint]] +Use the Animation Blueprint defined in the chapter: 
- +[[manual:subwaysim:vehicle_development:simple_animation_blueprints|Creating a Simple Animation Blueprint]]
-This Animation Blueprint internally references the Control Rig and is required for bogie and axle animation to function correctly.+
  
 {{:manual:subwaysim:simple_vehicle_blueprint:vehiclebp_5.png?direct&1000|}} {{:manual:subwaysim:simple_vehicle_blueprint:vehiclebp_5.png?direct&1000|}}
  
----- +==== Collision Settings ====
- +
-===== Collision Settings =====+
  
 To ensure that the vehicle uses the collision data defined in the Physics Asset, the collision preset must be set correctly. To ensure that the vehicle uses the collision data defined in the Physics Asset, the collision preset must be set correctly.
Line 110: Line 102:
   * Locate the **Collision** section   * Locate the **Collision** section
   * Set **Collision Preset** to **Vehicle**   * Set **Collision Preset** to **Vehicle**
- 
-This step is mandatory. 
  
 {{:manual:subwaysim:simple_vehicle_blueprint:vehiclebp_6.png?direct&400|}} {{:manual:subwaysim:simple_vehicle_blueprint:vehiclebp_6.png?direct&400|}}
  
 Without this setting: Without this setting:
-  * The Physics Asset collisions will not be applied correctly+  * Physics Asset collisions will not be applied correctly
   * The vehicle may not collide properly with the environment   * The vehicle may not collide properly with the environment
   * Interaction and physics behavior can break in-game   * Interaction and physics behavior can break in-game
- 
  
 ---- ----
 +===== Bogie and Coupling Setup =====
  
-===== Scene Components for Bogies and Couplings =====+==== Scene Components for Bogies and Couplings ====
  
-Next, we need to add **Scene Components**, which act as reference points for the simulation. +Add four **Scene Components**: 
- +  * **Bogie1** – first bogie 
-Add four Scene Components: +  * **Bogie2** – second bogie 
-  * Click **Add** +  * **Coupling_F** – front coupling 
-  * Search for **Scene** (Utility → Scene Component) +  * **Coupling_B** – rear coupling
- +
-The naming of these components is **extremely important** and must follow this exact structure: +
- +
-  * **Bogie1** – First bogie +
-  * **Bogie2** – Second bogie +
-  * **Coupling_F** – Front coupling +
-  * **Coupling_B** – Rear coupling+
  
 {{:manual:subwaysim:simple_vehicle_blueprint:vehiclebp_4.png?direct&200|}} {{:manual:subwaysim:simple_vehicle_blueprint:vehiclebp_4.png?direct&200|}}
  
-These names are required so SubwaySim 2 can correctly identify each reference point.+The naming of these components is **mandatory** and must follow this exact structure.
  
-----+==== Positioning the Scene Components ====
  
-===== Positioning the Scene Components ===== +Correct positioning is critical:
- +
-Correct positioning of these Scene Components is critical.+
  
   * **Bogie1 / Bogie2**   * **Bogie1 / Bogie2**
-    * The origin must be exactly at the center of the respective bogie+    * Origin at the exact center of the bogie
     * Z-position must be **0**     * Z-position must be **0**
-  +
   * **Coupling_F / Coupling_B**   * **Coupling_F / Coupling_B**
-    * The origin must be placed at the rotation or mounting point of the Scharfenberg coupling+    * Origin at the rotation or mounting point of the Scharfenberg coupling
  
-SubwaySim 2 uses these reference points to: +These reference points are used by SubwaySim 2 to: 
-  * Determine how the vehicle is placed on the tracks +  * Place the vehicle on the tracks 
-  * Calculate correct vehicle alignment+  * Calculate correct alignment
   * Connect vehicles into train formations   * Connect vehicles into train formations
  
Line 163: Line 144:
  
 ---- ----
 +===== Bogie Initialization =====
  
-===== Initializing Bogie Data =====+==== Initializing Bogie Data ====
  
-After adding all required components, we must initialize the bogie data so SubwaySim 2 knows where the bogies are located and how they should behave during simulation.+After adding all required components, the bogie data must be initialized.
  
-This setup is done inside the **Event Graph** of the Vehicle Blueprint.+This setup is done in the **Event Graph** of the Vehicle Blueprint.
  
-----+==== Adding the Required Nodes ====
  
-4 +Open the **Event Graph**.
-===== Adding the Required Nodes =====+
  
-Open the **Event Graph** of your Vehicle Blueprint. +Add the initialization event: 
- +  * Right-click → **Event Initialize Bogies**
-First, create the initialization event: +
-  * Right-click in the graph +
-  * Search for **Event Initialize Bogies** +
-  * Add the node+
  
 {{:manual:subwaysim:simple_vehicle_blueprint:bp_bogie1.png?direct&300|}} {{:manual:subwaysim:simple_vehicle_blueprint:bp_bogie1.png?direct&300|}}
  
-This event is called automatically and is used to register all bogies of the vehicle.+Add two bogie nodes: 
 +  * Right-click → **Add Bogie** 
 +  * Repeat until you have **two Add Bogie nodes**
  
-Next, add the bogie nodes: +==== Preparing the Bogie Data ====
-  * Right-click in the graph +
-  * Search for **Add Bogie** +
-  * Add the node+
  
-Repeat this step so that you have **two Add Bogie nodes** — one for each bogie. +For each **Add Bogie** node: 
- +  * Right-click the **Bogie Data** pin
----- +
- +
-===== Preparing the Bogie Data ===== +
- +
-On each **Add Bogie** node: +
-  * Locate the **Bogie Data** pin +
-  * Right-click on the pin+
   * Select **Split Struct Pin**   * Select **Split Struct Pin**
  
 {{:manual:subwaysim:simple_vehicle_blueprint:bp_bogie3.png?direct&200|}} {{:manual:subwaysim:simple_vehicle_blueprint:bp_bogie3.png?direct&200|}}
  
-This exposes the internal data fields of the Bogie Data structure.+==== Assigning the Bogie Scene Components ====
  
----- +Assign the Scene Components to the bogies:
- +
-===== Assigning the Bogie Scene Components ===== +
- +
-Now we assign the previously created Scene Components to the bogies. +
- +
-For each **Add Bogie** node: +
-  * Locate the **Bogie Socket** pin +
-  * Drag a connection from the pin +
-  * Search for **Get** +
-  * Select the Scene Component corresponding to the bogie +
- +
-{{:manual:subwaysim:simple_vehicle_blueprint:bp_bogie2.png?direct&300|}}+
  
-Assign them as follows: 
   * First **Add Bogie** → **Bogie1**   * First **Add Bogie** → **Bogie1**
   * Second **Add Bogie** → **Bogie2**   * Second **Add Bogie** → **Bogie2**
  
-This ensures that SubwaySim 2 knows the exact position of each bogie on the vehicle.+{{:manual:subwaysim:simple_vehicle_blueprint:bp_bogie2.png?direct&300|}}
  
-Once both **Add Bogie** nodes are connected correctly, the bogie initialization is complete. +This ensures SubwaySim 2 knows the exact position of each bogie.
- +
----- +
- +
- +
-===== Linking the Scene Components ===== +
- +
-Each **Add Bogie** node must be linked to the corresponding Scene Component created earlier: +
- +
-  * First **Add Bogie** → assign **Bogie1** +
-  * Second **Add Bogie** → assign **Bogie2**+
  
 {{:manual:subwaysim:simple_vehicle_blueprint:vehiclebp_7.png?direct&1000|}} {{:manual:subwaysim:simple_vehicle_blueprint:vehiclebp_7.png?direct&1000|}}
- 
-Make sure you select the correct Scene Components, otherwise the bogie positions will be wrong and the vehicle will not be placed correctly on the track. 
- 
-Once both bogies are added and linked, the bogie initialization is complete. 
- 
-(Continuation follows: further setup of couplings, AI placement, and additional vehicle configuration.) 
  
 ---- ----
- 
- 
 ===== Completion of the Simple Vehicle Blueprint ===== ===== Completion of the Simple Vehicle Blueprint =====
  
-With the bogie data initialized, the setup of the **Simple Vehicle Blueprint** is complete.+With the bogie data initialized, the **Simple Vehicle Blueprint** setup is complete.
  
-This blueprint structure is intentionally kept minimal and is suitable for:+This blueprint is suitable for:
   * Simple AI-controlled vehicles   * Simple AI-controlled vehicles
   * Static or basic rolling stock   * Static or basic rolling stock
-  * Vehicles without interactive systems or advanced functionality +  * Vehicles without interactive systems
- +
-It provides only the essential components required for correct placement on the tracks and basic movement within SubwaySim 2.+
  
 ---- ----
- 
 ===== Important Note ===== ===== Important Note =====
  
-This setup **does not** include:+This setup **does not include**:
   * Player interaction   * Player interaction
   * Advanced vehicle systems   * Advanced vehicle systems
-  * Door, coupling, or cab interaction logic +  * Door, coupling, or cab logic 
-  * Additional animation or gameplay features +  * Extended animation or gameplay features
- +
-At this point, the basic structure of the Vehicle Blueprint is complete. +
-or vehicles that require more advanced functionality, please continue with the dedicated chapter: [[manual:subwaysim:vehicle_development:complex_vehicle_blueprint|Creating a Complex Vehicle Blueprint]]+
  
-That chapter builds upon the foundation created here and explains how to extend the Vehicle Blueprint with advanced systems and features.+For vehicles requiring more advanced functionality, continue with: 
 +[[manual:subwaysim:vehicle_development:complex_vehicle_blueprint|Creating a Complex Vehicle Blueprint]]
  
 {{page>manual:footer}} {{page>manual:footer}}
  
manual/subwaysim/vehicle_development/simple_vehicle_blueprint.1766135364.txt.gz · Last modified: by dcs
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki