Actor: Difference between revisions

From EDukeWiki
Jump to navigation Jump to search
Fox (talk | contribs)
No edit summary
m Add some missing info such as default values, and reword some paragraphs.
 
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
'''actor''' <picnum> <strength> <action> <move> <moveflag 1> [...] <moveflag N>
<span {{code}}>'''useractor''' <type> <picnum> [strength] [action] [move] [moveflag 1] [...] [moveflag N]</span>


'''useractor''' <type> <picnum> [strength> <action> <move> <moveflag 1> [...] <moveflag N>
Deprecated: <span {{code}}>'''actor''' <picnum> [strength] [action] [move] [moveflag 1] [...] [moveflag N]</span>


Defines parameters for in-game sprites, and allows code to be written for sprites of the specific tile number.


The token '''enda''' marks the end of the actor.
Defines the given tile number as an actor, enabling hardcoded actor behavior, attributes and allowing code to be written for sprites of that tile number.
 
Loosely speaking, "actors" are sprites that run code in game, such as enemies, breakable objects, etc.
 
The token '''actor''' specifies the start of an actor code block, while '''enda''' marks the end of the block.


  '''actor''' MYACTOR
  '''actor''' MYACTOR
Line 14: Line 17:
   [...]
   [...]
  '''enda'''
  '''enda'''
Loosely speaking, "actors" are sprites that run code in game, such as enemies, breakable objects, etc.


When defined with '''actor''' or '''useractor''', the sprites will execute their code once every tic, except for dormant enemies. Actors or dormant actors will have a statnum of 1 and 2 respectively.
When defined with '''actor''' or '''useractor''', the sprites will execute their code once every tic, except for dormant enemies. Actors or dormant actors will have a statnum of 1 and 2 respectively.
Line 21: Line 22:
Prior to v1.4, only tile numbers hard-coded to execute script would work with the '''actor''' command. After v1.4 new actors could be defined, and the '''useractor''' command was added which allowed actors to be defined as specific types for hard-coded behavior.
Prior to v1.4, only tile numbers hard-coded to execute script would work with the '''actor''' command. After v1.4 new actors could be defined, and the '''useractor''' command was added which allowed actors to be defined as specific types for hard-coded behavior.


With '''useractor''', the old '''actor''' command is deprecated.
With the addition of '''useractor''', the old '''actor''' command is deprecated and remains for compatibility reasons. Using '''actor''' is identical to '''useractor''' except that it always uses the "notenemy" type.


Example:
Example:
  define MYACTOR 3585
  define MYACTOR 3585
   
   
  '''actor''' MYACTOR 0
  '''useractor''' notenemy MYACTOR 0
   ifpdistl 1024  
   ifpdistl 1024  
   {  
   {  
Line 33: Line 34:
  enda
  enda


See also [[state]].
To reuse code between actors, see also: [[state]].


== Parameters ==
== Parameters ==


All parameters after <picnum> are optional.
All parameters after <picnum> are optional, and receive a default value of 0 if left undefined.


{| {{prettytable}}
{| {{prettytable}}
| <type> || is the actor type for special behavior. Only used by '''useractor'''.
| <type> || Defines the actor's hardcoded behavior type. Only used by '''useractor'''.
|-
|-
| <picnum> || You can either input a [[define]]d name, or the tile number directly.
| <picnum> || Either a [[define]] label, or the tile number as a constant. Identifies the tile to be defined as actor.
|-
|-
| <strength> || is the health of the actor.
| [strength] || Defines the initial health of the actor.
|-
|-
| <action> || is the intial [[action]] an actor uses.
| [action] || Defines the initial [[action]] an actor uses when activated.
|-
|-
| <move> || is the initial [[move]] of the actor.
| [move] || Defines the initial [[move]] of the actor when activated.
|-
|-
| <moveflag> || is a sequence of parameters that specify certain hard-coded movement behavior.
| [moveflag]... || A sequence of bit flags that specifies which hard-coded movement behavior to use, see [[move#moveflags|moveflags]].
|}
|}


Line 60: Line 61:
!Value!!DEFS.CON label!![[gameflags]]!!Description
!Value!!DEFS.CON label!![[gameflags]]!!Description
|-
|-
|0||notenemy||<font color="gray">(None)</font>||Default. Code begins executing at the start of a level.
|0||notenemy||<font color="gray">(None)</font>||Default. Code begins executing at the start of a level. Generally used for interactive objects.
|-
|-
|1||enemy||SFLAG_BADGUY||Enables hard-coded behavior. Code only begins executing upon player sight.
|1||enemy||SFLAG_BADGUY||Enables hard-coded enemy behavior. Code only begins executing upon player sight.
|-
|-
|2||enemystayput||SFLAG_BADGUY<br>SFLAG_BADGUYSTAYPUT||Same as "enemy" plus the [[actor]] will not leave the [[sector]] it is placed in.
|2||enemystayput||SFLAG_BADGUY<br>SFLAG_BADGUYSTAYPUT||Same as "enemy" plus the [[actor]] will not leave the [[sector]] it is placed in.

Latest revision as of 02:31, 10 January 2021

useractor <type> <picnum> [strength] [action] [move] [moveflag 1] [...] [moveflag N]

Deprecated: actor <picnum> [strength] [action] [move] [moveflag 1] [...] [moveflag N]


Defines the given tile number as an actor, enabling hardcoded actor behavior, attributes and allowing code to be written for sprites of that tile number.

Loosely speaking, "actors" are sprites that run code in game, such as enemies, breakable objects, etc.

The token actor specifies the start of an actor code block, while enda marks the end of the block.

actor MYACTOR
  [...]
enda

useractor notenemy MYACTOR2
  [...]
enda

When defined with actor or useractor, the sprites will execute their code once every tic, except for dormant enemies. Actors or dormant actors will have a statnum of 1 and 2 respectively.

Prior to v1.4, only tile numbers hard-coded to execute script would work with the actor command. After v1.4 new actors could be defined, and the useractor command was added which allowed actors to be defined as specific types for hard-coded behavior.

With the addition of useractor, the old actor command is deprecated and remains for compatibility reasons. Using actor is identical to useractor except that it always uses the "notenemy" type.

Example:

define MYACTOR 3585

useractor notenemy MYACTOR 0
  ifpdistl 1024 
  { 
    palfrom 32 0 16 0 
  }
enda

To reuse code between actors, see also: state.

Parameters

All parameters after <picnum> are optional, and receive a default value of 0 if left undefined.

<type> Defines the actor's hardcoded behavior type. Only used by useractor.
<picnum> Either a define label, or the tile number as a constant. Identifies the tile to be defined as actor.
[strength] Defines the initial health of the actor.
[action] Defines the initial action an actor uses when activated.
[move] Defines the initial move of the actor when activated.
[moveflag]... A sequence of bit flags that specifies which hard-coded movement behavior to use, see moveflags.

Types

The type is technically a bitfield, though "3" is invalid. It is generally either "enemy", "enemystayput", or "notenemy".

Value DEFS.CON label gameflags Description
0 notenemy (None) Default. Code begins executing at the start of a level. Generally used for interactive objects.
1 enemy SFLAG_BADGUY Enables hard-coded enemy behavior. Code only begins executing upon player sight.
2 enemystayput SFLAG_BADGUY
SFLAG_BADGUYSTAYPUT
Same as "enemy" plus the actor will not leave the sector it is placed in.
4 (None) SFLAG_ROTFIXED The actor's position in rotating sectors is calculated without rounding errors.