StdDoor
gen.osm 1/G/2

The door is opened by the messages TurnOn or Open. It is closed with TurnOff or Close. It is also operates in response to FrobWorldEnd. Frobbing normally toggles the state of the door. In Thief 2, if the door had previously been halted, frobbing it will reverse the action it was engaged in before the halt. The door states are closed, open, closing, opening, and halted. A door that is locked and closed cannot be opened by FrobWorldEnd. Instead, it plays an environmental schema with the event tags Event Reject, Operation OpenDoor. The lock is disregarded when the door opens any other way. The lock will also be disregarded if the config variable LockCheat is set (only in Thief 2). When a door is locked, it will close itself. Unlocking a door also opens it. Doors cannot be killed. When Slain, the door will be resurrected with 1 hit point. Any Lock links from the door are removed, and the Engine Features\Locked and Engine Features\KeyDst properties are removed. The Engine Features\Locked property is set to 0 before being removed, so the door will receive a NowUnlocked message. The door opens with it is slain. In Thief 2, if the door has the Script\Timing property, it will automatically close itself that many milliseconds after it is opened. The timer aborts if the door begins to close. When the door state changes, an environmental schema is played with the event tags Event StateChange, OpenState <state>, OldOpenState ><state>. Previous schemas are halted if the state is closed or open. If the door had recently been frobbed by the player, with FrobWorldEnd or PlayerToolFrob, the tag CreatureType Player is added to the list. The flag that determines whether to add the tag is cleared when the door state is closed, open, or halted. When the door is opened, it will set a secret as being found if it is marked as Hidden in Dark Gamesys\Stats. Two or more doors can be combined into a set of "double" doors by creating ScriptParams links between the doors and setting the link data to Double. There must be at least one link between any two doors in a group. More than one link between two doors is unnecessary, but harmless. The doors will keep in synch for most state changes. A halted door will not cause the linked doors to halt. If the linked doors are meant to be locked, they should all have the Engine Features\Locked property (or a Lock link). A door without the property will not synch properly with the others. (This is because it might have been Slain and lost the property that way.) Doors keep in synch by sending the SynchUp message from the door that had its state changed to each door it has a link with. When a double door spans an opening, it can cause AI to get stuck between them. The AI tries to frob both doors, which makes them start to open, then immediately close. Thief 2 solves this by creating a marker with the property AI\Utility\Path avoid on it. The marker is placed at the midpoint between two doors, but only if the doors share a room boundary, and are touching (or close to) at the midpoint. The marker will be created for pairs of doors with a ScriptParams link between them, regardless of whether the data is set to Double. So you can take advantage of the feature without having to synchronize the doors.