[SCRIPT] How to create a User-Input Script?

[TheGreatCthulhu]

I don't think Amnesia exposes any script functions that can query keyboard state (there certainly aren't any on the documentation wiki), but you can use buttons or levers, or even just script areas, and respond when the user interacts with them.

For example, using script areas set over some button-like object:

PHP Code: (Select All)

void OnEnter()
{
    SetEntityPlayerInteractCallback("ScriptArea_1", "OnButtonPress", false);
    SetEntityPlayerInteractCallback("ScriptArea_2", "OnButtonPress", false);
}

void OnButtonPress(string &in sender)
{   
    // check sender var to determine which script area,
    // then do something
} 


Another example, using levers:

PHP Code: (Select All)

// LEVER STATES: just some constants for the sake of readability 
const int YES = 1;
const int NO = -1;

// note: there's an intermediate state as well (state 0), but it's not used

void OnEnter()
{
    SetEntityConnectionStateChangeCallback("lever_yesno", "OnLeverMoved");
}

void OnLeverMoved(string &in entityID, int state)
{
    if(state == YES)
    {
        // do something
    }
    else if (state == NO)    // have to check, there's an intermediate state as well, but it's not used
    {
        // do something else
    }
}