Level Properties

• Sample Properties File
• Materials
  • Default Materials
  • Material Properties
  • Sound IDs
• Corrugation
  • Default Corrugation
  • Corrugation Properties
• Dust
  • Default Dust
  • Dust Properties
• Particles
  • Default Particles
  • Particle Properties
• Trails
  • Default Trails
  • Trail Properties
• Gravity
  • Gravity Properties
• Wind
  • Wind Properties
• Pickups
  • Pickup Properties

This feature has been introduced in version 17.1124a.

Level properties are similar to parameters.txt for cars. They allow you to customize certain aspects of your tracks:

• Materials
  • Grip, roughness, hardness
  • Bump profile (corrugation)
  • Sounds
• Particle effects
  • Particles used by weapons
  • Dust (appears when driving on some materials)
  • Particle trails
• Gravity
• Wind
• Pickups

RVGL looks for a properties.txt file when loading a level. If such a file exists, the original materials and effects will be replaced with the ones in the file.

This can be used to tweak existing materials so they fit your track better or even to create entirely new materials like snow.

Sample Properties File

properties_default.txt

This file contains all stock properties. You can use this to base your custom properties on.

Materials

A material structure provides information about the surface cars drive on. Each material has a unique ID. In total, 64 different materials can be used, of which the first 27 are default materials. You can either override them or use the additional user slots.

Default Materials

To override a material, add the following to your properties.txt file:

MATERIAL {
  ID               10               ; Material ID [0 - 63]
  Name             "Ice 1 Snow"     ; Display name
  Color            200 200 200      ; Display color

  Spark            true             ; Material emits particles
  Skid             true             ; Skid marks appear on material
  OutOfBounds      false            ; Not implemented
  Corrugated       true             ; Material is bumpy
  Moves            false            ; Moves cars like museum conveyors
  Dusty            true             ; Material emits dust

  Roughness        0.4              ; Roughness of the material
  Grip             0.4              ; Grip of the material
  Hardness         0.2              ; Hardness of the material

  DefaultSound     87               ; Sound when driving normally
  SkidSound        87               ; Sound when skidding [6:Normal, 7:Rough]
  ScrapeSound      5                ; Car body scrape [5:Normal]

  SkidColor        207 215 220      ; Color of the skid marks
  CorrugationType  2                ; Type of bumpiness
  DustType         2                ; Type of dust
  Velocity         0.0 0.0 0.0      ; Speed and direction cars are moved in
}

In this case, we're overriding the ICE1 material (ID 10).

If you're looking for materials to safely override: DIRT1, DIRT2 and DIRT3 share the same values, there is no difference between them at all. CARPETSHAG and CARPETTILE also have the same values.

Material Properties

Sound IDs

Use these IDs for the DefaultSound, SkidSound and ScrapeSound properties.

To use IDs other than 6 and 7 for normal and rough skid sounds, stock track sounds can be replaced. For example, rattler.wav from Ghost Town could be replaced with a custom skid sound. To do so, place a file named rattler.wav in your track's custom folder and use ID 89 in your properties.txt file.

Corrugation

Corrugation structures define the bumpiness of the surface. There are 32 slots available, out of which 8 types are already defined by the game. Either override these default slots or use the additional user slots.

Default Corrugation

To override a corrugation, paste the following snipped into your properties.txt:

CORRUGATION {
  ID              1                             ; Corrugation ID [0-31]
  Name            "Name"                        ; Display name

  Amplitude       0.000000                      ; Amplitude of bumps (strength)
  Wavelength      0.000000 0.000000             ; Frequency of bumps
}

Corrugation Properties

Dust

Dust structures are a set of two particles with a probability and variance. Materials emit dust when cars drive on them. There are 32 slots available, with 6 default dust types.

Default Dust

To override a dust type, copy the following snippet into your properties.txt:

DUST {
  ID              1                             ; Dust ID [0 - 31]
  Name            "GRAVEL"                      ; Display name

  SparkType       4                             ; Particle to emit
  ParticleChance  0.600000                      ; Probability of a particle
  ParticleRandom  0.600000                      ; Probability variance

  SmokeType       29                            ; Smoke particle to emit
  SmokeChance     0.300000                      ; Probability of a smoke part.
  SmokeRandom     0.600000                      ; Probability variance
}

