Skyscraper Building Design Guide

The Globals Section

The Globals section contains the general information about your building. This section is required, since it determines if a building file is valid. The section starts with this header:
<Globals>

and ends with this footer:
<EndGlobals>

Parameters are placed between those two markers, and look like this:
Parameter = value

Example:
Name = Triton Center

Parameters (all are optional):

1. Name - building name
Example: Name = My Building

2. Designer - name of building's designer
Designer = Me

3. Location - location of the building
Location = 100 Main Street

4. Description - Brief description of the building
Description = A really average building

5. Version - Version of the building (can be text)
Version = 1

6. CameraFloor - camera's starting floor, starting with 0 (like Floors command) - default is 0
CameraFloor = 0

7. CameraPosition - camera's starting position in X (left/right) and Z (forward/backward) feet coordinates - default is "0, 0"
Syntax: CameraPosition = X, Z
CameraPosition = 0, -10

8. CameraDirection - specifies a 3D point that the camera is looking at on startup (instead of specifying rotation), in X (left/right), Y (up down), and Z (forward/backward) feet coordinates.
CameraDirection = 0, 10, 28.8

9. CameraRotation - axis rotation of the camera on startup - X is degrees up/down, Y is degrees left/right, and Z is spin. Default is "0, 0, 0", and the example makes the camera face right.
Syntax: CameraRotation = X, Y, Z
CameraRotation = 0, 90, 0

10. Sky - which skybox texture pack to use, if the Caelum sky system is off. In the following example, the chosen pack is "noon", and the file "sky-noon.zip" will be loaded. Default is "noon".
Sky = noon

11. DynamicSky - which Caelum sky script to use. In the following example, the script is "RainWind", which is listed in the data/caelum/sky.os resource file. Default is "DefaultSky".
DynamicSky = RainWind

Available sky types in data/caelum/sky.os file:
DefaultBase
DefaultSky
Cloudy
Overcast
BigPuffyStars
BigPuffyStarsWithFogComposer
MidnightSun
Eclipse
FogSky
RainWind
RainUp
ShadowDebug
HugeAmbientFactor
BasicCloud
OverrideCloud
CloudMesh
CloudFade
SkyDomeOverrideHazeTest
GroundFogNoise
SandStormTest

12. InterfloorOnTop - determines if the interfloor area should be located at the bottom or top of each floor. Interfloor areas represent the area used by floor trusses (supports), between a level's ceiling and the next level. Since each floor needs supports below it, the default is false.
InterfloorOnTop = true

13. Collisions - enables/disables collisions (default is true)
Collisions = false

14. Gravity - enables/disables gravity (default is true)
Gravity = false

15. Coordinates - set latitude and longitude of building (for sky system)
Coordinates = 41.883, -87.629

16. DateTime - set UTC date/time on startup (in Julian value), for sky system, or set to "now" to use the current system time
DateTime = 2457197.1254
DateTime = now

17. TimeScale - sets the time multiplier for the sky system. The default is 25. Set to 1 for real-time.
TimeScale = 1

18. Position - set the 3D position of this building, used when loading multiple buildings. See the Load command in the Buildings section for more information.
Syntax: Position = X, Y, Z
Example: Position = 100, 0, 100

19. Rotation - set the 3D rotation (Y axis, which is left/right), in degrees, of this building, used when loading multiple buildings. See the Load command in the Buildings section for more information.
Syntax: Rotation = value
Example: Rotation = 90

20. Bounds - set the 3D boundaries of this building, which is only used if loading multiple buildings, and if this building is not the first (primary) building. If both Y values are 0, the Y values are set to be unlimited. See the Load command in the Buildings section for more information.
Syntax: Bounds = MinX, MinY, MinZ, MaxX, MaxY, MaxZ
Example: Bounds = -100, 0, -100, 100, 0, 100

21. Lobby - lobby level, which is the starting floor for random activity - default is 0
Lobby = 0

22. Map - enables or disables the Map Generator. When the Map Generator is enabled, a real-time map render texture is made available, and is named MapCamera. Since the map generator takes up rendering time, the default is off to improve performance. To change the camera zoom, see the SetCameraZoom command in the Extended Commands section.
Map = on