View source for Adding the TRS19 F7 Cabin to your Asset

The new TRS19 EMD F7 cabin has the ability to change the color of the nose to match the road name of your locomotive asset. Changing the color of the nose is as simple as adding a few lines into the config of your locomotive of choice. 

[[File:F7IntroPage.png|800px]]

== Adding the Cab to your Asset ==

To begin, open the config of the locomotive you wish to have a custom nose color for. For this tutorial, we will be using <kuid2:999999:2222:1> 1 Hot Rod Special F7 from the DLS. It is recommended to open the config in a superior notepad program such as Notepad++ to preserve formatting. When the config for the Hot Rod F7 is opened, it looks something like this:

    kuid                                    <kuid2:999999:2222:1>
    username                                "1 Hot Rod Special F7"
    kind                                    "traincar"
    trainz-build                            3.5
    engine                                  1
    enginespec                              <kuid:999999:42004250>
    enginesound                             <kuid:-1:42003000>
    hornsound                               <kuid:37581:1234>
    interior                                <kuid:217537:220>
    mesh-table
    {
      default
      {
        mesh                                "f7_hotrod_body/f7_hotrod_body.im"
        auto-create                         1
      }
  
      shadow
      {
        mesh                                "f7_hotrod_shadow/f7_hotrod_shadow.im"
      }
    }
    bogeys
    {
      0
      {
        bogey                               <kuid:999999:100100>
        reversed                            0
      }
    }
    mass                                    100000
    company                                 "Auran Brew Crew"
    fonts                                   0
    smoke_shade                             0.5
    smoke_random                            2.6
    smoke_slowlife                          5
    smoke_fastlife                          4
    smoke_height                            2.3
    smoke_fastspeed                         100
    category-class                          "AC"
    category-era                            "2000s"
    category-region                         "AU"
    description                             ""
    author                                  "Brew Crew Productions"
    organisation                            "Auran Games Pty. Ltd."
    contact-website                         "www.virtualtrainz.com"
    contact-email                           "helpdesk@auran.com"
    thumbnails
    {
      0
      {
        image                               "$screenshot$.jpg"
        width                               240
        height                              180
      }
      1
      {
        image                               "f7_hotrod_art\f7_hotrod_art_icon.texture"
        width                               128
        height                              64
      }
    }
    kuid-table
    {
      0                                     <kuid:-1:101212>
      1                                     <kuid:-1:42003000>
      2                                     <kuid:-1:42003101>
      3                                     <kuid:999999:100100>
      4                                     <kuid:999999:42004250>
    }

The first thing to change is the interior kuid to reference the proper F7 cab. If your locomotive is right-hand drive and uses MPH, use the following kuid:
    <kuid:-25:1308>

Change the following line from: 
    interior                                <kuid:217537:220>
to:
    interior                                <kuid:-25:1308>

The next step is to add an extensions table. Copy and paste the following code into your config:

    extensions
    {
      f7cab_parameters
      {
        nosecolor                           "XXX"
      }
    }

The placement of this code does not matter. I placed it directly under the interior tag line and above the mesh table to make editing the extensions easier to edit in the future. 


    kuid                                    <kuid2:999999:2222:1>
    username                                "1 Hot Rod Special F7"
    kind                                    "traincar"
    trainz-build                            3.5
    engine                                  1
    enginespec                              <kuid:999999:42004250>
    enginesound                             <kuid:-1:42003000>
    hornsound                               <kuid:37581:1234>
    interior                                <kuid:217537:220>
    extensions
    {
      f7cab_parameters
      {
        nosecolor                           "XXX"
      }
    }
    mesh-table
    {
      default
      {
        mesh                                "f7_hotrod_body/f7_hotrod_body.im"
        auto-create                         1
      }
  
      shadow
      {
        mesh                                "f7_hotrod_shadow/f7_hotrod_shadow.im"
      }
    }
    
    ....


== Modifying the Nose color ==

