OCB and Setup Instructions

Updated on 16 November 2023

Lara #

Changes to Lara #

TombEngine has introduced several tweaks and changes to Lara to improve how responsive she is and extend her move set. Whilst the same controls apply: some adjustments do not compare directly to the classic games.

Crouch Roll and Turn #

TombEngine has restored the ability to roll whilst crouched down. This was cut from Tomb Raider III.

To perform this: simply press the SPRINT key.

To perform the crouch roll: simple press the ROLL key and Lara will turn around 180 degrees.

Enabled by amending the settings.lua file, located in the project SCRIPT folder so that anims.crouchRoll = true

Extra Animations #

For TombEngine: there is an additional object “LARA_EXTRA_ANIMS” that contains special animations for unique situations across the classic games. To use these in-game: you can call on them easily using the steps outlined below:

  • Open your main game WAD2 in Wadtool as the destination WAD2. Then locate the LARA object and double-click it to open up the Animation Editor.
  • Scroll down to the bottom of the Animation List and find the last animation number. In this example: as this is the default TombEngine WAD2: it is 568.
  • The LARA_EXTRA_ANIMs will continue from this number. For example, if I wanted to trigger the TNT_ACTIVATION animation: it would be Lara animation 568 + 9 = 577.

Extended Crawling #

Lara can crawl up and down from a 1, 2 or 3-click height.

Camera improvements have been made when Lara is in her crouch state to allow the player to have a smoother experience than in the classic games.

Enabled by amending the settings.lua file, located in the project SCRIPT folder so that anims.crawlExtended = true

Ledge Jump #

Lara can jump up a 4-click height from hanging down and also perform acrobatics to turn around and jump to a ledge behind her from hanging.

To perform the jump up from hanging: make sure Lara is hanging off an edge and press the JUMP button.

To perform the jump back: press JUMP+DOWN whilst hanging.

Enabled by amending the settings.lua file, located in the project SCRIPT folder so that anims.ledgeJumps = true

Monkey-Swing Changes #

Lara will now automatically jump down at the and of a monkey-swing section if there is ground for her to land on within range.

Enabled by amending the settings.lua file, located in the project SCRIPT folder so that anims.monkeyAutoJump = true

Pose #

In the classic games: if the player left Lara unattended: she would just stand on the spot. Now she will pose with her arms crossed as though she is waiting for the player.

Enabled by amending the settings.lua file, located in the project SCRIPT folder so that anims.pose = true

Sprint Jump #

Lara can jump whilst sprinting for a short time that allows her to cover a large gap. Whilst this is fairly unrealistic: it has been included as it was requested. 

Enabled by amending the settings.lua file, located in the project SCRIPT folder so that anims.sprintJump = true

Enemies #

Cobra #

To correct the death animation: please change the STATE ID of ANIMATION 5: “COBRA_ANIM_DEATH” from 0 to 4

Dog #

  • OCB 0: Normal behaviour
  • OCB 1: Starts frozen (laying down like statues). Trigger to wake them up.

Guardx, SWAT and SWAT Plus #

  • OCB 0: Default.
  • OCB 1: Reload
  • OCB 2: Door Kick
  • OCB 3: Rappel Down Rope
  • OCB 4: Sleeping
  • OCB 5: Rappel Down Rope (Fast)
  • OCB 6: Wait On Wall
  • OCB 7: Use Computer
  • OCB 8: Start Hunt Stop
  • OCB 10: Idle
  • OCB 11: Run

Hitman #

  • Use the room flag “No Lens Flare” and he will suffocate. The behaviour for this is that he will first try to escape, then suffocate if he cannot. Use the “Set Box Sector” flags on all doors to prevent escape.
  • Set the room type to “Water” and he will electrocute himself.


  • OCB 1: Climbs up when triggered.
  • OCB 2: Rolls on the floor when triggered.
  • OCB 3: Attacks player with rocks when triggered.
  • If the player is holding a lit torch or throws the lit torch towards the imp: they will run away scared.

Roman God 1 / Roman God 2 #

  • OCB 0: Hammer God mode. Uses a powerful hammer attack.
  • OCB 1: Sword God mode. Fires a bolt of homing energy at Lara.

Sphinx #

  • OCB 0: Waits until the player approaches before charging.
  • OCB 1: Charges towards the player when triggered.

