The OnAction method

In the next two chapters we will look over useful functions that exist in every map script file.

Workflow

This method gets called when a key on the keyboard is pressed. It detects the keyboard input, and it is mostly used for testing parts of our script. It can be very useful to us when we want to test something quickly. Below is the default code in a map script file for OnAction:

 1 ////////////////////////////
 2 // To get when player makes input (mostly used for debug)
 3 void OnAction(int alAction, bool abPressed)
 4 {
 5 	if (abPressed == false)
 6 		return;
 7 
 8 	if (alAction == eAction_Test1)
 9 	{
10 			
11 	}
12 }

The function has two arguments: alAction and abPressed.

Breakdown

• alAction is an integer which represents the key code of the current key has been pressed.
• abPressed is a boolean which checks if the key is currently pressed.
• At the very beginning, the function checks if the current button is pressed or not, because the code needs to be executed only when a key is pressed, so if the key isn’t pressed, we stop the execution of this method, which is achieved by typing return;.
• A condition that checks which key we have pressed. We can search for keys by typing eAction_ and we will see a list of all of the available keys, which is pretty much every key on the keyboard. eAction_Test0 to eAction_Test9 are the number keys on the keyboard, so if we press 0 on our keyboard, the code inside the eAction_Test0 condition will be executed.

You can see a full list of the input types inside the Scripting section of SOMA or Amnesia: Rebirth, under Base -> Input Types.

Example

////////////////////////////
// To get when player makes input (mostly used for debug)
void OnAction(int alAction, bool abPressed)
{
	if (abPressed == false)
		return;

	if (alAction == eAction_Test1)
	{
		Light_SetVisible("PointLight_4", false);
	}
		
	if (alAction == eAction_Test2)
	{
		Light_SetVisible("PointLight_4", true);
	}
}

In this example, if the player presses 1 on the keyboard, the point light PointLight_4 in the map will become invisible. If the player presses 2, the light will become visible again.

---

HPL3 Scripting Guide

← Helper Files

The Update method →