LBA1:Life script: Difference between revisions

From LBA File Information
Jump to navigation Jump to search
[checked revision][checked revision]
← Older editNewer edit →
Content deleted Content added
No edit summary
No edit summary
Line 1: Line 1:
Life Script is much more sophisticated and powerful than [[LBA1:Track script|Track Script]], though not as advanced as today's programming languages. Life Script is the Main script that controls Actor behaviour.
Life Script is much more sophisticated and powerful than [[LBA1:Track script|Track Script]], though not as advanced as today's programming languages. Life Script is the Main script that controls Actor behaviour.


Life Script is divided into so-called Comportements. Comportements are separated blocks of code, one of which is constantly executed in a loop. At any time one of the Comportements is executing (unless the Script has been stopped), and when the execution gets to its end (END_COMPORTEMENT statement), it is looped back to the beginning (or to another comportement's beginning, if SET_COMPORTEMENT(_OBJ) has been called), and so on. Execution can be moved to another Comportement with the SET_COMPORTEMENT(_OBJ) statement, but the move occurs only at the end of the current comportement (or at the next RETURN command). Life Scripts of all Actors are run simultaneously.
Life Script is divided into so-called Comportments. Comportments are separated blocks of code, one of which is constantly executed in a loop. At any time one of the Comportments is executing (unless the Script has been stopped), and when the execution gets to its end (END_COMPORTMENT statement), it is looped back to the beginning (or to another comportment's beginning, if SET_COMPORTMENT(_OBJ) has been called), and so on. Execution can be moved to another Comportment with the SET_COMPORTMENT(_OBJ) statement, but the move occurs only at the end of the current comportment (or at the next RETURN command). Life Scripts of all Actors are run simultaneously.


Initially the first Comportement of Life Script is executed. Usually the Actor initial behaviour is set here, and then the execution is moved to another Comportement which perform interactions with other Actors and the Hero.
Initially the first Comportment of Life Script is executed. Usually the Actor initial behaviour is set here, and then the execution is moved to another Comportment which perform interactions with other Actors and the Hero.


Each command code is one byte long, and after it there are parameters (or not), or other things. After command's parameters there is a next command byte, and so on. At the end of the script there is a 0x00 (END) command.
Each command code is one byte long, and after it there are parameters (or not), or other things. After command's parameters there is a next command byte, and so on. At the end of the script there is a 0x00 (END) command.
Line 30: Line 30:
|0x04||4||NEVERIF (IF-type)||negated ONEIF (internal use only)||
|0x04||4||NEVERIF (IF-type)||negated ONEIF (internal use only)||
|-
|-
|0x05||5||''unused''|| ||
|0x05||5|| ||''unused''||
|-
|-
|0x06||6||NO_IF (IF-type)||negated IF (probably not used)||
|0x06||6||NO_IF (IF-type)||negated IF (probably not used)||
|-
|-
|0x07||7||''unused''|| ||
|0x07||7|| ||''unused''||
|-
|-
|0x08||8||''unused''|| ||
|0x08||8|| ||''unused''||
|-
|-
|0x09||9||''unused''|| ||
|0x09||9|| ||''unused''||
|-
|-
|0x0A||10||LABEL||Marks point in the script (never used)||param1: 1 byte (0..255) - ID of the label
|0x0A||10||LABEL||Marks point in the script (never used)||param1: 1 byte (0..255) - ID of the label
|-
|-
|0x0B||11||RETURN||returns to the beginning of current comportement||
|0x0B||11||RETURN||returns to the beginning of current comportment||
|-
|-
|0x0C||12||IF (IF-type)||Tests if condition is true||
|0x0C||12||IF (IF-type)||Tests if condition is true||
Line 66: Line 66:
* param2: 1 byte (0..255) - virtual index of the new Animation
* param2: 1 byte (0..255) - virtual index of the new Animation
|-
|-
|0x15||21||SET_LIFE||Same as SET_COMPORTEMENT (never used)||param1: 2 bytes (0..65535) - address (offset) of the target COMPORTEMENT
|0x15||21||SET_LIFE||Same as SET_COMPORTMENT (never used)||param1: 2 bytes (0..65535) - address (offset) of the target COMPORTMENT
|-
|-
|0x16||22||SET_LIFE_OBJ||Same as SET_COMPORTEMENT_OBJ (never used)||
|0x16||22||SET_LIFE_OBJ||Same as SET_COMPORTMENT_OBJ (never used)||
* param1: 1 byte (0..255) - index of the target Actor
* param1: 1 byte (0..255) - index of the target Actor
* param2: 2 bytes (0..65535) - address (offset) of the target COMPORTEMENT
* param2: 2 bytes (0..65535) - address (offset) of the target COMPORTMENT
|-
|-
|0x17||23||SET_TRACK||Starts execution of the Actor's [[LBA1:Track script|Track Script]]||param1: 2 bytes (-1..32767) - address (offset) in the Track Script; -1 causes stop of execution of the script
|0x17||23||SET_TRACK||Starts execution of the Actor's [[LBA1:Track script|Track Script]]||param1: 2 bytes (-1..32767) - address (offset) in the Track Script; -1 causes stop of execution of the script
Line 90: Line 90:
* param2: 1 byte (0..7) - index of the new mode
* param2: 1 byte (0..7) - index of the new mode
* param3: 1 byte (0..255) - index of the Actor to follow (only if the mode is 2 (follow) or 4 (follow_2))
* param3: 1 byte (0..255) - index of the Actor to follow (only if the mode is 2 (follow) or 4 (follow_2))
|-
|-
|0x1D||29||CAM_FOLLOW||Sets the camera to follow specified Actor||param1: 1 byte (0..255) - index of the Actor

|-
0x1D ( 29) CAM_FOLLOW
param1: 1 byte unsigned (0..255) - ID of the actor to be followed by the camera
|0x1E||30||SET_BEHAVIOUR||Sets hero's behaviour||param1: 1 byte (0..4) - behaviour ID (0 = normal, 1 = athletic, 2 = aggressive, 3 = discrete, 4 = proto-pack)
|-

|0x1F||31||SET_FLAG_CUBE||Sets cube (local) flag||
0x1E ( 30) SET_BEHAVIOUR
param1: 1 byte unsigned (0..4) - ID of the behaviour to set (0 = normal, 1 = athletic, 2 = aggressive, 3 = discrete, 4 = proto-pack)
* param1: 1 byte (0..255) - index of the Cube Flag
* param2: 1 byte (0..255) - new value

|-
0x1F ( 31) SET_FLAG_CUBE
param1: 1 byte unsigned (0..255) - ID of the Cube Flag to set
|0x20||32||COMPORTMENT (virtual)||Marks beginning of the comportment block||param1: 1 byte (0..255) - probably ID of the comportment
|-
param2: 1 byte unsigned (0..255) - new value of the Flag to be set to
|0x21||33||SET_COMPORTMENT||Sets next comportment||param1: 2 bytes (0..65535) - address (offset) of the new comportment

|-
0x20 ( 32) COMPORTEMENT (virtual)
|0x22||34||SET_COMPORTMENT_OBJ||Sets next comportment for another Actor||
param1: 1 byte (unsigned?) (0..255) - probably ID of the comportement
* param1: 1 byte (0..255) - ID of the target Actor

* param2: 2 bytes (0..65535) - address (offset) of the new comportment
0x21 ( 33) SET_COMPORTEMENT
|-
param1: 2 bytes (unsigned?) (0..65535) - address (offset) of the target comportement
|0x23||35||END_COMPORTMENT||Marks end of comportment||

|-
0x22 ( 34) SET_COMPORTEMENT_OBJ
|0x24||36||SET_FLAG_GAME||Sets game (global) flag||
param1: 1 byte unsigned (0..255) - ID of the target Actor
* param1: 1 byte (0..255) - index of the Game Flag
param2: 2 bytes (unsigned?) (0..65535) - address (offset) of the target comportement in the target Actor's Life Script
* param2: 1 byte (0..255) - new value

|-
0x23 ( 35) END_COMPORTEMENT
|0x25||37||KILL_OBJ||Deletes an Actor and stops its scripts||param1: 1 byte (0..255) - ID of the Actor
[no params]
|-

|0x26||38||SUICIDE||Deletes the Actor and stops its scripts||
0x24 ( 36) SET_FLAG_GAME
|-
param1: 1 byte unsigned (0..255) - ID of the Game Flag to set
|0x27||39||USE_ONE_LITTLE_KEY||Removes one little key from hero's pocket||
param2: 1 byte unsigned (0..255) - new value of the Flag to be set to
|-

|0x28||40||GIVE_GOLD_PIECES||removes an amount of money from hero's pocket||param1: 2 bytes (0..999) - amount of money
0x25 ( 37) KILL_OBJ
|-
param1: 1 byte unsigned (0..255) - ID of the Actor to be killed
|0x29||41||END_LIFE||Stops executing the Actor's Life Script||

|-
0x26 ( 38) SUICIDE
|0x2A||42||STOP_CURRENT_TRACK||Pauses Actor's Track Script||
[no params]
|-

|0x2B||43||RESTORE_LAST_TRACK||Resumes Actor's Track Script||
0x27 ( 39) USE_ONE_LITTLE_KEY
|-
[no params]
|0x2C||44||MESSAGE_OBJ||Displays dialogue text said by another Actor||

* param1: 1 byte (0..255) - index of the target Actor
0x28 ( 40) GIVE_GOLD_PIECES
param1: 2 bytes (unsigned?) (0..65535) - number of gold pieces to be given
* param2: 2 bytes (0..65535) - virtual index of the text entry
|-

|0x2D||45||INC_CHAPTER||Increases CHAPTER variable by one||
0x29 ( 41) END_LIFE
|-
[no params]
|0x2E||46||FOUND_OBJECT||Displays ''object found'' message||param1: 1 byte (0..255) - index of the inventory item

|-
0x2A ( 42) STOP_L_TRACK
|0x2F||47||SET_DOOR_LEFT||Sets door position to the far-left||param1: 2 bytes (-32768..32767) - distance
[no params]
|-

|0x30||48||SET_DOOR_RIGHT||Sets door position to the near-right||param1: 2 bytes (-32768..32767) - distance
0x2B ( 43) RESTORE_L_TRACK
|-
[no params]
|0x31||49||SET_DOOR_UP||Sets door position to the far-right||param1: 2 bytes (-32768..32767) - distance

|-
0x2C ( 44) MESSAGE_OBJ
|0x32||50||SET_DOOR_DOWN||Sets door position to the near-left||param1: 2 bytes (-32768..32767) - distance
param1: 1 byte unsigned (0..255) - ID of the target Actor
|-
param2: 2 bytes (unsigned?) (0..65535) - ID of the text entry to be displayed
|0x33||51||GIVE_BONUS||Pops bonus from the Actor||param1: 1 byte (0..1) - (boolean) if bonus popping should be disabled on the Actor's death

|-
0x2D ( 45) INC_CHAPTER
|0x34||52||CHANGE_CUBE||Changes the Scene||param1: 1 byte (0..255) - index of the target Scene
[no params]
|-

|0x35||53||OBJ_COL||Controls the Actor's collisions with other Actors||param1: 1 byte (0..1) - (boolean) 1 = Actor collides with other Actors
0x2E ( 46) FOUND_OBJECT
|-
param1: 1 byte unsigned (0..255) - ID of the inventory object to be displayed
|0x36||54||BRICK_COL||Controls the Actor's collisions with Bricks (terrain)||param1: 1 byte (0..2) - 1 = Actor collides with Bricks, 2 = unknown

|-
0x2F ( 47) SET_DOOR_LEFT
|0x37||55||OR_IF (IF-type)||Tests if condition is true||
param1: 2 bytes (signed?) (-32768..32767) - distance to move
|-

|0x38||56||INVISIBLE||Controls visibility of the Actor||param1: 1 byte (0..1) - (boolean) 0 = Actor is visible, 1 = Actor is not visible
0x30 ( 48) SET_DOOR_RIGHT
|-
param1: 2 bytes (signed?) (-32768..32767) - distance to move
|0x39||57||ZOOM||Controls the camera zoom||param1: 1 byte unsigned (0..1) - (boolean) 1 = enable zoom, 0 = disable zoom

|-
0x31 ( 49) SET_DOOR_UP
|0x3A||58||POS_POINT||Immediately moves the Actor to the Point||param1: 1 byte (0..255) - index of the Point
param1: 2 bytes (signed?) (-32768..32767) - distance to move
|-

|0x3B||59||SET_MAGIC_LEVEL||Sets the hero's magic level||param1: 1 byte (0..4) - target magic level
0x32 ( 50) SET_DOOR_DOWN
|-
param1: 2 bytes (signed?) (-32768..32767) - distance to move
|0x3C||60||SUB_MAGIC_POINT||Subtracts from hero's magic points||param1: 1 byte (0..255) - amount of magic points to be subtracted

|-
0x33 ( 51) GIVE_BONUS
|0x3D||61||SET_LIFE_POINT_OBJ||Sets life points for an Actor||
param1: 1 byte (unsigned?) (0..255) - ???
* param1: 1 byte (0..255) - index of the target Actor

* param2: 1 byte (0..255) - amount of life points
0x34 ( 52) CHANGE_CUBE
|-
param1: 1 byte unsigned (0..255) - ID of the target Scene

0x35 ( 53) OBJ_COL
param1: 1 byte unsigned (0..1) - (boolean) 1 = Actor can collide with objects (other Actors)

0x36 ( 54) BRICK_COL
param1: 1 byte unsigned (0..2) - (boolean???) 1 = Actor can collide with bricks, 2 = ???

0x37 ( 55) OR_IF (IF type)
[no params]

0x38 ( 56) INVISIBLE
param1: 1 byte unsgined (0..1) - (boolean) 0 = Actor will be visible, 1 = Actor will be invisible

0x39 ( 57) ZOOM
param1: 1 byte unsigned (0..1) - (boolean) 1 = enable zoomed mode, 0 = disable zoomed mode

0x3A ( 58) POS_POINT
param1: 1 byte unsigned (0..255) - ID of the Track to move the Actor to

0x3B ( 59) SET_MAGIC_LEVEL
param1: 1 byte unsigned (0..4) - new magic level for the Actor

0x3C ( 60) SUB_MAGIC_POINT
param1: 1 byte (unsigned?) (0..255) - amount of magic points to be subtracted

0x3D ( 61) SET_LIFE_POINT_OBJ
param1: 1 byte unsigned (0..255) - ID of the target Actor
param2: 1 byte (unsigned?) (0..255) - amount of life points to be set for the target Actor


0x3E ( 62) SUB_LIFE_POINT_OBJ
0x3E ( 62) SUB_LIFE_POINT_OBJ

Revision as of 08:59, 20 May 2013

Life Script is much more sophisticated and powerful than Track Script, though not as advanced as today's programming languages. Life Script is the Main script that controls Actor behaviour.

Life Script is divided into so-called Comportments. Comportments are separated blocks of code, one of which is constantly executed in a loop. At any time one of the Comportments is executing (unless the Script has been stopped), and when the execution gets to its end (END_COMPORTMENT statement), it is looped back to the beginning (or to another comportment's beginning, if SET_COMPORTMENT(_OBJ) has been called), and so on. Execution can be moved to another Comportment with the SET_COMPORTMENT(_OBJ) statement, but the move occurs only at the end of the current comportment (or at the next RETURN command). Life Scripts of all Actors are run simultaneously.

Initially the first Comportment of Life Script is executed. Usually the Actor initial behaviour is set here, and then the execution is moved to another Comportment which perform interactions with other Actors and the Hero.

Each command code is one byte long, and after it there are parameters (or not), or other things. After command's parameters there is a next command byte, and so on. At the end of the script there is a 0x00 (END) command.

This document describes the commands and their parameters in a technical way. For more details on usage and effects see other sources (LBArchitect's help may contain some).

If the command does not have any additional bytes, next command starts immediately after the command byte.

Life Script commands are non-blocking, which means that each command executes immediately after previous one (there are no WAIT_ commands) and the whole script runs very fast. Special techniques must be used if a wait is necessary.

Some commands in the Life Script are virtual - this means that the command is present in decompiled script (text form), and does not serve any purpose in compiled (binary) form of the script, so it may or may not be there. Virtual commands still have opcodes associated to them.

Command macros

0x3E ( 62) SUB_LIFE_POINT_OBJ param1: 1 byte unsigned (0..255) - ID of the target Actor param2: 1 byte (unsigned?) (0..255) - amount of life points to be subtracted from the target Actor's life points 0x3F ( 63) HIT_OBJ param1: 1 byte unsigned (0..255) - ID of the target Actor param2: 1 byte (unsigned?) (0..255) - ??? (damage amount maybe?) 0x40 ( 64) PLAY_FLA param1: null-terminated string - name of the fla file to play (file extension is allowed but not required) 0x41 ( 65) PLAY_MIDI param1: 1 byte (unsigned?) (0..255) - ID of the MIDI track to be played 0x42 ( 66) INC_CLOVER_BOX [no params] 0x43 ( 67) SET_USED_INVENTORY param1: 1 byte (unsigned?) (0..255) - ID of the inventory item to be set as used 0x44 ( 68) ADD_CHOICE param1: 2 bytes (unsigned?) (0..65535) - ID of the text entry to be added as the choice 0x45 ( 69) ASK_CHOICE param1: 2 bytes (unsigned?) (0..65535) - ID of the text entry to be displayed as the choice question 0x46 ( 70) BIG_MESSAGE param1: 2 bytes (unsigned?) (0..65535) - ID of the text entry to be displayed 0x47 ( 71) INIT_PINGOUIN param1: 1 byte (unsigned?) (0..255) - probably ID of the Actor to init as pingouin 0x48 ( 72) SET_HOLO_POS param1: 1 byte (unsigned?) (0..255) - ID of the holomap position to be set 0x49 ( 73) CLR_HOLO_POS param1: 1 byte (unsigned?) (0..255) - ID of the holomap position to be cleared 0x4A ( 74) ADD_FUEL param1: 1 byte (unsigned?) (0..255) - amount of fuel units to be added to the player's inventory 0x4B ( 75) SUB_FUEL param1: 1 byte (unsigned?) (0..255) - amount of fuel units to be subtracted from the player's inventory 0x4C ( 76) SET_GRM param1: 1 byte unsigned (0..255) - ID of the Grid to be (merged with the current Grid?) 0x4D ( 77) SAY_MESSAGE param1: 2 bytes (unsigned?) (0..65535) - ID of the text entry to be displayed 0x4E ( 78) SAY_MESSAGE_OBJ param1: 1 byte unsigned (0..255) - ID of the target Actor param2: 2 bytes (unsigned?) (0..65535) - ID of the text entry to be displayed 0x4F ( 79) FULL_POINT [no params] 0x50 ( 80) BETA param1: 2 bytes (signed?) (-32768..32767) - the new angle 0x51 ( 81) GRM_OFF [no params] 0x52 ( 82) FADE_PAL_RED [no params] 0x53 ( 83) FADE_ALARM_RED [no params] 0x54 ( 84) FADE_ALARM_PAL [no params] 0x55 ( 85) FADE_RED_PAL [no params] 0x56 ( 86) FADE_RED_ALARM [no params] 0x57 ( 87) FADE_PAL_ALARM [no params] 0x58 ( 88) EXPLODE_OBJ param1: 1 byte unsigned (0..255) - ID of the target Actor 0x59 ( 89) BUBBLE_ON [no params] 0x5A ( 90) BUBBLE_OFF [no params] 0x5B ( 91) ASK_CHOICE_OBJ param1: 1 byte unsigned (0..255) - ID of the target Actor param2: 2 bytes (unsigned?) (0..65535) - ID of the text entry to be displayed as the choice question 0x5C ( 92) SET_DARK_PAL [no params] 0x5D ( 93) SET_NORMAL_PAL [no params] 0x5E ( 94) MESSAGE_SENDELL [no params] 0x5F ( 95) ANIM_SET param1: 1 byte (unsigned?) (0..255) - ID of the animation to be set ??? 0x60 ( 96) HOLOMAP_TRAJ param1: 1 byte (unsigned?) (0..255) - ID of the holomap trajectory to be displayed 0x61 ( 97) GAME_OVER [no params] 0x62 ( 98) THE_END [no params] 0x63 ( 99) MIDI_OFF [no params] 0x64 (100) PLAY_CD_TRACK param1: 1 byte (unsigned?) (0..255) - ID of the CD track to be played 0x65 (101) PROJ_ISO [no params] 0x66 (102) PROJ_3D [no params] 0x67 (103) TEXT param1: 2 bytes (unsigned?) (0..65535) - ID of the text entry to be displayed 0x68 (104) CLEAR_TEXT [no params] 0x69 (105) BRUTAL_EXIT [no params]
========================
LIFE SCRIPT CONDITIONS (VARIABLES)
========================

Conditions have opcodes and parameters, like regular commands, but they occur only after IF-type commands. The conditional construction is following:

In case the condition doesn't have any parameters: 

  byte: |     1     |      2      |     3     |        4         |  5 & 6

Command: | IF-type | Condition | Operator | value to compare | address

Example: | 0x0C (IF) | 0x03 (ZONE) | 0x00 (==) | 0x03 | 0x002D

The bytes 5 and 6 are the address (offset) to jump to when the condition result is false (if it is true, the execution will continue to the lines following the conditional construction (no jump)).

In case the condition has a parameter: 

  byte: |     1     |        2        |     3     |     4     |        5         |  6 & 7

Command: | IF-type | Condition | parameter | Operator | value to compare | address

Example: | 0x0C (IF) | 0x04 (ZONE_OBJ) | 0x04 | 0x00 (==) | 0x03 | 0x002D

OR_IF - special case: OR_IF can be used to execute a block of code if at least one of the conditions is met, its syntax is following:

OR_IF ANIM == 1 OR_IF ANIM == 3 IF ANIM == 6 ...code... ENDIF

All the OR_IF lines must precede the IF line. Their compiled syntax is following: 

  byte: |     1     |      2      |     3     |        4         |  5 & 6

Command: | OR_IF | Condition | Operator | value to compare | address

Example: | 0x37 | 0x03 (ZONE) | 0x00 (==) | 0x03 | 0x002D

The syntax is the same as regular IF statement, but this time the addres bytes (5 and 6) contain an address where to jump when condition is TRUE. In case it is FALSE the execution will continue to the next line (no jump) (another condition should be there).


Each condition has a specified range of values it can be compared with. For example COL can be compared to 1-byte values only. One can imagine the comparison values as "function return" values, but it doesn't exactly work this way. For example ZONE conditional will be always false if the Actor is not inside any Zone, no matter what value to compare is in the statement.


0x00 ( 0) COL 

         [no params]
         compare value: 1 byte unsigned (0..255) - ID of the Actor to test collision with

0x01 ( 1) COL_OBJ 

         param1: 1 byte unsigned (0..255) - ID of the target Actor
         compare value: 1 byte unsigned (0..255) - ID of the Actor to test collision with the target Actor

0x02 ( 2) DISTANCE 

         param1: 1 byte unsigned (0..255) - ID of the target Actor
         compare value: 2 bytes (unsigned?) (0..32000) - distance to the target Actor in Scene units

0x03 ( 3) ZONE 

         [no params]
         compare value: 1 byte unsigned (0..255) - ID of the Zone to test if the current Actor is inside

0x04 ( 4) ZONE_OBJ 

         param1: 1 byte unsigned (0..255) - ID of the target Actor
         compare value: 1 byte unsigned (0..255) - ID of the Zone to test if the tested Actor is inside

0x05 ( 5) BODY 

         [no params]
         compare value: 1 byte unsigned (0..255) - ID of the body to test if it's set for the current Actor

0x06 ( 6) BODY_OBJ 

         param1: 1 byte unsigned (0..255) - ID of the target Actor
         compare value: 1 byte unsigned (0..255) - ID of the body to test if it's set for the target Actor

0x07 ( 7) ANIM 

         [no params]
         compare value: 1 byte unsigned (0..255) - ID of the animation to test if it's set for the current Actor

0x08 ( 8) ANIM_OBJ 

         param1: 1 byte unsigned (0..255) - ID of the target Actor
         compare value: 1 byte unsigned (0..255) - ID of the animation to test if it's set for the target Actor

0x09 ( 9) L_TRACK 

         [no params]
         compare value: 1 byte unsigned (0..255) - ID of the Track Script LABEL to test if it's set for the current Actor

0x0A (10) L_TRACK_OBJ 

         param1: 1 byte unsigned (0..255) - ID of the target Actor
         compare value: 1 byte unsigned (0..255) - ID of the Track Script LABEL to test if it's set for the target Actor

0x0B (11) FLAG_CUBE 

         param1: 1 byte unsigned (0..255) - ID of the Cube Flag to test
         compare value: 1 byte unsigned (0..255) - value of the Cube Flag to test

0x0C (12) CONE_VIEW 

         param1: 1 byte unsigned (0..255) - ID of the target Actor
         compare value: 2 bytes (unsigned?) (0..32000) - distance to the targer Actor in Scene units

0x0D (13) HIT_BY 

         [no params]
         compare value: 1 byte unsigned (0..255) - ID of the Actor to test if it has hit the current Actor

0x0E (14) ACTION 

         [no params]
         compare value: 1 byte unsigned (0..1) - (boolean) 1 = player is pressing "Action" command

0x0F (15) FLAG_GAME 

         param1: 1 byte unsigned (0..255) - ID of the Game Flag to test
         compare value: 1 byte unsigned (0..255) - value of the Game Flag to test

0x10 (16) LIFE_POINT 

         [no params]
         compare value: 1 byte (unsigned?) (0..255) - amount of life points to compare the current Actor's amount of life points with

0x11 (17) LIFE_POINT_OBJ 

         param1: 1 byte unsigned (0..255) - ID of the target Actor
         compare value: 1 byte (unsigned?) (0..255) - amount of life points to compare the target Actor's amount of life points with

0x12 (18) NUM_LITTLE_KEYS 

         [no params]
         compare value: 1 byte (unsigned?) (0..255) - amount of little keys to compare the Hero's amount of little keys with

0x13 (19) NUM_GOLD_PIECES 

         [no params]
         compare value: 2 bytes (unsigned?) (0..65535) - amount of gold to compare the Hero's amount of gold with

0x14 (20) BEHAVIOUR 

         [no params]
         compare value: 1 byte unsigned (0..4) - ID of the behaviour to test for the Hero (0 = normal, 1 = athletic, 2 = aggressive, 3 = discrete, 4 = proto-pack)

0x15 (21) CHAPTER 

         [no params]
         compare value: 1 byte unsigned (0..255) - value of the Chapter variable to test

0x16 (22) DISTANCE_3D 

         param1: 1 byte unsigned (0..255) - ID of the target Actor
         compare value: 2 bytes (unsigned?) (0..65535) - distance to the target Actor in Scene units

0x17 (23) (unused)

0x18 (24) (unused)

0x19 (25) USE_INVENTORY 

         param1: 1 byte unsigned (0..255) - ID of the (inventory item to test?)
         compare value: 1 byte unsigned (0..255) - ???

0x1A (26) CHOICE 

         [no params]
         compare value: 2 bytes (unsigned?) (0..65535) - ID of the text to check if it has been chosen

0x1B (27) FUEL 

         [no params]
         compare value: 1 byte unsigned (0..255) - amount of fuel to test

0x1C (28) CARRIED_BY 

         [no params]
         compare value: 1 byte unsigned (0..255) - ID of the Actor to test if the current Actor is being carried by it

0x1D (29) CDROM 

         [no params]
         compare value: 1 byte (unsigned?) (0..255) - ???


===================
LIFE SCRIPT OPERATORS
===================

0x00 (0) == - tests if the Condition value is equal to the given value to compare

0x01 (1) > - tests if the Condition value is larger than given value to compare

0x02 (2) < - tests if the Condition value is less than given value to compare

0x03 (3) >= - tests if the Condition value is larger or equal than given value to compare

0x04 (4) <= - tests if the Condition value is less or equal than given value to compare

0x05 (5) != - tests if the Condition value is not equal to given value to compare

Code (dec) Name Description Parameters
0x00 0 END Marks end of the script
0x01 1 NOP No operation (never used)
0x02 2 SNIF (IF-type) negated SWIF (internal use only)
0x03 3 OFFSET jumps to specified offset (never used) param1: 2 bytes (0..65535) - address (offset) in the script
0x04 4 NEVERIF (IF-type) negated ONEIF (internal use only)
0x05 5 unused
0x06 6 NO_IF (IF-type) negated IF (probably not used)
0x07 7 unused
0x08 8 unused
0x09 9 unused
0x0A 10 LABEL Marks point in the script (never used) param1: 1 byte (0..255) - ID of the label
0x0B 11 RETURN returns to the beginning of current comportment
0x0C 12 IF (IF-type) Tests if condition is true
0x0D 13 SWIF (IF-type) Tests if condition is true and alternating
0x0E 14 ONEIF (IF-type) Tests if condition is true once
0x0F 15 ELSE Jumps to specified address (skips the next block) param1: 2 bytes (0..65535) - address (offset) to go to
0x10 16 ENDIF (virtual) Marks end of IF-type block
0x11 17 BODY Selects a new Body for the Actor param1: 1 byte (0..255) - virtual index of the new Body
0x12 18 BODY_OBJ Selects a new Body for another Actor
  • param1: 1 byte (0..255) - index of the target Actor
  • param2: 1 byte (0..255) - virtual index of the new Body
0x13 19 ANIM Selects a new Animation for the Actor param1: 1 byte (0..255) - virtual index of the new Animation
0x14 20 ANIM_OBJ Selects a new Animation for another Actor
  • param1: 1 byte (0..255) - index of the target Actor
  • param2: 1 byte (0..255) - virtual index of the new Animation
0x15 21 SET_LIFE Same as SET_COMPORTMENT (never used) param1: 2 bytes (0..65535) - address (offset) of the target COMPORTMENT
0x16 22 SET_LIFE_OBJ Same as SET_COMPORTMENT_OBJ (never used)
  • param1: 1 byte (0..255) - index of the target Actor
  • param2: 2 bytes (0..65535) - address (offset) of the target COMPORTMENT
0x17 23 SET_TRACK Starts execution of the Actor's Track Script param1: 2 bytes (-1..32767) - address (offset) in the Track Script; -1 causes stop of execution of the script
0x18 24 SET_TRACK_OBJ Starts execution of another Actor's Track Script
  • param1: 1 byte (0..255) - index of the target Actor
  • param2: 2 bytes (-1..32767) - address (offset) in the target Actor's Track Script;. -1 causes stop of execution of the script
0x19 25 MESSAGE Displays dialogue text and plays associated speech sound param1: 2 bytes (0..32767) - virtual index of the text entry to be displayed
0x1A 26 FALLABLE Controls gravity for the Actor param1: 1 byte (0..1) - (boolean flag) 1 = Actor can fall, 0 = it cannot
0x1B 27 SET_DIRMODE Controls direction mode of the Actor
  • param1: 1 byte (0..7) - index of the new mode
  • param2: 1 byte (0..255) - index of the Actor to follow (only if the mode is 2 (follow) or 4 (follow_2))
0x1C 28 SET_DIRMODE_OBJ Controls direction mode of another Actor
  • param1: 1 byte (0..255) - index of the target Actor
  • param2: 1 byte (0..7) - index of the new mode
  • param3: 1 byte (0..255) - index of the Actor to follow (only if the mode is 2 (follow) or 4 (follow_2))
0x1D 29 CAM_FOLLOW Sets the camera to follow specified Actor param1: 1 byte (0..255) - index of the Actor
0x1E 30 SET_BEHAVIOUR Sets hero's behaviour param1: 1 byte (0..4) - behaviour ID (0 = normal, 1 = athletic, 2 = aggressive, 3 = discrete, 4 = proto-pack)
0x1F 31 SET_FLAG_CUBE Sets cube (local) flag
  • param1: 1 byte (0..255) - index of the Cube Flag
  • param2: 1 byte (0..255) - new value
0x20 32 COMPORTMENT (virtual) Marks beginning of the comportment block param1: 1 byte (0..255) - probably ID of the comportment
0x21 33 SET_COMPORTMENT Sets next comportment param1: 2 bytes (0..65535) - address (offset) of the new comportment
0x22 34 SET_COMPORTMENT_OBJ Sets next comportment for another Actor
  • param1: 1 byte (0..255) - ID of the target Actor
  • param2: 2 bytes (0..65535) - address (offset) of the new comportment
0x23 35 END_COMPORTMENT Marks end of comportment
0x24 36 SET_FLAG_GAME Sets game (global) flag
  • param1: 1 byte (0..255) - index of the Game Flag
  • param2: 1 byte (0..255) - new value
0x25 37 KILL_OBJ Deletes an Actor and stops its scripts param1: 1 byte (0..255) - ID of the Actor
0x26 38 SUICIDE Deletes the Actor and stops its scripts
0x27 39 USE_ONE_LITTLE_KEY Removes one little key from hero's pocket
0x28 40 GIVE_GOLD_PIECES removes an amount of money from hero's pocket param1: 2 bytes (0..999) - amount of money
0x29 41 END_LIFE Stops executing the Actor's Life Script
0x2A 42 STOP_CURRENT_TRACK Pauses Actor's Track Script
0x2B 43 RESTORE_LAST_TRACK Resumes Actor's Track Script
0x2C 44 MESSAGE_OBJ Displays dialogue text said by another Actor
  • param1: 1 byte (0..255) - index of the target Actor
  • param2: 2 bytes (0..65535) - virtual index of the text entry
0x2D 45 INC_CHAPTER Increases CHAPTER variable by one
0x2E 46 FOUND_OBJECT Displays object found message param1: 1 byte (0..255) - index of the inventory item
0x2F 47 SET_DOOR_LEFT Sets door position to the far-left param1: 2 bytes (-32768..32767) - distance
0x30 48 SET_DOOR_RIGHT Sets door position to the near-right param1: 2 bytes (-32768..32767) - distance
0x31 49 SET_DOOR_UP Sets door position to the far-right param1: 2 bytes (-32768..32767) - distance
0x32 50 SET_DOOR_DOWN Sets door position to the near-left param1: 2 bytes (-32768..32767) - distance
0x33 51 GIVE_BONUS Pops bonus from the Actor param1: 1 byte (0..1) - (boolean) if bonus popping should be disabled on the Actor's death
0x34 52 CHANGE_CUBE Changes the Scene param1: 1 byte (0..255) - index of the target Scene
0x35 53 OBJ_COL Controls the Actor's collisions with other Actors param1: 1 byte (0..1) - (boolean) 1 = Actor collides with other Actors
0x36 54 BRICK_COL Controls the Actor's collisions with Bricks (terrain) param1: 1 byte (0..2) - 1 = Actor collides with Bricks, 2 = unknown
0x37 55 OR_IF (IF-type) Tests if condition is true
0x38 56 INVISIBLE Controls visibility of the Actor param1: 1 byte (0..1) - (boolean) 0 = Actor is visible, 1 = Actor is not visible
0x39 57 ZOOM Controls the camera zoom param1: 1 byte unsigned (0..1) - (boolean) 1 = enable zoom, 0 = disable zoom
0x3A 58 POS_POINT Immediately moves the Actor to the Point param1: 1 byte (0..255) - index of the Point
0x3B 59 SET_MAGIC_LEVEL Sets the hero's magic level param1: 1 byte (0..4) - target magic level
0x3C 60 SUB_MAGIC_POINT Subtracts from hero's magic points param1: 1 byte (0..255) - amount of magic points to be subtracted
0x3D 61 SET_LIFE_POINT_OBJ Sets life points for an Actor
  • param1: 1 byte (0..255) - index of the target Actor
  • param2: 1 byte (0..255) - amount of life points
Retrieved from "https://lbafileinfo.kaziq.net/index.php?title=LBA1:Life_script&oldid=2013"