Sophia Leigh #

  • OCB 0: Normal mode. Sophia behaves like a regular enemy.
  • OCB 1: Tower Mode. Her behaviour matches Tomb Raider III. Invincible unless triggered to be killed.
  • OCB 2: Tower Mode with Volumes. Same as Tower Mode but Sophia’s ascent can be controlled using volumes in Tomb Editor.
  • Please note that you need to use AIX1 null-meshes.

Wasp #

  • AI_MODIFY object won’t allow it to land, the wasp will always fly.

Winged Mummy #

  • OCB 1: Start off flying when triggered.
  • OCB 2: Start as a mummy when triggered.
  • OCB 4: Start posed.
  • OCB 8: No Wings.
  • OCB 16: Disable Bomb Attack.
  • OCB 32: Disable Shard Attack.

Keys #

  • To enable multiple usages, simply set the trigger type of the keyhole object as “Switch”.
  • You can use a custom keyhole animation by setting the OCB number. The default OCB 0 will show Lara using the key animation. If you use a positive OCB number, the animation will play according to that number.

Puzzles #

  • To enable multiple usages, simply set the trigger type of the puzzle-hole or puzzle-done object as “Switch”. Can be mixed with puzzle done and puzzle holes of the same or different type.

Switches #

  • OCB 0: Wall Lever
  • OCB 1: Small lever
  • OCB 2: Small button
  • OCB 3: Big Button
  • OCB 4: Giant Button
  • OCB 5: Valve
  • OCB 6: Reach In Hole
  • OCB 7: Lua Switch (see here for more details).
  • OCB 9: Pry out of the wall with the crowbar.
  • Users can assign custom animations to a switch:
  • OCB = Animation number for “on” animation
  • OCB + 1 = Animation “off” number.

Cog Switch #

  • Use OCB 0 to have the traditional behaviour.
  • Use any other OCB to can use the Cog Switch without need of any door linked.

Shoot Switch 1 #

  • Set all code bits ON (click the object and press the o key ) to activate a heavy trigger placed underneath the switch.
  • Alternately use a SWITCH trigger below to activate triggers when shot.

Shoot Switch 2 #

  • OCB 444 – Shatters when shot.

Shoot Switch 3 or 4 #

  • Same as SHOOT_SWITCH1 but has no shatter effect.

Interactives #

Bridges #

  • This object can be positioned freely without requiring any specific trigger beneath it. It also can be rotated and adjusted in real-time through Lua. Additionally, any items placed on a moving platform will be transported along with it.
  • The surface that the player can stand on is taken from the bridge object’s collision.
  • The only condition is that pickup must be activated (1-5 bits set in the edit object window or manually activated).

Corpse #

  • OCB 0 for a carcass that is eaten by the Compsognathus dinosaur.
  • OCB 1: Hangs in the air as if used as bait and will fall if shot.
  • Please note you must use the patched version found here.

Color/Pulse/Strobe Light #

  • The light colour is chosen in Tomb Editor by changing the object tint.

Electrical Light #

  • The light colour is chosen in Tomb Editor by changing the object tint.
  • OCB + (mesh number) allows light to behave like a neon light.
  • OCB – (mesh number) makes the light flicker.

Pushable Objects & Blocks #

Pushable objects can now be pushed over the edge with new custom animations to make the transition smoother (credit: GeckoKid)

  • OCB 0: Standard behaviour.
  • OCB +1: Can Fall, If added, Lara can push the pushable through border edges.
  • OCB +2: Don’t Align Center, If added, Lara’ll be able to grab the pushable without the need to position Lara in the middle of the sector to interact.
  • OCB +4: Is Buoyant. If added, the pushable will float to the surface when it is in a water room.
  • OCB +8: Animation System, If added, Lara will use the classic TR1-TR3 push/pull animations. (Need WAD update).
  • Change the OCB to a negative number to prevent the pushable from being moved.

For example: if you require a pushable object that you could push over an edge and float in water you will do OCB 1 + 4 = 5. If you then wanted to use the classic TR1-TR3 animations: you would add 8 bringing your total OCB to 13.

Ropes #

  • OCB 0: Straight when triggered.
  • OCB -1: Coiled and folds out when triggered.

Waterfall Mist #

  • OCB xx yy where xxin width, and yyis sprite size.

Traps #

Bomb #

  • Add 0-99 to OCB for delay (quarter seconds)
  • Add 10000 to OCB for green explosion ( 0 or 1)
  • Add 100-900 to OCB for size (1-9)
  • Add 1000 to OCB for blast wave ( 0 or 1)

