LUA script examples

Adjusting enemy HP

This example sets all bats to start with random amount of hitpoints ranging from 5 to 10, and all wolves to start with 30 hitpoints. Refer to this section as a reference for original values.

-- Adjust HP of certain enemies
trx.events.before_item_setup(function(level)
  -- Randomize bats HP
  for i = 1, #trx.items do
    local item = trx.items[i]
    if item.object_id == trx.catalog.objects.bat then
      item.properties.max_hit_points = math.random(5, 10)
    end
  end

  -- Boost all wolves HP
  trx.objects.wolf.properties.max_hit_points = 30
end)

Teleporting Lara upon picking up a medipack

This will teleport Lara back to the starting point in TR1 Caves. Resetting the camera may be required in some cases.

trx.events.on_pickup(function(pickup_item)
  local lara = trx.lara.item
  lara.pos = {
    x = 73.5 * 1024,
    y = 3 * 1024,
    z = 3.5 * 1024,
  }
  trx.camera.reset()
end)

Running code every control loop

This will run the provided function once every logical frame, meaning the function will always run at 30 FPS regardless of the player's FPS settings.

trx.events.before_control(function()
  -- handle per-frame control logic
end)

Changing water color in concrete rooms

This will change the color to crimson red if Lara is in room 15, and demonstrates how to throttle updates to only happen if Lara goes from one room to another.

local last_room = 0

trx.events.before_control(function()
  local lara = trx.lara.item
  if lara.room_num ~= last_room then
    last_room = lara.room_num
    if lara.room_num == 15 then
      trx.config.set("visuals.water_color", "ff0000")
    else
      trx.config.set("visuals.water_color", "0000ff")
    end
  end
end)