Config documentation

This article is an unfinished work in progress or contains transferred information that needs to be rewritten or reformatted to fit our standards. Please excuse the mess and do not mark for deletion.

MAIN LEGO CONFIG FILE
Times are specied as 25.0 units per second.
Units equate to 40 per block in game

This is an extremely WIP page to document the entirety of LEGO Rock Raider's Lego.cfg file.

Should we put the default paths and values for some properties that have a single use, or only for examples of how it works (eg. the one for ProgressBar)?

Main {}

• TextureUsage – This is a major memory pool in the game, denoting the maximum allowed number of textures allowed present in-game at a time. The default value is 3145728, which allows on the order of 60 Rock Raiders to be teleported at a time (depending on the number of other objects present, though Rock Raiders are the most taxing on the memory). Testing has revealed that changing the value of TextureUsage can cause big changes to the game. Setting its value very high allows for many more objects to be teleported. For instance, aising this to 9567812 allows on the order of 120 Rock Raiders to be teleported at a time. Setting it very low seems to make the game lag a lot, and, everything looks weird. (this doesn't happen to me on Windows 7 AMD so further clarification on how this property works needs to be done by multiple people) Stability of the game in general when changing this value varies between computers of different specifications.

These properties control the credits:

• CreditsTextFile – Recalls the name and location of the credits file.
• CreditsBackAVI – Recalls the name and location of the looping stars FMV background that plays during the credits.

These properties control the in-game loading screens:

• LoadScreen – Recalls the name and path of the loading screen image.
• ShutdownScreen – Recalls the name and path of the shutdown screen image. However, this screen does not get used when quitting the game, and there appears to be no way to re-enable it, making this property useless.
• ProgressBar – Recalls the name and path of the colored bar image displayed on the loading screen to denote loading progress at the start of the game and of levels.
• ProgressWindow – Sets the X and Y coordinates of the progress bar from its top-left corner, followed by its width and height. For example, the default setting is R:142,450,353,9.
• LoadingText – Denotes the text displayed over the progress bar. As with all denoted text, underscores _ are used in place of spaces.

These properties control the folders for shared files:

• SharedTextures – Recalls the location of the folder for textures that are shared between multiple different objects.
• SharedObjects – Recalls the location of the folder for models that are shared between multiple different objects.

These properties control the buttons for the briefing and message panels at a 640x480 resolution. These properties can be copied and set to 800x600 and/or 1024x768.

• NextButton640x480 – Recalls the location of the texture for the next button.
• NextButtonPos640x480 – Sets the X and Y coordinates of the next button on the message panel.
• BackButton640x480 – Recalls the location of the texture for the repeat message button. This button is only used on the message panel.
• BackButtonPos640x480 – Sets the X and Y coordinates of the repeat message button on the message panel.
• BackArrow – Recalls the location of the texture for the back arrow. This button is only used on the briefing panel.

These properties control wall pro-meshes:

• WallProMeshes – Determines whether walls use pro-meshes in eye view and shoulder view. Can be set to TRUE or FALSE. If disabled, walls will appear flat like in top view.
• DynamicPM – Determines whether dynamic ProMeshes are used. what are dynamic meshes, changing this seems to do nothing
• HPBlocks – Determines the distance meshes are used? no clue, the numbers don't match up

These properties control building upgrades:

• BuildingUpgradeCostOre – Denotes how much Ore is needed to upgrade a building.
• BuildingUpgradeCostStuds – Denotes how many Building Studs are needed to upgrade a building.

These properties control music and sound:

• MusicOn – Determines whether the game starts with the soundtrack music turned on. Can be set to TRUE or FALSE. By default, this property is set to false in Lego* {}, but appears again at the very end of the config file in the LegoRR {} "settings for the final version" section, where it is set to true.
• SoundOn – Determines whether the game starts with sound turned on. Can be set to TRUE or FALSE
• CDStartTrack – Denotes the track number on the CD to start playing the soundtrack from when the music is activated. By default, this is set to 2 because the first track of the LEGO Rock Raiders CD contains the game's installer data, AVI movies, DirectX installer data, and in some versions the instruction manual. If a different game's CD is used for the soundtrack, this property should remain unchanged; if a music CD is used for the soundtrack, it should be set to 1.
• CDTracks – Denotes the number of music tracks on the CD to play.

These properties control Energy Crystal colors:

• PowerCrystalRGB – Denotes the RGB color of a powered Energy Crystal.
• UnpoweredCrystalRGB – Denotes the RGB color of a drained Energy Crystal.

This property controls tool tip color:

• ToolTipRGB – Denotes the RGB color of tool tips that display when mousing over objects and interface. Default color is dark green  .

These properties control camera movement:

• MinDist – Denotes the minimum distance in block units that the top view camera can zoom to. This property can be set to negative values, though zooming in that far makes it difficult to see anything or control the camera.
• MaxDist – Denotes the maximum distance in block units that the top view camera can zoom to.
• MinTilt – Denotes the minimum tilt in degrees (perpendicular to the ground; 0 points straight down and 90 points horizontally) that the camera can rotate to.
• MaxTilt – Denotes the maximum tilt in degrees that the camera can rotate to.
• CameraSpeed – Denotes the maximum speed that the top view camera can pan. unknown units^[verify]
• CameraAcceleration – Denotes how quickly the top view camera can accelerate when panned. unknown units^[verify]
• CameraDropOff – Denotes how quickly the top view camera can decelerate when panning stops. unknown units^[verify]
• MouseScrollBorder – Denotes how many pixels away from the edge of the game window the mouse pointer must be for the top view camera to start panning.
• MouseScrollIndent – Denotes how close in blocks to the edge of the map the top view camera can pan. 1 is to the edge of the map, 0 is one block past the edge. Setting this property to a negative value will lock the camera, as will setting it to a value larger than half of a level's dimensions.

These properties control model rendering:

• TVClipDist – Denotes the radius in block units that the world renders in top view.
• FPClipBlocks – Denotes the radius in blocks that the world renders in eye view. Setting this value to approximately 18 or higher may cause the game to crash when looking down long tunnels.
• HighPolyRange – Denotes the maximum range in block units within high polygon models are used.
• MedPolyRange – Denotes the maximum range in block units within medium polygon models are used.

These properties control Dynamite and Sonic Blaster ranges:

• DynamiteDamageRadius – Denotes the radius in block units within which objects are damaged by a Dynamite explosion.
• DynamiteMaxDamage – Denotes the maximum amount of damage that a point-blank Dynamite explosion delivers to an object.
• DynamiteWakeRadius – Denotes the radius in block units within which sleeping creatures will be woken up by a Dynamite explosion.
• BirdScarerRadius – Denotes the radius in block units in which creatures will be scared by a Sonic Blaster. Setting this value very high can crash the game

These properties control opening sequences and logos:

• DontPlayAvis – Determines whether or not FMV sequences are played. Can be set to TRUE or FALSE.
• RRAvi – Recalls the name and path of the intro FMV sequence that plays when starting up the game.
• LegoAvi – Recalls the name and path of the LEGO Media International FMV sequence that plays when starting up the game.
• DDIAvi – Recalls the name and path of the Data Design Interactive FMV sequence that plays when starting up the game. Unused by default.
• DDILogo – Recalls the name and path of the Data Design Interactive image that displays when starting up the game.
• DDILogoTime – Denotes the length of time in seconds that the DDILogo image displays.
• LMILogo – Recalls the name and path of the LEGO Media International image that displays when starting up the game. Unused by default.
• LMILogoTime – Denotes the length of time in seconds that the LMILogo image displays. Unused by default.
• Exclusive to the Japanese version of the game:
  • eidos – Recalls the name and path of the Eidos Interactive sequence that plays when starting up the game.
  • EidosLogo – Recalls the name and path of the Eidos Interactive image that displays when starting up the game.
  • EIDOSLogoTime – Denotes the length of time in seconds that the EidosLogo image displays.
  • LegoLogo – Recalls the name and path of the LEGO Media International image that displays when starting up the game. The image is identical to the unused LMILogo image.
  • LEGOLogoTime – Denotes the length of time in seconds that the LegoLogo image displays.

These properties control miscellaneous functions:

• TextPauseTime – Denotes the length of time in seconds that text messages appear in-game on the message panel after the message's streamed sound has stopped playing.
• DisplayAdvisor – Determines whether Chief's model is displayed. Can be set to TRUE or FALSE.
• OnlyBuildOnPaths – Determines whether buildings need to be built next to Power Paths. Can be set to TRUE or FALSE, but seems to default to TRUE no matter what it's set to.^[verify]

Dummy properties that are not defined in the executable, and thus do not work:

• DumpFile – Was likely meant to recall the name and path of the dump file where the game would output crash logs.
• DynamiteRadius – Was likely a generic radius for Dynamite effects that was replaced by more several more complex properties.

MiscObjects {}

• Boulder MiscAnims\Boulders\SmallBoulder
• Pusher MiscAnims\Effects\RD_Push_Weap
• Freezer MiscAnims\Effects\RD_Ice_weap
• BoulderExplode MiscAnims\Effects\Rock_Explo
• BoulderExplodeIce MiscAnims\Effects\Ice_Explo
• LaserShot MiscAnims\Effects\RD_Laser_Weap
• SmashPath MiscAnims\Effects\Concrete_Explo
• Crystal MiscAnims\Crystal\VLP_GreenCrystal
• Dynamite MiscAnims\Dynamite
• Ore MiscAnims\Ore\Ore1st
• ProcessedOre MiscAnims\Brick\2x2brick
• Barrier MiscAnims\Barrier
• Explosion MiscAnims\Effects\Mockup_explode3
• ElectricFence Buildings\E-Fence\E-Fence4
• ElectricFenceStud MiscAnims\Brick\SingleStud_ON
• ShortElectricFenceBeam Buildings\E-Fence\EFbeam
• LongElectricFenceBeam Buildings\E-Fence\EFlongbeam
• SpiderWeb MiscAnims\SpiderWeb
• PillarWorld\ProMeshes\pillar
• RechargeSparkle MiscAnims\Effects\Recharge_Twinkle
• MiniTeleportUpMini-Figures\Pilot\VLP_TelepUp
• OohScary MiscAnims\BirdScarer
• LazerHit MiscAnims\Effects\RD_Laser_Impact
• PusherHit MiscAnims\Effects\RD_Pusher_Impact
• FreezerHit MiscAnims\Effects\RD_Ice_weap_exp
• IceCube MiscAnims\IceCube
• PathDust MiscAnims\Effects\Pathdust
• LavaErosionSmoke1 MiscAnims\Effects\Erode1
• LavaErosionSmoke2 MiscAnims\Effects\Erode2
• LavaErosionSmoke3 MiscAnims\Effects\Erode3
• LavaErosionSmoke4 MiscAnims\Effects\Erode4
• BirdScarer MiscAnims\BirdScarer\Boom
• UpgradeEffect MiscAnims\Effects\UPGRADE_SPARKS

Stats {}

These properties affect objects being shot at by Rock Raiders armed with beam weapons. The following properties affect weapons being used against objects:

• CanBeShotAt – Determines whether an object can be shot at by armed Rock Raiders when Action Stations is activated. Can be set to TRUE or FALSE. Giving this property to non-monsters will cause them to take damage when hit by friendly fire, but they will not be intentionally targeted.
• CanFreeze – Determines whether an object can be damaged and frozen by a Freezer Beam. Can be set to TRUE or FALSE. Non-monsters with this property will take damage, but will not freeze.
• FreezerTime – Denotes the amount of time in seconds an object will remain frozen after being hit by a Freezer Beam. Setting this value to 0 or a negative number will have no effect.
• FreezerDamage – Denotes the amount of damage being shot by a Freezer Beam will do to an object. Values of 100 or higher will instantly kill objects that haven't been given extra health. Values of negative numbers will add that amount of health to an object.
• CanLaser – Determines whether an object can be damaged by a Laser Beam. Can be set to TRUE or FALSE.
• LaserDamage – Denotes the amount of damage being shot by a Laser Beam will do to an object. Values of 100 or higher will instantly kill objects that haven't been given extra health. Values of negative numbers will add that amount of health to an object.
• CanPush – Determines whether an object can be damaged and pushed by a Pusher Beam. Can be set to TRUE or FALSE. Non-monsters with this property will take damage, but will not get pushed.
• PusherDist – Denotes the distance in block units an object shot by a Pusher Beam will be pushed. Setting this value to 0 or a negative number will have no effect.
• PusherDamage – Denotes the amount of damage being shot by a Pusher Beam will do to an object. Values of 100 or higher will instantly kill objects that haven't been given extra health. Values of negative numbers will add that amount of health to an object.

WeaponTypes {}

Properties

• DefaultDamage – Denotes the default amount of damage a weapon will do to any objects that do not have their own damage values defined in that section. Leaving this property out of a section will cause it to do no damage to any objects without separately-defined damage values.
• RechargeTime – Denotes the amount of time a weapon needs to recharge before it can be used again. 25 specifies one second.
• WeaponRange – Denotes the distance in distance units a weapon can hit objects from.

Otherwise, all entries in a section must be the names of existing objects.

Sections

• Boulder {} – Denotes the amount of damage a boulder will do to an object it hits.
• FenceSpark {} – Denotes the amount of damage an Electric Fence will do to objects with the CanBeHitByFence property. However, no matter what its damage values are defined as, it will instantly kill anything it hits. Additionally, its RechargeTime value seems to be per each electrified block, rather than for the entire network.
• RockFallIn {} – Denotes the amount of damage being caught in a landslide will do to an object. A value of 0.98 seems to deal about 50 HP damage. Values of negative numbers will add that amount of health to an object. Separate values must be defined for each level an object has, with colons separating the values (by default, some objects become more resistant to landslides as they get upgraded).
• SpiderWeb {} – Denotes the amount of damage an object getting caught in a spider web will do to the web (commented as a "special case"). Values of 100 or higher will essentially instantly destroy the web. Values of 0 or lower will not damage it.

Levels {}

Properties

• FullName – Denotes the level's name. Underscores _ are used in place of spaces.

• DisableStartTeleport – Determines whether buildings will teleport in at the start of a level. Can be set to TRUE or FALSE. By default, levels that start with just a Tool Store will often lack this property, while levels that start with multiple buildings will often have it.
• DisableEndTeleport – Determines whether units will teleport back to the LMS Explorer at the end of a level before Chief gives his mission complete/failed speech.

These properties control level shape:

• BlockSize – Denotes the size of blocks in distance units. Default value for all levels is 40, which is equivalent to a 16x16 stud LEGO plate.
• DigDepth – Denotes the height of walls in distance units. Default value for all levels is 40.
• RoughLevel – Denotes how much the terrain height is adjusted by each integer in the Surface map in distance units. Default value for all levels is 6.
• RoofHeight – Denotes the height of the ceiling above the tops of the walls in distance units. Default value for all levels is 40.
• UseRoof – Determines whether a level uses a cavern ceiling. However, setting this to anything other than YES or TRUE causes the level to crash, and removing the property does not change anything, making it completely pointless.

These properties control creatures:

• EmergeCreature – Denotes the creature that will emerge through the Emerge map.
• EmergeTimeOut – Denotes the amount of time before an emerge trigger can be reused in time units. 25 specifies one second.
• Slug – Denotes the creature that will emerge from Slimy Slug Holes. If not defined, the Slimy Slug will be used by default.^[verify] This does not seem to work on Rock Hard for some reason, which continues to use only Slugs, while Back To Basics will use a mix of slugs and whatever this value is set to - meanwhile, removing the Slug creature entirely causes Back To Basics to crash, but Rock Hard loads fine and just doesn't generate slugs no matter what this property is set to. Need to figure out if this is an NPL thing or what.
• SlugTime – ?????^[verify]
• InitialSlugTime – ?????^[verify]