Skip to content
OpenTS Manual

Theater control files

Formats

Changed in 0.1.0

Defines theater-wide tile-set indices and the properties of each tile set.

Format
Kind
Configuration file
Filename
<Theater root>.INI

Each theater carries a root name, and its control file is that root plus .INI: TEMPERAT.INI for the temperate theater and SNOW.INI for snow. The file is read out of the theater archives, which are mounted with the theater palette once the map’s [Map] Theater= value is known — and only when that value differs from the theater already loaded, so a scenario that reuses the current theater keeps the tile types it already holds. Reading the file discards the previous theater’s tile types and loads the shared cell-shadow shape and the theater’s own slope-depth shapes; individual tile artwork is loaded afterwards, on demand, for the tiles a map actually places.

[General] assigns tile sets to engine roles: the clear ground, the water set, the cliff set, the height ramp base, and the rest. Its values are tile-set numbers — the NNNN of a [TileSetNNNN] section — and not tile indices. Each is resolved to a live tile index during the pass that reads the numbered sections, so a role naming a set that pass never reaches stays unresolved.

Numbered sections are read in order from [TileSet0000] upward, with the number zero-padded to four digits.

The numbered-set lookup grows with the sections and has no 255-set ceiling. A set’s MarbleMadness and NonMarbleMadness values name another numbered set; the tile’s offset inside its own set is applied inside that target. An absent target or an offset past the target’s TilesInSet becomes no alternate and is reported rather than crossing into the next set.

Artwork for a set is named from its FileName plus a two-digit index starting at 01, extended with the theater’s file suffix: FileName=RVCLIF with TilesInSet=8 loads RVCLIF01.TEM through RVCLIF08.TEM in the temperate theater, and the .SNO equivalents in snow. A trailing lowercase letter marks an alternate for the same tile — RVCLIF01a, then RVCLIF01b — and reading alternates stops at the first letter with no file. When a theater file is missing, the loader retries the same name with the marble-madness extension — .MMT in temperate and .MMS elsewhere — unless the set carries NonMarbleMadness=0.

A third kind of section is optional: one named by a set’s own SetName value supplies per-tile animation for the set’s base tiles — lettered alternates never carry one. Tile<NN>Anim names the animation for tile NN of that set, and Tile<NN>XOffset, Tile<NN>YOffset, Tile<NN>AttachesTo, and Tile<NN>ZAdjust are read once that animation resolves.

TEMPERAT.INI
[General]
ClearTile=0     ; tile-set numbers, not tile indices
WaterSet=21
CliffSet=10
ClearToRoughLat=14


[TileSet0631]      ; example set; 0631 is the number a [General] role would name
SetName=Riverbank cliffs
FileName=RVCLIF    ; loads RVCLIF01.TEM through RVCLIF08.TEM
TilesInSet=8
Morphable=no
AllowToPlace=yes
AllowTiberium=no


[Riverbank cliffs] ; named by this set's SetName
Tile03Anim=MYFALLS ; AnimType registered in rules.ini
Tile03ZAdjust=-12

Accepted settings

81 of 81