The final step is to change "XXX" to an appropriate string. Use the first column in the following table to determine the proper string to replace "XXX" with. The strings are case sensitive, so make sure it matches the table or else the cabin will default to black.

By default, the F7 Cab supports these pre-built liveries:
{| class="wikitable"
|+Supported Road names
|-
|String '''(case sensitive!)'''
|Color
|Roadname
|-
|red
|Red
|Generic Red
|-
|superchief
|Red with Yellow Stripe
|ATSF Warbonnet
|-
|darkblue
|Dark Blue with Yellow Stripe
|ATSF Blue Warbonnet
|-
|green
|Green
|Burlington Northern
|-
|orange
|Orange/Green
|Great Northern
|-
|yellow
|Yellow
|North Western/Alaska
|-
|lightgrey
|Light Grey
|Canadian Pacific
|-
|blackred
|Red with black nose top
|Canadian National / CP Rail
|-
|winetrain
|Green/Gold
|Nappa Valley Wine Train
|-
|silver
|Silver/Black
|Southern Pacific
|-
|unionpacific
|Yellow with Green nose top
|Union Pacific
|-
|darkgrey
|Dark Grey with Dark Blue nose top
|Baltimore and Ohio
|-
|amtrakphase1
|Black/Red/White
|Amtrak Phase I
|-
|hotrod
|Black with Flames
|Hot Rod Special
|-
|prr_red_5stripe
|PRR Tuscan with 5 Stripe
|Pennsylvania Railroad
|-
|prr_red_1stripe
|PRR Tuscan with 1 Stripe
|Pennsylvania Railroad
|-
|prr_green_5stripe
|PRR Brunswick with 5 Stripe
|Pennsylvania Railroad
|-
|prr_green_1stripe
|PRR Brunswick with 1 Stripe
|Pennsylvania Railroad
|}

The final config would look something like this:


    kuid                                    <kuid2:999999:2222:1>
    username                                "1 Hot Rod Special F7"
    kind                                    "traincar"
    trainz-build                            3.5
    engine                                  1
    enginespec                              <kuid:999999:42004250>
    enginesound                             <kuid:-1:42003000>
    hornsound                               <kuid:37581:1234>
    interior                                <kuid:217537:220>
    extensions
    {
      f7cab_parameters
      {
        nosecolor                           "hotrod"
      }
    }
    mesh-table
    {
      default
      {
        mesh                                "f7_hotrod_body/f7_hotrod_body.im"
        auto-create                         1
      }
  
      shadow
      {
        mesh                                "f7_hotrod_shadow/f7_hotrod_shadow.im"
      }
    }
    bogeys
    {
      0
      {
        bogey                               <kuid:999999:100100>
        reversed                            0
      }
    }
    mass                                    100000
    company                                 "Auran Brew Crew"
    fonts                                   0
    smoke_shade                             0.5
    smoke_random                            2.6
    smoke_slowlife                          5
    smoke_fastlife                          4
    smoke_height                            2.3
    smoke_fastspeed                         100
    category-class                          "AC"
    category-era                            "2000s"
    category-region                         "AU"
    description                             ""
    author                                  "Brew Crew Productions"
    organisation                            "Auran Games Pty. Ltd."
    contact-website                         "www.virtualtrainz.com"
    contact-email                           "helpdesk@auran.com"
    thumbnails
    {
      0
      {
        image                               "$screenshot$.jpg"
        width                               240
        height                              180
      }
      1
      {
        image                               "f7_hotrod_art\f7_hotrod_art_icon.texture"
        width                               128
        height                              64
      }
    }
    kuid-table
    {
      0                                     <kuid:-1:101212>
      1                                     <kuid:-1:42003000>
      2                                     <kuid:-1:42003101>
      3                                     <kuid:999999:100100>
      4                                     <kuid:999999:42004250>
    }

==Return to Index==
 
[[HowToGuides|<< How To Guides]]

[[Category:How-to guides]]