Crumbling Platform #

  • OCB = 0: Default behaviour. The platform will start to shake when Lara steps on and will crumble for 1.2 seconds (35 frames) and then fall.
  • OCB = crumble length (in frames):  The platform will start to shake when Lara steps and will crumble during the number of frames indicated in the OCB.
  • A positive number will crumble automatically
  • A negative number will require a trigger.

Dart #

Can be freely rotated and positioned in Tomb Editor. Now uses a 3D mesh for the dart instead of a sprite and fires towards the pointed end of the nullmesh.

  • OCB 0: Does damage only.
  • OCB -1: Does damage and poisons Lara.

Flame Emitter 1 #

Whilst this is now more flexible to code via Lua: these OCBs are also useful for quick effects. Information taken from this post

Flame Emitter 2 #

  • OCB 1: Small flame (does not burn Lara)
  • OCB 2: Small flame moving slowly along the floor in the direction of the cone and will go up and down slopes. On contact with water, the flame will produce a bright flash and extinguish.
  • OCB 4: tiny flame (perfect for candles)
  • OCB 123: small flame in the centre of the tile

Flame Emitter 3 #

  • OCB 1: small blue electric arc.
  • OCB 2: blue electric arc from point of the cone.
  • OCB 3: large electric arc projecting holograph
  • OCB 888: Big ball of lightning that follows Lara

Hammer #

  • OCB 0: It does not animate but will cause Lara damage if collided.
  • OCB 2: Hardcoded Obelisk set up.
  • OCB 3: Triggers once, then raises up and stays there.
  • OCB 4: Works like OCB 3 but will not stop. So once triggered will continuously raise, smackdown, raise up and then loop every two seconds.

Laser Barrier #

The colour of the laser is chosen in Tomb Editor by changing the object tint. The room height decides laser height.

  • OCB value indicates how wide the laser will be. Ie: OCB 7 will mean it will be 7 sectors across.
  • Negative OCB: triggers heavy trigger and can be crossed without causing damage to the player
  • Positive OCB: Fatal to the player if crossed.

Rollingball #

  • OCB 1: Rollingball silent mode: No camera shake or sound.

Spiky Ceiling #

Can be any size or shape.

  • OCB = speed.
  • Negative OCB: travels up.
  • Positive OCB: travels down.
  • The speed can also be changed via Lua:

Spiky Wall #

  • OCB number = speed
  • positive OCB : travels along the positive X axis.
  • Negative OCB – travels along the negative X axis.

Teeth Spikes #

  • Can be freely rotated inside Tomb Editor.
  • OCB 0: Ordinary TR4 teeth spikes behaviour
  • OCB 1: Spikes stuck out constantly
  • OCB 2: Stick out once and retract forever
  • OCB 3: OCB specifies spikes retraction delay in frames, i.e. OCB 30 = spikes will delay for 1 second, OCB 60 = 2 seconds, etc
  • Damage from teeth spikes is now dependent on the object’s collision.

Wrath Trap #

New object in place of the hardcoded Animating from TR4. Used to trap the Wraith entity.

  • OCB 0: Original TR4 effect
  • OCB 1: Enhanced effect where the wraith is pulled into the trap

Vehicles #

Jeep #

  • The vehicle no longer requires a key to operate and can be used like any other vehicle.
  • Improved handling and collision handling.
  • It can be driven into 2-click deep water. Previously was 1 click.
  • New graphic elements were added for water wakes and ripples if driven in shallow water.

Kayak #

  • If you wish to create a drowning effect as seen in Tomb Raider III, you need to assign a “water” footstep sound to the texture and attach a death flag to the specific sectors where you want Lara to drown. To gain more insight on this process, refer to this tutorial available HERE.
  • New graphic elements were added for water wakes and ripples.

Minecart #

  • The animating object used as the switch has been replaced with a dedicated Minecart_Switch object. To use this: place a HEAVY trigger underneath the switch and it will trigger this when it is hit with the wrench if Lara is riding in the minecart.
  • New graphic elements were added for water wakes and ripples if rode through shallow water.
  • New spark effects are added when braking harshly.

Motorbike #

  • Improved dynamic light on the front of the bike.
  • Improved handling and collision handling.
  • Does not currently support the nitrogen dioxide boost.

Speedboat & Rubberboat #

  • New graphic elements were added for water wakes and ripple on the top of the water’s surface.

Underwater Propulsion Vehicle (UPV) #

  • Restored dynamic light.
  • Bubble effects when in use.
  • Can fire harpoons as shown in Tomb Raider III.
  • Improved handling and unified controls.