All CD:RE files and mods are stored inside .cpk files. These files are just .zip archives and contain all of the game’s content. If you go to the ...\Crashday\data folder you will find all of the game’s .cpk content packages. Please note that you are not allowed to edit default game files and the game will crash if you try to edit them. For editing content you need to create a custom mod.
For easier distribution CD’s content is divided into several packages, each containing some type of files.
data000.cpk - Common files
data001.cpk - Music
data002.cpk - Ambience related files
data003.cpk - Car related files
data004.cpk - Vegetation related files
data005.cpk - Dynamics related files
data006.cpk - Tile related files
data007_.cpk - Translation files (depends on which language is selected in steam)
a - English
b - German
c - Italian
d - Russian
e - Turkish
f - Hungarian
g - Brazilian
h - Spanish
i - Polish
If you are planning to mod the game, you would generally unpack all useful packages in the same folder(you probably do not need the Music one). This would give you all of Crashday’s unpacked content which can be edited(but not loaded) and used as reference.
Crashday has a lot of different files used for different things. Generally there are two types: text and binary ones. Binary files can only be edited using special programs, plugins or the game itself. Text files can be opened with any text editor, though using notepad is not recommended.
All the text files are based on the same format:
Every line is important. The game will look for a certain variable on a certain line position, so don’t add any additional lines etc.
After every line you can add a comment using # symbol. Everything after it on the same line will be ignored by the game.
CD uses a dot to represent decimal numbers e.g. 1.23
Colors are represented as RGB, channels are separated with a space e.g. 255 255 255 is white color.
Text based files
.amb Ambience definition
path: content/ambience/
Ambience files are used by the game to change weather. In general it is a way to change how light, reflections and sounds work in the level. Here is a cleaned up version of CD’s day.amb
PropsFX-Ambience-File # defines a start of an .amb file - # name of ambience (overwritten by localized data for default ambiences) ambience/day # texture set for the ambience (lut, background, skybox, sun). First part is the folder name inside textures folder, second is the start of the file name the game will look for(day_bg, day_lut etc.) 219 186 149 # sun color 1 # maximum sunlight strength 2 # power exponent of sun light 97 111 131 # ambience sky color 45 49 54 # ambience ground color 0 0 0 # absolute ambience minimum 255 217 175 # specular reflection color 170 170 170 # darker dense vegetation render color (e.g. treetops) 190 190 190 # brighter vegetation render color (e.g. grass) 0 -0.6 -0.8 # sun light vector 90 # additional rotation of sun vector 1.0 1.0 1.0 1.0 # screen gamma 1 # apply gamma to sky? 55 55 55 # texture color filter 0.0 # strength of color filter 0.1 # strength of color filter on car (defines how much the car's color is "greyed out", to not oversaturate) use_colormap 3 # number of ramp points 0->0 127->128 255->255 # ramp point 1 0->0 127->128 255->255 0->0 127->128 255->255 69 78 91 # fog color for looking into normal scenery 0 0.5 # fog amount (min,max) looking into normal scenery 93 103 115 # fog color for looking into sun haze 0 0.5 # fog amount (min,max) looking into sun haze ambience/day.wav # environment sound in sounds folder 0 0.2 0.8 # sunflare vector 255 228 173 # sunflare color 300 300 # sun corona width/height 5 5 5 # object shadow color 0.4 # max shadow alpha density 1.0 1.0 1.0 # reflections: min/max/fresnel scaling coefficients 0 # turn on headlights for cars 255 255 255 # color tint for the lensflares/coronas in this ambience. 255,255,255 means no tint. 0,0,0 makes flares invisible 70 78 78 # the color for the bottom of the scene background 0 # rotational angle to correct the envmapping directions 0 # [optional] force music off (useful when hacking envsound with a soundtrack)
ladder.lst Career opponent list
path: content/career/ladder.lst
Ladder list defines the names of opponents in career mode. Opponent names in quickplay can be found in translations files.
Crashday-CareerLadder # defines a start of ladder.lst 21 # number of opponents 1 # Randomize opponent names? James|Hamilton amateurs # Name|Surname league George|Rush amateurs Emmett|Brown amateurs Kevin|Hale amateurs Donald|Spikes amateurs Mia|Tsukamoto amateurs Steve|Jarvik amateurs Percy|Kay amateurs Waldo|Silver professionals Isaac|N. professionals John|Williams professionals Jules|Ash professionals Robert|Patch professionals Joe|Eastman professionals Kanzan|Tsukamoto professionals Vincent|Dust final Maurice|Kane final Lance|Cartwright final Ryan|Whitney final Tyreece|Moore final \1THE|INCUBATOR lastmission
.lst Shop list
Shop lists are used to display what can be bought in the shop. There are three main lists:
content/shop/cars/carname/ items will show up for the given car. In these files you want to specify vinyls, car perf upgrades etc.
content/shop/cars/weapons.lstis a list of available weapons in game and will show up for every car under weapons category. Usually you don’t need to edit this, unless you want to change some weapon’s shop stat.
content/shop/ items will show up for all cars. Generally the only thing you want there are wheels
Every .lst files consists of a first line and then any amount of entry blocks separated by an empty line.
1
Crashday-ShopDataList # defines a start of a .lst file
an example of an entry block:
1 2 3 4 5 6 7 8 9 10 11 12 13
Next: #--------------------------------------------- crsh1 # identifier name crashpower # group (car, fbumper, rbumper, sidekit, hood, rwing, wheels, performance, weapon, skin, cassis, armour, crashpower) NONE # parent object (e.g. car folder) or NONE $ID trkdata/cars/apachee/shop.lst crsh1.Name # Article name (English) DEPRECATED # UNUSED article description (English) aftercarbought # availability condition 0 # UNUSED show media _before_ available NONE # UNUSED media showed when available (can be NONE) 8000 # cost to buy in shop NONE # UNUSED shop picture 0 # is this a stock car part? 0 # !IMPORTANT! - Is mod content? This must be set to 1 if you are creating additional items for the shop. Used to properly save kits - Outblast.
If you want to add any part to the car, not only you have to have it in the model and listed in carinfo.cca, you will also need to create an .lst entry for that part. For every new car you also have to create a car entry, usually looking like this:
1 2 3 4 5 6 7 8 9 10 11 12 13
Next: #--------------------------------------------- *currentcar* # identifier name car # group (car, fbumper, rbumper, sidekit, hood, rwing, wheels, performance, weapon, skin, cassis, armour, crashpower) NONE # parent object (e.g. car folder) or NONE $ID trkdata/cars/apachee/shop.lst apachee.Name # Article name (English) DEPRECATED # UNUSED article description (English) withrespect 1370 # availability condition 0 # UNUSED show media _before_ available NONE # UNUSED media showed when available (can be NONE) 152000 # cost to buy in shop NONE # UNUSED shop picture 0 # is this a stock car part? 0 # !IMPORTANT! - Is mod content? This must be set to 1 if you are creating additional items for the shop. Used to properly save kits - Outblast.
In every block, if the .lst file was loaded in the car folder you can use *currentcar* text. When the game process the file it will automatically replace it with the cars identifier.
There are three possible availability conditions
withrespect [number] This item will unlock after number amount of respect is gained.
aftercarbought This item will be unlocked when you buy a car. Can only be used for items with specified parent object.
always This item will by always unlocked.
nowhere it is specified what car is used, so i guess the parent object is used for aftercarbought condition. But seeing how its named parent object originally and not car parent, makes me think we could define another item or something else as parent? Stackable objects or smth?
.tex Texture shader
path: found in the same folder as any texture you use. Has the same name as the given texture, but the .tex format.
These files define how textures are rendered in game.
1 2 3 4 5 6 7
has_alpha # defines if the texture has opaque places. If it does not, comment out that line or leave it blank. !The line still should be there! # disable_mipmapping # enable or disable mipmaps? default # ingame material type. Options: default, grass, tree, standard or STANDARD. If you choose standard, the file ends here. diffuseenvmap # shader type 0.3 # minimum reflection 0.7 # maximum reflection 3 # fresnel exponent
There are multiple possible shader types. Each of them defines how the following lines are read. Next up you will see a list of shader types followed by their used variables.
specularvertex # diffuse lighting with specular reflection map ultra # minimum graphics quality to activate shader(if user has lower setting, diffuse will be used) Possible options: "ultra", "high", "medium" or "low" _self_ # specular map file. _self_ to use alpha channel of the texture, or name of another texture. e.g. colwhite.tga 0.7 # specular overall strength 2 # specular power exponent 0.9 # diffuse sun light strength
chrome # chrome shader(great job explaining what it actually is) 1 # amount of chrome blended against diffuse
1 2
use_shaderparams_from # reference to other .tex file to pick shader specified there [filename].tex # tex file we copy the shader settings from
These were taken from the old sdk, but looking at the reversed Crashday source code, these were also found: diffuse(possibly one parameter, should be the same as default), specularmapping(first variable is graphics setting, then something else?), alphatest, alphatestdoubleside, alphadoubleside
.cdo Dynamic object definition
path: content/dynamics/
These files define dynamic objects that can be placed on the map. To add an object to the editor, you will also need to add a .cat file
1 2 3 4 5 6 7
Crashday-DynamicObject-File # defines a start of a .cdo file arrowright.p3d # UNUSED? should be the same as the next line arrowright.p3d # model used by the object METAL # material (Options: CARMETAL, METAL, STONE, WOOD, PLASTIC, RUBBER, EXPLOSIVE) 180 # mass in kg(-1 makes object immovable) 0 # UNUSED? amount of force needed to rip the object from the ground 0 -0.2 0 # center of gravity
.tun Tuning definition
path: cars/*carname*/ .tun
These files has a list of all possible tuning parts which the cars could. If you want a part to be purchasable, you also need to define a .lst file for said item.
Generally a .tun files starts like this:
1 2 3
# Crashday Car Tuning definition file 11 # Num tuning items in the file # Empty line
Don’t forget to adjust the amount of items line if you add or remove anything.
after the first block on every line you will have a separate tuning item. Every one of those should start with a unique identifier, which will be used in the shop lists and carinfo.cca to define bot setups.
1
name=meme1 *tuning item*
Every tuning item can have multiple parameters, separated with a space. For parameters starting with add, you can use negative values to remove some amount from that parameter. But be sure that total value would not go beyond possible limits e.g. a part that makes a car negative mass. If the parameter starts without add, it’s value will be multiplied with current value.
Here is a list of possible parameters:
Physical tuning
add_massadd= Amount of mass to add to the car.
add_horsepower= Amount of horsepower to add. This is a cosmetic value showed in garage.
add_topspeed= Amount to rise the top speed by.
add_torquenm= Amount of acceleration torque in Nm.
add_antirollheight= Amount of anti-roll in meters
add_trackfront= Length of the front wheel track. Positive values move the wheels away from center.
add_trackrear= Same as add_trackrear but for rear wheels.
add_wheelposyfront= Vertical position of the front wheels with fully compressed springs.
add_wheelposyrear= Same as add_wheelposyfront but for rear wheels.
brake= Brake strength.
diffratio= Differential value.
energyloss= Amount of energy lost when the car gets hit.
crashpower= Amount of energy car gives to other cars on hit.
deform= Car’s deformation strength.
springstiffness= Suspension spring stiffness.
springrange= Suspension spring length.
springdamping= Suspension spring damping.
DECALS/VINYLS & EFFECT PAINT
decaltype=decal Defines a decal. Has to be present.
decal1= Texture name for the first decal e.g. decal2a.tga. It is possible to add three more decals, just change the number (decal3=meme.tga)
decalcolor= RGB hex color value (without ‘#’ or ‘0x’) to be multiplied with the decal textures.
tex1toapplydecal1= Name of the texture (body2.tga to apply decal1 to. Change the last number to change the decal number applied. Change the first number if you want to apply to multiple textures (text2toapplydecal1=body2.tga should work)
OTHER
add_carclass= Upgrade the car’s class. This can “0.5”, “1”, “1.5”, “2”. An upgrade of “1” is equal to increase the classification by one classification letter, like from a “B” to an “A” car.
engsound= Change the engine sound set.
ignitionsound= Change the ignition sound set.
turbonoise= Change the volume of turbo blow off from 0 to 1.
gearboxnoise= Change the volume of gear box noise from 0 to 1.
backfires= Change the intensity of backfires from 0 to 1.
add_missilecapacity= Amount of starting missles of the car.
shift_exhaust1x= Move the first exhaust on the X coordinate by this value. Change the last letter to y or z to move in other coordinates.
shift_exhaust2x= Same as previous but for the second exhaust.
p3dmesh1= Add a mesh to the car. Parameter can end from 1 to 16.
removemesh1= Remove a mesh from the car. Also ends from 1 to 16. Note that this should be used only to remove non tuning meshes, the ones specified in mesh list in carinfo.cca.
.cfl Field object definition
path: /tiles/
These files are used to add tiles to the game.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
Crashday-FieldObject-File - # tile name (in editor, only used for custom tiles, which don't have a category specified) field.p3d # model used by the tile 1 1 # tile size (x y). Each can be 1 or 2 only (10 or 20 meters) GROUND_FLAT # UNUSED? can be GROUND_FLAT GROUND_EDGE or GROUND_SIDE 0 # list the track piece in the editor? If 0 a .cat file will be needed to show the tile in editor NONE # UNKNOWN. NONE or cfl to replace the original when the tile is on slope. Only for 1x1 size tiles 2.0 # maximum random ground shift 1 # after recover, can the player spawn on the tile? 0 # is tile a checkpoint? -8.5 10 8.5 16 # REMOVE THIS LINE IF THE PREVIOUS LINE IS 0. top-left and bottom-right coordinates of the checkpoint plane 1 # is it possible to freely roam across all tile without hitting anything? If 0 requires a .cai AI file. default # dynamic object dropping height. default = +100 meters. Use negative numbers if you want to put objects into tunnels STOP # bend restriction axes separated with a space in any order. Possible values: V1, V2, H1, H2, STOP at the end to indicate the end.
Crashday allows tiles to be bent using heightmaps in editor. Usually for that, tile models are pre-cut every meter. But sometimes you don’t want that, to avoid strange results e.g. misshaped houses on a slope. For that we can use the last parameter in .cfl, to restrain bending on certain axes. Here is an image to explain possible choices.