KeyDescriptionValueWhen omitted
AllowBurrowing[<TileSet ID>]Ground that a subterranean unit may dive into or surface through.booleanyes
AllowTiberium[<TileSet ID>]Lets Tiberium take root on the tiles of a theater tile set.booleanno
AllowToPlaceNo effect[<TileSet ID>]Parsed tile-set flag that the engine never uses.booleanyes
BlackTileNo effect[General]Tile-set number that resolves to a tile index nothing reads.integer-1
BlueMoldTile[General]Tile set whose first tile is a theater's plain blue mold ground.integer-1
BridgeBottomLeft1[General]Position within a bridge tile set of the piece that closes a north-south span at its bottom-left end.integer-1
BridgeBottomLeft2[General]Second position accepted as the bottom-left end of a north-south bridge span.integer-1
BridgeBottomRight1[General]Position within a bridge tile set of the piece that closes an east-west span at its bottom-right end.integer-1
BridgeBottomRight2[General]Second position accepted as the bottom-right end of an east-west bridge span.integer-1
BridgeMiddle1[General]Position within a bridge tile set of the first of the five middle pieces of an east-west span.integer-1
BridgeMiddle2[General]Position within a bridge tile set of the first of the five middle pieces of a north-south span.integer-1
BridgeSet[General]The tile set that supplies the sixteen pieces a road bridge is built from.integer-1
BridgeTopLeft1[General]Position within a bridge tile set of the piece that starts an east-west span at its top-left end.integer-1
BridgeTopLeft2[General]Second position accepted as the top-left end of an east-west bridge span.integer-1
BridgeTopRight1[General]Position within a bridge tile set of the piece that starts a north-south span at its top-right end.integer-1
BridgeTopRight2[General]Second position accepted as the top-right end of a north-south bridge span.integer-1
ClearTile[General]Tile set holding a theater's plain clear ground, used as the substitute for a cell that has no tile.integer-1
ClearToBlueMoldLat[General]Tile set holding the sixteen blend pieces laid where blue mold meets other terrain.integer-1
ClearToCrystalLat[General]Tile set holding the sixteen blend pieces laid where crystal terrain meets other terrain.integer-1
ClearToGreenLat[General]Tile set holding the sixteen blend pieces laid where green terrain meets other terrain.integer-1
ClearToPaveLat[General]Tile set holding the sixteen blend pieces laid where pavement meets other terrain.integer-1
ClearToRoughLat[General]Tile set holding the sixteen blend pieces laid where rough ground meets other terrain.integer-1
ClearToSandLat[General]Tile set holding the sixteen blend pieces laid where sand meets other terrain.integer-1
CliffRamps[General]Tile set holding the theater's twenty cliff ramp pieces.integer-1
CliffSet[General]Tile set holding the theater's forty cliff faces.integer-1
CrystalCliff[General]Tile set holding the crystal cliff pieces.integer-1
CrystalTile[General]Tile set whose first tile is a theater's plain crystal ground.integer-1
DestroyableCliffs[General]Tile set holding the two cliff faces that weapon fire can bring down.integer-2
DirtRoadCurve[General]The tile set the whole run of 101 flat dirt road pieces is counted from.integer-1
DirtRoadJunction[General]The tile set that supplies the eleven dirt road junctions.integer-1
DirtRoadSlopesNo effect[General]The tile set that supplies the eight pieces carrying a dirt road up a ramp.integer-1
DirtRoadStraightNo effect[General]Parsed tile set of straight dirt road pieces that nothing consults.integer-1
DirtTrackTunnels[General]The tile set that supplies the four dirt railway tunnel mouths, one per facing.integer-1
DirtTunnels[General]The tile set that supplies the four dirt road tunnel mouths, one per facing.integer-1
FileName[<TileSet ID>]Stem of the artwork file names a tile set loads its tiles from.stringTILE
GreenTile[General]Tile set whose first tile is a theater's plain green ground.integer-1
HeightBaseNo effect[General]Tile set number that is resolved and never read.integer-1
Ice1Set[General]First of the three sixty-four-tile ice sets a snow theater provides.integer-1
Ice2Set[General]Second of the three sixty-four-tile ice sets a snow theater provides.integer-1
Ice3Set[General]Third of the three sixty-four-tile ice sets a snow theater provides.integer-1
IceShoreSet[General]Forty-eight-tile set of the land-side pieces laid where ice meets ground.integer-1
LastTilesInSet[<TileSet ID>]Number of tiles the set held when the maps in circulation were numbered, so that older tile indices can be shifted into line.integer-1
MarbleMadnessNo effect[<TileSet ID>]Parsed tile-set number that the engine resolves and never reads.integer65535
Medians[General]Fourteen-tile set of the divider strips laid down the middle lane of a paved road.integer-1
MiscPaveTile[General]Fourteen-tile set of pavement patches and weathering used to dress paved ground.integer-1
MMRampBase[General]Tile set holding the marble madness counterparts of the plain ramps.integer-1
MonorailSlopesNo effect[General]Parsed tile set of monorail ramp pieces that nothing consults.integer-1
Morphable[<TileSet ID>]Ground that the terrain-reshaping tools are allowed to move, and that will take a smudge.booleanno
NonMarbleMadness[<TileSet ID>]Tile-set number whose only live consequence is whether the alternate artwork extension is tried when a tile file is missing.integer65535
PavedRoadEnds[General]The tile set that supplies the four caps that close the end of a paved road.integer-1
PavedRoads[General]The tile set the fifteen tiles counted as paved road are counted from.integer-1
PavedRoadSlopesNo effect[General]Parsed tile set of paved road ramp pieces that nothing consults.integer-1
PaveTile[General]Tile set whose first tile is a theater's plain pavement.integer-1
RampBase[General]Tile set holding the twenty plain ramps that carry ground between height levels.integer-1
RampSmooth[General]Tile set holding the twelve pieces that blend a straight ramp into flat ground.integer-1
RequiredForRMG[<TileSet ID>]Tile set whose artwork is kept in memory on a generated map even while no cell uses it.booleanno
Rocks[General]Tile set whose first tile is the rock ground the random map generator paints on snow maps.integer-1
RoughGround[General]Ten-tile set of rough ground decorations scattered by the random map generator.integer-1
RoughTile[General]Tile set whose first tile is a theater's plain rough ground.integer-1
SandTile[General]Tile set whose first tile is a theater's plain sand ground.integer-1
SetName[<TileSet ID>]Section heading a tile set's per-tile animations are read from, and the stem of the name each of its tiles carries.stringNo Name
ShadowCaster[<TileSet ID>]Tile set whose tiles darken the cells below them with a cliff shadow.booleanno
ShadowTiles[<TileSet ID>]Second condition a shadow-casting tile set must satisfy before any of its tiles is marked as a caster.integer0
ShorePieces[General]Forty-two-tile set of the shoreline pieces laid between water and land.integer-1
SlopeSetPieces[General]Tile set holding the ten slope pieces that carry ground between height levels.integer-1
SlopeSetPieces2[General]Tile set holding the marble madness counterparts of the slope pieces.integer-1
SwampTile[General]Nine-tile set of swamp ground, the first tile plain and the rest decorative.integer-1
TilesInSet[<TileSet ID>]Count of tiles a tile set contributes to the theater, and the marker that ends the theater read.integer-1
ToSnowTheaterNo effect[<TileSet ID>]Parsed tile-set number that the engine stores and never reads.integer-1
ToTemperateTheaterNo effect[<TileSet ID>]Parsed tile-set number that the engine stores and never reads.integer-1
TrackTunnels[General]The tile set that supplies the four railway tunnel mouths, one per facing.integer-1
TrainBridgeSet[General]The tile set that supplies the sixteen pieces a railway bridge is built from.integer-1
Tunnels[General]The tile set that supplies the four road tunnel mouths, one per facing.integer-1
WaterCaves[General]The tile set that supplies the eight cave mouths cut into a cliff at the water line.integer-1
WaterCliffs[General]Tile set holding the cliff faces that drop straight into water.integer-1
WaterfallEast[General]The tile set that supplies the four pieces of a waterfall running east.integer-1
WaterfallNorth[General]The tile set that supplies the four pieces of a waterfall running north.integer-1
WaterfallSouth[General]The tile set that supplies the four pieces of a waterfall running south.integer-1
WaterfallWest[General]The tile set that supplies the four pieces of a waterfall running west.integer-1
WaterSet[General]Fourteen-tile set of open water.integer-1
WaterToSwampLat[General]Tile set holding the sixteen blend pieces laid where swamp meets other terrain.integer-1

Source files

Linked at revision 59fae722af8c.

History

  1. Changed0.1.0In development

    Remove the theater tile-set lookup ceiling