Object Entities

Object

An object or entity, such as an NPC or a prop.

In Postal3Script you always have access to important objects such as a target or yourself, so you can check and do stuff to them.

You don't always have access to the Caller, as it's heavily dependent on the Event that caused the NPC to enter the pattern.

Typically, the caller means something or someone that forced the NPC to enter it.

Syntax

Object:[object] -- Returns the Object specified

Example

// Check if our caller exists (null == zero)
IfAttr "Object:caller != Object:null Block Begin"
    // Was it the Player who forced us into this state?
    IfAttr "Object:caller == Object:player Block Begin"
        // Well then we are going to run to them endlessly
        TargetPlayer 1 // or TargetCaller 1
        MoveToTarget run,1,0
    Block End
Block End

// Check if our target isn't the Player
IfAttr "Object:target != Object:null and Object:target != Object:Player Block Begin"
    // Bad day for our enemy, though, because they are going to die instantly
    ChangeAttr "target.ea_health -target.ea_health"
Block End

// Object:self and Object:item are barely used, the latter is used by Motorhead
// It's a pointer to the NPC's held item
// Check out ai_motorhead.p3s, ai_st1_common.p3s, ai_st2_states.p3s 
// and ai_st7_environment.p3s

Saving Objects To Memory

You are capable of saving an object to memory, with up to 10 slots.

This feature is typically used for keeping track of progress on tasks and related to mission logic.

Example

// (from ai_st_init.p3s)
// Const msTEMP,0
// Const msOWNER,1
// Const msTARGET,2
// Const msENEMY,3
// Const msSUSPECTED,4
// Const msLEADER,5
// Const msDRIVEN,6
// Const msINTEREST,7
// Const msKILLER,8
// Const msGP,9

// Get entity named 'gameplay' and set it as target
TargetEntByName gameplay

// Save the target to memory
TargetToMem msGP

// Set the MathLogic's attribute
ChangeAttr "slot#msGP.MoneyGiven +5"

// Reset the target
ResetTarget 1