Skip to content

Bus#

Bus drafts have the type of bus.

Default flags are "flag bus". By default, busses are not drivable nor chargeable.

Attributes#

active#

Type: boolean

Whether the draft is active and should be loaded by the game.

alias#

Type: string

aliases#

Type: string array

Same as alias, but for multiple IDs.

allocate flag#

Type: string or string array

Allocates a custom car flag.

Note that there is a max limit of 32 custom flags.

animation#

Type: CarAnimation array

author#

Type: string

The name of the author behind the draft.

auto align#

Type: boolean

Only used with v2

auto colorize#

Type: boolean

capacity#

Type: integer

category#

Type: string

ID of the category the draft should be contained in.

category from#

Type: string

Draft ID to grab category from and use for the draft.

chargeable#

Type: boolean

colors#

Type: Color array

dev#

Type: boolean

driveable#

Type: boolean

final#

Type: boolean

If set to true, the draft can no longer be overriden.

flag *#

Type: Attribute collection of Car flags

frames#

Type: Frame array

frames per variant#

Type: integer

frames winter#

Type: Frame array

hidden#

Type: boolean

Whether the draft shows up in the toolbar.

hide id#

Type: boolean

Whether to hide the draft ID even when the debug mode is enabled. This will automatically be set to true if final is set to true or if your draft is part of an encrypted plugin file.

icon frames#

Type: Frame array

icon frames winter#

Type: Frame array

id *#

Type: string

Unique identifier of the draft.

index#

Type: boolean

Whether to allow the draft to be indexed by Lua methods.

inherit#

Type: boolean

Whether to modify a draft of the same ID by inheriting values.

length#

Type: float

max version#

Type: integer

The maximum game version that will run the draft.

meta#

Type: Meta

min version#

Type: integer

The minimum game version required to run the draft.

mute#

Type: boolean

Whether to suppress any errors that have occurred while loading the draft.

mute lua#

Type: boolean

normalize animation pos#

not implemented#

Type: boolean

Whether the draft has to be inherited to be considered implemented. Will cause an error otherwise.

once#

Type: boolean

Whether the draft should be loaded once.

What this means is that if another draft is encountered with the same ID, game will ignore loading it rather than failing with an error message.

ordinal#

Type: integer

Position of the draft in a category. Lower ordinal value will list the draft higher. Negative values are allowed.

ordinal from#

Type: string

ID of the draft to grab ordinal from. Must be used in combination with the ordinal attribute.

overlay colors#

Type: Color array

overlay frames#

Type: Frame array

overlay frames winter#

Type: Frame array

override#

Type: boolean

Whether to modify a draft of the same ID by replacing values.

Rather than replacing the values, you may want to add or only change specific values of the draft. For that refer to the inherit attribute.

premium#

Type: boolean

Whether the draft is premium. A draft that is considered premium will not be active in non premium versions of the game.

premium requirement#

Type: Nested requirement

Only loaded on premium versions.

premium requirements#

Type: Requirement array

Only loaded on premium versions.

preview frames#

Type: Frame array

Frames that will be used for preview in the toolbar instead of regular frames.

preview frames winter#

Type: Frame array

Frames that will be used for preview in the toolbar instead of regular frames during winter.

privileged#

Type: string

Privileged key for your draft. Allows to use special features, which are restricted to trusted plugin creators only.

Deprecated

Due to a change in how the privilege system works, you are now recommended to use require privileges or require super privileges.

require privileges#

Type: boolean

Whether the draft requires features such as monthly income, frame placement, etc.

Added in version 1.11.73

require super privileges#

Type: boolean

Whether the draft requires features that are restricted to DSA.

Added in version 1.11.73

requirement#

Type: Nested requirement

requirements#

Type: Requirement array

script#

Type: string

Used to attach a script to the current draft.

Supported modes of operation#

  • Loading the script from file: 

    {
    "script": "script.lua"
}

  • Declaring the script inline: 

    {
    "script": "function script:lateInit() Debug.toast('Late init called') end"
}

  • Using a helper script #LuaWrapper for Real time script editing: 

    {
    "script": "#LuaWrapper",
    "meta": {
      "luawrapper": {
        "script": "script.lua",
        "dev": true
      }
    }
}

scripts#

Type: string array

Like script, but for multiple scripts.

searchable#

Type: boolean

Whether the draft can be searched in the toolbar.

separator#

Type: boolean

Whether to separate draft from others in a category.

show new marker#

Type: boolean

Whether the draft will show a new marker in the toolbar.

sound click#

Type: obj

This sound will be played when clicked on the draft in default mode.

Example#

{
    "sound click": {
        "file": "path to file.mp3",
        // alternatively there's "res" string attr to refer to a game resource
    }
}

speed#

Type: float

A multiplier for the car speed (similar to the speed attribute of roads).

strict lua#

Type: boolean

tail#

Type: string array

template#

Type: string

ID of the template draft to inherit the implementation from.

You can also reference other templates.

template parameters#

template prefix#

Type: string

Has effect only when using templates.

Example#

Say you have some template drafts with IDs $ja_building_template00, $ja_residential_template00.

Instead of specifying them fully like so 

{
  "templates": [
    "$ja_building_template00",
    "$ja_residential_template00"
  ]
}

You can instead use the attribute like so: 

{
    "template prefix": "$ja_",
    "templates": [
        "building_template00",
        "residential_template00"
    ]
}

templates#

Type: string array

Like template, but accepts multiple IDs.

text#

Type: string

Description, usually of the building.

text id#

Type: string

title#

Type: string

Title, usually of the building.

title id#

Type: string

type *#

Type: string

A special attribute that determines what kind of attributes and abilities a draft has.

v2#

Type: boolean or integer array

When used as an array, it allows you to shift/move cars by adjusting its height.

By changing the value you can change the height of the specific frame. The numbers indicate the frames in this order:

By writing the following you will adjust the 1st and 3rd frame by +1. 

"v2":[1,0,1,0]

Meta tags#

  • fire brigade
  • medic
  • police
  • swat