Dust Properties

Particles

Particles (also called sparks) can be emitted by materials, weapons, cars and other objects. There are 64 slots available, including 31 default types.

Default Particles

To override a particle, copy the following snippet into your properties.txt:

SPARK {
  ID              0                             ; Particle ID [0 - 63]
  Name            "SPARK"                       ; Display name

  CollideWorld    true                          ; Collision with the world
  CollideObject   true                          ; Collision with objects
  CollideCam      true                          ; Collision with camera
  HasTrail        false                         ; Particle has a trail
  FieldAffect     true                          ; Is affected by force fields
  Spins           false                         ; Particle spins
  Grows           false                         ; Particle grows
  Additive        true                          ; Draw particle additively
  Horizontal      false                         ; Draw particle flat

  Size            1.000000 1.000000             ; Size of the particle
  UV              0.937500 0.000000             ; Top left UV coordinates
  UVSize          0.062500 0.062500             ; Width and height of UV
  TexturePage     47                            ; Texture page
  Color           255 255 255                   ; Color of the particle

  Mass            0.100000                      ; Mass of the particle
  Resistance      0.020000                      ; Air resistance
  Friction        0.100000                      ; Sliding friction
  Restitution     0.500000                      ; Bounciness

  LifeTime        0.500000                      ; Maximum life time
  LifeTimeVar     0.050000                      ; Life time variance

  SpinRate        0.000000                      ; Avg. spin rate (radians/sec)
  SpinRateVar     0.000000                      ; Variation of the spin rate

  SizeVar         0.000000                      ; Size variation
  GrowRate        0.000000                      ; How quickly it grows
  GrowRateVar     0.000000                      ; Grow variation

  TrailType       1                             ; ID of the trail to use
}

Particle Properties

Trails

Trails are similar to particles. They follow particles. They're used for fireworks and some sparks. There are 3 default trail types and a total of 32 slots for custom tracks.

Default Trails

To override a spark type, copy the following snippet into your properties.txt:

TRAIL {
  ID              1                             ; Trail ID [0 - 31]
  Name            "SPARK"                       ; Display name

  Fades           true                          ; Trail fades out
  Shrinks         true                          ; Trail shrinks
  Expands         false                         ; Trail expands
  UV              0.960938 0.000000             ; UV coord for trail segments
  UVEnd           0.960938 0.000000             ; UV coord for last segment
  UVSize          0.007812 0.062500             ; Width and height of both UV
  TexturePage     47                            ; Texture page
  Color           255 255 255 255               ; Alpha, Red, Green, Blue
  LifeTime        0.030000                      ; Maximum life time
  Width           1.000000                      ; Width of segments
  Length          2                             ; Number of segments
}

Trail Properties

Gravity

This section allows you to modify the behavior of the global gravitational field for your track. To customize the level's gravity, copy the following snippet into your properties.txt:

As of version 19.1230a, the ROCK and ROCKTYPE level *.inf keys are deprecated. New tracks should set these properties in the properties.txt GRAVITY section instead.

GRAVITY {
  Magnitude       2200.0                        ; Magnitude of gravity
  Direction       0.000000 1.000000 0.000000    ; Direction of gravity
  Dampening       0.000000                      ; Dampening effect
  Rockiness       0.000000 0.000000             ; Rocky effect parameters
                  0.000000 0.000000
  RockyType       0                             ; Type of rocky effect [0 - 1]
}

Gravity Properties

Wind

This section allows you to modify the behavior of the Wind force field types in your track. To customize the level's wind properties, copy the following snippet into your properties.txt:

WIND {
  Priority        2                             ; Field priority [0 - 2]
  TimeMin         5                             ; Min update rate
  TimeMax         30                            ; Max update rate
  Expands         true                          ; Size expands
}

Wind Properties

Pickups

This section allows you to modify the behavior of pickups in the level, including spawn count. To customize pickups, copy the following snippet into your properties.txt:

PICKUPS {
  SpawnCount      5 2                           ; Initial and per-player count
  EnvColor        255 255 128                   ; Color of shininess (RGB)
  LightColor      128 96 0                      ; Color of light (RGB)
}

Pickup Properties