Engine02 Script Commands - Players
Index:
Player Manipulation:
| 94 | (D) (E) | Func_Set_Player_Character |
| 824 | (D) (E) | Func_Restore_Chr_Constants |
| 826 | (D) (E) | Func_Set_Player_Position |
Player Fetching:
| 137 | (D) (E) | Func_FetchPlayer |
| 990 | (D) (E) | Func_FetchPlayer_Reg |
| 991 | (D) (E) | Func_FetchPlayer_Curr_Chr |
| 992 | (D) (E) | Func_FetchPlayer_Curr_Obj |
| 993 | (D) (E) | Func_FetchPlayer_Fetched_Chr |
| 994 | (D) (E) | Func_FetchPlayer_Fetched_Obj |
| 1246 | (D) (E) | Func_CopyFetch_Player |
| 1248 | (D) (E) | Func_SwapFetch_Player |
Player Collision Testing:
| 842 | (D) (E) | Func_Current_Player_Test_Collisions |
| 843 | (D) (E) | Func_Other_Player_Test_Collisions |
Function Control:
| 951 | (D) (E) | Func_Call_Function_CharVar |
| 952 | (D) (E) | Func_Run_Function_CharVar |
| 953 | (D) (E) | Func_Stop_Function_CharVar |
| 954 | (D) (E) | Func_Call_Function_CharListing |
| 955 | (D) (E) | Func_Run_Function_CharListing |
| 956 | (D) (E) | Func_Stop_Function_CharListing |
| 1134 | (D) (E) | Func_Call_Function_CurrPlayer_Reg |
| 1135 | (D) (E) | Func_Call_Function_CurrPlayer_Chr |
| 1137 | (D) (E) | Func_Run_Function_CurrPlayer_Reg |
| 1138 | (D) (E) | Func_Run_Function_CurrPlayer_Chr |
| 1140 | (D) (E) | Func_Stop_Function_CurrPlayer_Reg |
| 1141 | (D) (E) | Func_Stop_Function_CurrPlayer_Chr |
| 1143 | (D) (E) | Func_Call_Function_FetchedPlayer_Reg |
| 1144 | (D) (E) | Func_Call_Function_FetchedPlayer_Chr |
| 1146 | (D) (E) | Func_Run_Function_FetchedPlayer_Reg |
| 1147 | (D) (E) | Func_Run_Function_FetchedPlayer_Chr |
| 1149 | (D) (E) | Func_Stop_Function_FetchedPlayer_Reg |
| 1150 | (D) (E) | Func_Stop_Function_FetchedPlayer_Chr |
| 1136 | (D) (E) | Func_Call_Function_CurrPlayer_PList |
| 1139 | (D) (E) | Func_Run_Function_CurrPlayer_PList |
| 1142 | (D) (E) | Func_Stop_Function_CurrPlayer_PList |
| 1145 | (D) (E) | Func_Call_Function_FetchedPlayer_PList |
| 1148 | (D) (E) | Func_Run_Function_FetchedPlayer_PList |
| 1151 | (D) (E) | Func_Stop_Function_FetchedPlayer_PList |
Player Pointers:
| 978 | (D) (E) | Func_Reg_Equ_Pointer_Curr_Chr |
| 980 | (D) (E) | Func_Chr_Equ_Pointer_Curr_Chr |
| 982 | (D) (E) | Func_Obj_Equ_Pointer_Curr_Chr |
| 984 | (D) (E) | Func_Reg_Equ_Pointer_Fetched_Chr |
| 986 | (D) (E) | Func_Chr_Equ_Pointer_Fetched_Chr |
| 988 | (D) (E) | Func_Obj_Equ_Pointer_Fetched_Chr |
ShovePlayer:
| 1120 | (D) (E) | Func_ShovePlayer_Path_Reg |
| 1121 | (D) (E) | Func_ShovePlayer_Path_Chr |
| 1122 | (D) (E) | Func_ShovePlayer_Path_Obj |
| 1123 | (D) (E) | Func_ShovePlayer_Path_Const |
| 1124 | (D) (E) | Func_ShovePlayer_X_Reg |
| 1125 | (D) (E) | Func_ShovePlayer_X_Chr |
| 1126 | (D) (E) | Func_ShovePlayer_X_Obj |
| 1127 | (D) (E) | Func_ShovePlayer_X_Const |
| 1128 | (D) (E) | Func_ShovePlayer_Y_Reg |
| 1129 | (D) (E) | Func_ShovePlayer_Y_Chr |
| 1130 | (D) (E) | Func_ShovePlayer_Y_Obj |
| 1131 | (D) (E) | Func_ShovePlayer_Y_Const |
| 1195 | (D) (E) | Func_ShovePlayer_Diag_Reg |
| 1196 | (D) (E) | Func_ShovePlayer_Diag_Chr |
| 1197 | (D) (E) | Func_ShovePlayer_Diag_Obj |
| 1198 | (D) (E) | Func_ShovePlayer_Diag_Const |
| 1182 | (D) (E) | Func_ShovePlayer_ObjectBounds |
| 1186 | (D) (E) | Func_ShovePlayer_Within_TiledObject_X |
| 1187 | (D) (E) | Func_ShovePlayer_Within_TiledObject_Y |
| 1188 | (D) (E) | Func_ShovePlayer_Within_TiledObject_Diag |
| 1189 | (D) (E) | Func_ShovePlayer_Riding_TiledObject_X |
| 1190 | (D) (E) | Func_ShovePlayer_Riding_TiledObject_Y |
| 1191 | (D) (E) | Func_ShovePlayer_Riding_TiledObject_Diag |
| 1192 | (D) (E) | Func_ShovePlayer_Within_SolidObject_X |
| 1193 | (D) (E) | Func_ShovePlayer_Within_SolidObject_Y |
| 1194 | (D) (E) | Func_ShovePlayer_Within_SolidObject_Diag |
Viewport Setting:
| 1407 | (D) (E) | Func_Player_Force_VPUpdate |
Setting the "Current Player":
| 1428 | (D) (E) | Func_Set_CurrPlayer_ByID |
| 1429 | (D) (E) | Func_Set_CurrPlayer_Reg |
| 1430 | (D) (E) | Func_Set_CurrPlayer_Chr |
| 1431 | (D) (E) | Func_Set_CurrPlayer_Obj |
| 1184 | (D) (E) | Func_Set_Player_Collision_Area_Reg |
| 1185 | (D) (E) | Func_Set_Player_Collision_Area_CurrObj |
Descriptions:
Player Manipulation:
94 - Func_Set_Player_Character
(ALL) (REG) (Example)
Sets the given player to the given character The "R" or "r" tags
may be used to obtain a value from a Register for either Parameter
Parameters:
- Player ID
ID number of the Player that should be set. The "Curr_Player"
variable ("r9") may be substituted for the ID if this command is called in a Player Function
or during a "Boundary Event", otherwise it may not have the desired effect
- Character ID
824 - Func_Restore_Chr_Constants
(ALL) (REG) (Example)
Resets the values of the given range of Player Constants to the values given to them
in the Character Def of the Player Character currently being used. The "R" or "r" tags
may be used to obtain a value from a Register for either Parameter
Parameters:
- Starting Constant ID
The ID number of the first Player Constant to restore. The lower-case "c" tag may
be used to signify a user-defined Player Constant as opposed to one of the required
Constants
- Ending Constant ID
The ID number of the last Player Constant to restore. The lower-case "c" tag may
be used to signify a user-defined Player Constant as opposed to one of the required
Constants
826 - Func_Set_Player_Position
(ALL) (REG) (Example)
Sets the position of a Player in the level, allowing for the Viewport to be Adjusted, and
for the Player to be aligned against a Path in any direction. The "R" and "r" tags may
be used to obtain a Player ID (Including "r9" for "Current Player" during any Player or
Collision Function) and/or X/Y Positions from Registers
Parameters:
- Player ID
ID number of the Player whose position should be set
- X Pos
- Y Pos
The new X and Y positions at which to place the Player
- Alignment
How to align the Player against a Path when the movement is done. The values are
as follows:
0 - No alignment, Player stays at the exact X and Y positions specified
1 - Move the Player down to the nearest floor Path, or up if an above Path is
colliding with his "MainBounds" Box
2 - Move the Player right to the nearest right wall Path, or left if a leftward
Path is colliding with his "MainBounds" Box
3 - Move the Player Up to the nearest ceiling Path, or down if a below Path is
colliding with his "MainBounds" Box
4 - Move the Player left to the nearest left wall Path, or right if a rightward
Path is colliding with his "MainBounds" Box
- Adjust Viewport
This value specifies whether the Viewport should be updated to follow the Player to his
new position, or if it's left where it is. (If this flag isn't set, the Viewport
will scroll until it reaches the Player's new position.)
0 - Don't set the Viewport position (It will scroll)
1 - Set the Viewport position to the appropriate location relative to the Player
Player Fetching:
137 - Func_FetchPlayer
(ALL) (REG) (Example)
"Fetches" a Player by Player ID
Parameters:
- Reference:
ID number of the "Reference" that the Player should be "Fetched" to. Using any of the following values will allow Fetching to more than one Reference:
3 - Fetch this Player to Reference 0 and 1
4 - Fetch this Player to Reference 1 and 2
5 - Fetch this Player to Reference 0 and 2
6 - Fetch this Player to Reference 0, 1, and 2
- Player ID
ID number of the Player to "Fetch" to this "Reference". The "R" and "r" tags may
be used to obtain a Player ID (Including "r9" for "Curr_Player" during any Player or
Collision Function) from a Register
990 - Func_FetchPlayer_Reg
991 - Func_FetchPlayer_Curr_Chr
992 - Func_FetchPlayer_Curr_Obj
993 - Func_FetchPlayer_Fetched_Chr
994 - Func_FetchPlayer_Fetched_Obj
(ALL) (Example)
"Fetches" a Player pointer that was stored in a Register, Player Variable, or Object Variable
For "_Curr" versions, The given variable is read from the "Current Player" or "Current Object"
For "_Fetched" versions, The given variable is read from the Player or Object that was already Fetched to Reference 0
Parameters:
- Reference:
ID number of the "Reference" that the Player should be "Fetched" to. Using any of the following values will allow Fetching to more than one Reference:
3 - Fetch this Player to Reference 0 and 1
4 - Fetch this Player to Reference 1 and 2
5 - Fetch this Player to Reference 0 and 2
6 - Fetch this Player to Reference 0, 1, and 2
- Var ID
In the case of "Registers", "Var ID" is the ID of the "Register" that contains the pointer. The "U" tag may be used
to specify a user-defined Register. Otherwise, the ID will refer to a Game Register
In the case of Player Variables, "Var ID" is the ID of the Player Variable that contains the pointer. The capital "A"
tag may be used to specify an "Active" variable, the lower-case "a" to specify a user-
defined "Active" variable, and the lower-case "c" to specify a user-defined Constant.
Otherwise, the ID will refer to one of the Player's required Constants
In the case of Object Variables, "Var ID" is the ID of the Object Variable that contains the pointer. The "E" tag may
be used to specify an "Extra" variable. Otherwise, the ID will refer to one of the
Object's standard variables
1246 - Func_CopyFetch_Player
(ALL) (Example)
Copies a "Fetched" Player from one Reference to another
Parameters:
- Src Reference:
ID number of the "Reference" to copy
- Dest Reference:
ID number of the "Reference" that the Player should be copied to. Using any of the following values will allow Fetching to more than one Reference:
3 - Fetch this Player to Reference 0 and 1
4 - Fetch this Player to Reference 1 and 2
5 - Fetch this Player to Reference 0 and 2
6 - Fetch this Player to Reference 0, 1, and 2
1248 - Func_SwapFetch_Player
(ALL) (Example)
Swaps "Fetched" Players between two References
Parameters:
- References
Specifies which two References should be swapped:
0 - Swap References 0 and 1
1 - Swap References 1 and 2
2 - Swap References 0 and 2
Player Collision Testing:
842 - Func_Current_Player_Test_Collisions
(ALL) (Example)
Causes the "Current Player" to test for collision against Objects.
This runs the Built-in and Scripted "Collision" functions associated with all Objects within
"Activity Range".
Because some "Collision" Script Commands test the
direction of the Player's movement, the
Player's "X_Count" and "Y_Count" must be set to the
proper values for accurate results. An "X_Count" greater than 255 signifies right motion,
while a value less than -255 signifies left motion. Similarly, a "Y_Count" greater than 255
signifies downward motion, while a value less than -255 signifies upward motion. Collision
must be tested on only one axis (X or Y) at a time, and as such, when using "X_Count",
"Y_Count" must be between -255 and 255, and when using "Y_Count", "X_Count" must be between
-255 and 255
Parameters:
None
843 - Func_Other_Player_Test_Collisions
(ALL) (REG) (Example)
Causes the given Player to test for collision against Objects.
This runs the Built-in and Scripted "Collision" functions associated with all Objects within
"Activity Range".
Because some "Collision" Script Commands test the
direction of the Player's movement, the
Player's "X_Count" and "Y_Count" must be set to the
proper values for accurate results. An "X_Count" greater than 255 signifies right motion,
while a value less than -255 signifies left motion. Similarly, a "Y_Count" greater than 255
signifies downward motion, while a value less than -255 signifies upward motion. Collision
must be tested on only one axis (X or Y) at a time, and as such, when using "X_Count",
"Y_Count" must be between -255 and 255, and when using "Y_Count", "X_Count" must be between
-255 and 255
Parameters:
- Player ID
ID number of the Player to test for collisions. The "R" and "r" tags may
be used to obtain a Player ID from a Register
Function Control:
951 - Func_Call_Function_CharVar
952 - Func_Run_Function_CharVar
953 - Func_Stop_Function_CharVar
(ALL) (Example)
Calls, Runs, or Stops the Scripted Character Common Function given
by the specified Player Variable as a "Movement/Sentry Function". The "Current Player" is used for obtaining the variable value, and will be the Player whose Functions are affected
Parameters:
- Var ID
ID of the Player Variable that contains the Function ID. The capital "A"
tag may be used to specify an "Active" variable, the lower-case "a" to specify a user-
defined "Active" variable, and the lower-case "c" to specify a user-defined Constant.
Otherwise, the ID will refer to one of the Player's required Constants
954 - Func_Call_Function_CharListing
955 - Func_Run_Function_CharListing
956 - Func_Stop_Function_CharListing
(ALL) (REG) (Example)
1134 - Func_Call_Function_CurrPlayer_Const
1135 - Func_Call_Function_CurrPlayer_Chr
1137 - Func_Run_Function_CurrPlayer_Const
1138 - Func_Run_Function_CurrPlayer_Chr
1140 - Func_Stop_Function_CurrPlayer_Const
1141 - Func_Stop_Function_CurrPlayer_Chr
1143 - Func_Call_Function_FetchedPlayer_Const
1144 - Func_Call_Function_FetchedPlayer_Chr
1146 - Func_Run_Function_FetchedPlayer_Const
1147 - Func_Run_Function_FetchedPlayer_Chr
1149 - Func_Stop_Function_FetchedPlayer_Const
1150 - Func_Stop_Function_FetchedPlayer_Chr
(ALL) (Example)
Calls, Runs, or Stops the Scripted Character Common Function given
by the specified variable as a "Movement/Sentry Function"
For the "_CurrPlayer" versions, the "Current Player" is used for obtaining the variable value in the case of Player Variables, and will be the Player whose Functions are affected
For the "_FetchedPlayer" versions, the Player "Fetched" to "Reference 2" is used for obtaining the variable value in the case of Player Variables, and will be the Player whose Functions are affected
Parameters:
- Var ID
In the case of a Constant Value, the ID of the Character Common Function should be entered as the "Var ID"
parameter rather than any actual variable ID. However, the "R" or "r" tags
may be used to obtain the ID from a Register
In the case of Player Variables, Var ID is the ID of the Player Variable that contains the Function ID. The capital "A"
tag may be used to specify an "Active" variable, the lower-case "a" to specify a user-
defined "Active" variable, and the lower-case "c" to specify a user-defined Constant.
Otherwise, the ID will refer to one of the Player's required Constants
1136 - Func_Call_Function_CurrPlayer_PList
1139 - Func_Run_Function_CurrPlayer_PList
1142 - Func_Stop_Function_CurrPlayer_PList
1145 - Func_Call_Function_FetchedPlayer_PList
1148 - Func_Run_Function_FetchedPlayer_PList
1151 - Func_Stop_Function_FetchedPlayer_PList
(ALL) (REG) (Example)
Calls, Runs, or Stops the given Scripted Character-Specific Function
Variable as a "Movement/Sentry Function"
For the "_CurrPlayer" versions, the "Current Player" will be the Player whose Functions are affected
For the "_FetchedPlayer" versions, the Player "Fetched" to "Reference 2" will be the Player whose Functions are affected
Parameters:
- Var ID
ID of the desired "Character-Specific Function". The "R" and "r" tags may
be used to obtain the ID from a Register
Player Pointers:
978 - Func_Reg_Equ_Pointer_Curr_Chr
980 - Func_Chr_Equ_Pointer_Curr_Chr
982 - Func_Obj_Equ_Pointer_Curr_Chr
984 - Func_Reg_Equ_Pointer_Fetched_Chr
986 - Func_Chr_Equ_Pointer_Fetched_Chr
988 - Func_Obj_Equ_Pointer_Fetched_Chr
(ALL) (Example)
Obtain a pointer to the Player, and place it in the given variable for later retrieval by special Fetch Commands
For "_Curr" versions, a pointer to the "Current Player" will be retrieved
For "_Fetched" versions, a pointer to the Player that was "Fetched" to "Reference 0" will be retrieved
Parameters:
- Var ID
In the case of "Registers", "Var ID" is the ID of the "Register" into which to place the pointer. The "U" tag may be used
to specify a user-defined Register. Otherwise, the ID will refer to a Game Register
In the case of Player Variables, "Var ID" is the ID of the Player Variable into which to place the pointer. The capital "A"
tag may be used to specify an "Active" variable, the lower-case "a" to specify a user-
defined "Active" variable, and the lower-case "c" to specify a user-defined Constant.
Otherwise, the ID will refer to one of the Player's required Constants
In the case of Object Variables, "Var ID" is the ID of the Object Variable into which to place the pointer. The "E" tag may
be used to specify an "Extra" variable. Otherwise, the ID will refer to one of the
Object's standard variables
ShovePlayer:
1120 - Func_ShovePlayer_Path_Reg
1121 - Func_ShovePlayer_Path_Chr
1122 - Func_ShovePlayer_Path_Obj
1123 - Func_ShovePlayer_Path_Const
(ALL) (Example)
Moves the Player "Fetched" to "Reference 2" by calling his
Hard-Coded Movement with the given velocity, allowing
for proper collision testing against Objects and the Level during the movement
This is Primarily used by
Scripted Object Movement Functions for Objects that move the Player, or by other special scripted movement
that must take place after the Player's normal Hard-Coded Movement has already been processed for the current
Game Frame
These Commands must not be used during Scripted Object Collision Functions, because those Functions
are processed during the Player's normal Hard-Coded Movement
These "_Path" versions leave the Player connected to any Path he may be following, and apply the velocity as "Path Velocity".
The Player's original Path Velocity is automatically restored after the movement is complete
Parameters:
- Var ID
In the case of "Registers", "Var ID" is the ID of the "Register" that contains the velocity to apply. The "U" tag may be used
to specify a user-defined Register. Otherwise, the ID will refer to a Game Register
In the case of Player Variables, "Var ID" is the ID of the Player Variable that contains the velocity to apply. The capital "A"
tag may be used to specify an "Active" variable, the lower-case "a" to specify a user-
defined "Active" variable, and the lower-case "c" to specify a user-defined Constant.
Otherwise, the ID will refer to one of the Player's required Constants
In the case of Object Variables, "Var ID" is the ID of the Object Variable that contains the velocity to apply. The "E" tag may
be used to specify an "Extra" variable. Otherwise, the ID will refer to one of the
Object's standard variables
In the case of a Constant Value, the velocity value itself should be entered as the "Var ID" Parameter, rather than any actual Variable ID
1124 - Func_ShovePlayer_X_Reg
1125 - Func_ShovePlayer_X_Chr
1126 - Func_ShovePlayer_X_Obj
1127 - Func_ShovePlayer_X_Const
1128 - Func_ShovePlayer_Y_Reg
1129 - Func_ShovePlayer_Y_Chr
1130 - Func_ShovePlayer_Y_Obj
1131 - Func_ShovePlayer_Y_Const
(ALL) (Example)
Moves the Player "Fetched" to "Reference 2" by calling his
Hard-Coded Movement with the given velocity, allowing
for proper collision testing against Objects and the Level during the movement
This is Primarily used by
Scripted Object Movement Functions for Objects that move the Player, or by other special scripted movement
that must take place after the Player's normal Hard-Coded Movement has already been processed for the current
Game Frame
These Commands must not be used during Scripted Object Collision Functions, because those Functions
are processed during the Player's normal Hard-Coded Movement
These "_X"/"_Y" versions disconnect the Player from any Path he may be following, and apply the velocity as X or Y Velocity.
The Player's original X and Y Velocities are automatically restored after the movement is complete
Parameters:
- Var ID
In the case of "Registers", "Var ID" is the ID of the "Register" that contains the velocity to apply. The "U" tag may be used
to specify a user-defined Register. Otherwise, the ID will refer to a Game Register
In the case of Player Variables, "Var ID" is the ID of the Player Variable that contains the velocity to apply. The capital "A"
tag may be used to specify an "Active" variable, the lower-case "a" to specify a user-
defined "Active" variable, and the lower-case "c" to specify a user-defined Constant.
Otherwise, the ID will refer to one of the Player's required Constants
In the case of Object Variables, "Var ID" is the ID of the Object Variable that contains the velocity to apply. The "E" tag may
be used to specify an "Extra" variable. Otherwise, the ID will refer to one of the
Object's standard variables
In the case of a Constant Value, the velocity value itself should be entered as the "Var ID" Parameter, rather than any actual Variable ID
1195 - Func_ShovePlayer_Diag_Reg
1196 - Func_ShovePlayer_Diag_Chr
1197 - Func_ShovePlayer_Diag_Obj
1198 - Func_ShovePlayer_Diag_Const
(ALL) (Example)
Moves the Player "Fetched" to "Reference 2" by calling his
Hard-Coded Movement with the given velocity, allowing
for proper collision testing against Objects and the Level during the movement
This is Primarily used by
Scripted Object Movement Functions for Objects that move the Player, or by other special scripted movement
that must take place after the Player's normal Hard-Coded Movement has already been processed for the current
Game Frame
These Commands must not be used during Scripted Object Collision Functions, because those Functions
are processed during the Player's normal Hard-Coded Movement
These "_Diag" versions disconnect the Player from any Path he may be following, and apply the velocities as X and Y Velocities.
The Player's original X and Y Velocities are automatically restored after the movement is complete
Parameters:
- Var ID X
- Var ID Y
In the case of "Registers", "Var ID" is the ID of the "Register" that contains the velocity to apply. The "U" tag may be used
to specify a user-defined Register. Otherwise, the ID will refer to a Game Register
In the case of Player Variables, "Var ID" is the ID of the Player Variable that contains the velocity to apply. The capital "A"
tag may be used to specify an "Active" variable, the lower-case "a" to specify a user-
defined "Active" variable, and the lower-case "c" to specify a user-defined Constant.
Otherwise, the ID will refer to one of the Player's required Constants
In the case of Object Variables, "Var ID" is the ID of the Object Variable that contains the velocity to apply. The "E" tag may
be used to specify an "Extra" variable. Otherwise, the ID will refer to one of the
Object's standard variables
In the case of a Constant Value, the velocity value itself should be entered as the "Var ID" Parameter, rather than any actual Variable ID
1182 - Func_ShovePlayer_ObjectBounds
(ALL) (Example)
Moves the Player "Fetched" to "Reference 2" by calling his
Hard-Coded Movement with the given velocity, allowing
for proper collision testing against Objects and the Level during the movement
This is Primarily used by Scripted Object Movement Functions for Solid Objects
that move the Player, when the Player is not standing on them. When the Player is standing on the Object, use
Func_ShovePlayer_Diag_Obj or Func_ShovePlayer_X/Y_Obj
This Command must not be used during Scripted Object Collision Functions, because those Functions
are processed during the Player's normal Hard-Coded Movement
This "_ObjectBounds" version disconnects the Player from any Path he may be following, and applies just enough X or Y
Velocity to shove the Player outside of the Object's "MainBounds" Collision Box in the selected direction.
The Player's original X and Y Velocities are automatically restored after the movement is complete
Parameters:
- Direction
The Direction in which to shove the Player out of the Object:
0 - Shove Player to the top of the Object
1 - Shove Player to the bottom of the Object
2 - Shove Player to the left of the Object
3 - Shove Player to the right of the Object
1186 - Func_ShovePlayer_Within_TiledObject_X
1187 - Func_ShovePlayer_Within_TiledObject_Y
(ALL) (Example)
Moves the Player "Fetched" to "Reference 2" by calling his
Hard-Coded Movement with the given velocity, allowing
for proper collision testing against Objects and the Level during the movement
This is Primarily used by Scripted Object Movement Functions for Tiled Path Objects
that move the Player, when the Player is not standing on them. When the Player is standing on the Object, use
Func_ShovePlayer_Riding_TiledObject_Diag or Func_ShovePlayer_Riding_TiledObject_X/Y
These Commands must not be used during Scripted Object Collision Functions, because those Functions
are processed during the Player's normal Hard-Coded Movement
These "_Riding_TiledObject_?" versions disconnect the Player from any Path he may be following, and apply just enough X or Y
Velocity to shove the Player outside of any of the Object's solid areas in its direction of movement (determined by given Object Variable).
The Player's original X and Y Velocities are automatically restored after the movement is complete
Parameters:
- VarID
ID number of the Object Variable from the "Current Object" that should be used to determine the Object's direction of
movement (usually it's velocity). Negative value for up/left, positive for down/right
1188 - Func_ShovePlayer_Within_TiledObject_Diag
(ALL) (Example)
Moves the Player "Fetched" to "Reference 2" by calling his
Hard-Coded Movement with the given velocity, allowing
for proper collision testing against Objects and the Level during the movement
This is Primarily used by Scripted Object Movement Functions for Tiled Path Objects
that move the Player, when the Player is not standing on them
This Command must not be used during Scripted Object Collision Functions, because those Functions
are processed during the Player's normal Hard-Coded Movement
This "_Riding_TiledObject_Diag" version disconnects the Player from any Path he may be following, and applies just enough X and Y
Velocity to shove the Player outside of any of the Object's solid areas in its direction of movement (determined by given Object Variable).
The Player's original X and Y Velocities are automatically restored after the movement is complete
Parameters:
- VarID X
- VarID Y
ID number of the Object Variables from the "Current Object" that should be used to determine the Object's direction of
movement (usually it's velocity). Negative value for up/left, positive for down/right
1189 - Func_ShovePlayer_Riding_TiledObject_X
1190 - Func_ShovePlayer_Riding_TiledObject_Y
(ALL) (Example)
Moves the Player "Fetched" to "Reference 2" by calling his
Hard-Coded Movement with the given velocity, allowing
for proper collision testing against Objects and the Level during the movement
This is Primarily used by Scripted Object Movement Functions for Tiled Path Objects
that move the Player, when the Player is standing on them. When the Player is not standing on the Object, use
Func_ShovePlayer_Within_TiledObject_Diag or Func_ShovePlayer_Within_TiledObject_X/Y
These Commands must not be used during Scripted Object Collision Functions, because those Functions
are processed during the Player's normal Hard-Coded Movement
These "_Riding_TiledObject_?" versions disconnect the Player from any Path he may be following, and apply just enough X or Y
Velocity to shove the Player outside of any of the Object's solid areas in its direction of movement (determined by given Object Variable).
The Player's original X and Y Velocities are automatically restored after the movement is complete
Parameters:
- VarID
ID number of the Object Variable from the "Current Object" that should be used to determine the Object's direction of
movement (usually it's velocity). Negative value for up/left, positive for down/right
1191 - Func_ShovePlayer_Riding_TiledObject_Diag
(ALL) (Example)
Moves the Player "Fetched" to "Reference 2" by calling his
Hard-Coded Movement with the given velocity, allowing
for proper collision testing against Objects and the Level during the movement
This is Primarily used by Scripted Object Movement Functions for Tiled Path Objects
that move the Player, when the Player is standing on them. When the Player is not standing on the Object, use
Func_ShovePlayer_Within_TiledObject_Diag or Func_ShovePlayer_Within_TiledObject_X/Y
This Command must not be used during Scripted Object Collision Functions, because those Functions
are processed during the Player's normal Hard-Coded Movement
This "_Riding_TiledObject_Diag" version disconnects the Player from any Path he may be following, and applies just enough X and Y
Velocity to shove the Player outside of any of the Object's solid areas in its direction of movement (determined by given Object Variable).
The Player's original X and Y Velocities are automatically restored after the movement is complete
Parameters:
- VarID X
- VarID Y
ID number of the Object Variables from the "Current Object" that should be used to determine the Object's direction of
movement (usually it's velocity). Negative value for up/left, positive for down/right
1192 - Func_ShovePlayer_Within_SolidObject_X
1193 - Func_ShovePlayer_Within_SolidObject_Y
(ALL) (Example)
Moves the Player "Fetched" to "Reference 2" by calling his
Hard-Coded Movement with the given velocity, allowing
for proper collision testing against Objects and the Level during the movement
This is Primarily used by Scripted Object Movement Functions for Solid Objects
that move the Player, when the Player is not standing on them. When the Player is standing on the Object, use
Func_ShovePlayer_Diag_Obj or Func_ShovePlayer_X/Y_Obj
These Commands must not be used during Scripted Object Collision Functions, because those Functions
are processed during the Player's normal Hard-Coded Movement
These "_Within_SolidObject_?" versions disconnect the Player from any Path he may be following, and apply just enough X or Y
Velocity to shove the Player outside of the Object's "MainBounds" Collision Box in its direction of movement (determined by given Object Variable).
The Player's original X and Y Velocities are automatically restored after the movement is complete
Parameters:
- VarID
ID number of the Object Variable from the "Current Object" that should be used to determine the Object's direction of
movement (usually it's velocity). Negative value for up/left, positive for down/right
1194 - Func_ShovePlayer_Within_SolidObject_Diag
(ALL) (Example)
Moves the Player "Fetched" to "Reference 2" by calling his
Hard-Coded Movement with the given velocity, allowing
for proper collision testing against Objects and the Level during the movement
This is Primarily used by Scripted Object Movement Functions for Solid Objects
that move the Player, when the Player is not standing on them. When the Player is standing on the Object, use
Func_ShovePlayer_Diag_Obj or Func_ShovePlayer_X/Y_Obj
This Command must not be used during Scripted Object Collision Functions, because those Functions
are processed during the Player's normal Hard-Coded Movement
This "_Within_SolidObject_?" version disconnects the Player from any Path he may be following, and applies just enough X or Y
Velocity to shove the Player outside of the Object's "MainBounds" Collision Box in its direction of movement (determined by given Object Variable).
The Player's original X and Y Velocities are automatically restored after the movement is complete
Parameters:
- VarID X
- VarID Y
ID number of the Object Variables from the "Current Object" that should be used to determine the Object's direction of
movement (usually it's velocity). Negative value for up/left, positive for down/right
Viewport Setting:
1407 - Func_Player_Force_VPUpdate
(ALL) (Example)
Setting the "Current Player":
1428 - Func_Set_CurrPlayer_ByID
(ALL) (REG) (Example)
Sets the the Player whose ID is given by the parameter as the "Current Player". Manually modifying
"Curr_Player" is insufficient; this Command will
perform a proper setting, including automatically modifying "Curr_Player"
This Command is meant to be used in Functions that are not a part of normal Player processing,
so that Commands that read or manipulate the "Current Player" can still be used as desired.
This Command can be used to switch the "Current Player" during Player processing Functions such
as Player movement, update, and input Functions, as well as during Object collisions, but in
these cases, the original "Current Player" must be restored when finished
Parameters:
- Player ID
ID number of the Player to set as the "Current Player". The "R" and "r" tags may
be used to obtain a Player ID from a Register
1429 - Func_Set_CurrPlayer_Reg
1430 - Func_Set_CurrPlayer_Chr
1431 - Func_Set_CurrPlayer_Obj
(ALL) (Example)
Sets the "Current Player" to the Player whose pointer is stored in the given variable. Manually modifying
"Curr_Player" is insufficient; this Command will
perform a proper setting, including automatically modifying "Curr_Player"
This Command is meant to be used in Functions that are not a part of normal Player processing,
so that Commands that read or manipulate the "Current Player" can still be used as desired.
This Command can be used to switch the "Current Player" during Player processing Functions such
as Player movement, update, and input Functions, as well as during Object collisions, but in
these cases, the original "Current Player" must be restored when finished
Parameters:
- Var ID
In the case of "Registers", "Var ID" is the ID of the "Register" that contains the pointer. The "U" tag may be used
to specify a user-defined Register. Otherwise, the ID will refer to a Game Register
In the case of Player Variables, "Var ID" is the ID of the Player Variable that contains the pointer. The capital "A"
tag may be used to specify an "Active" variable, the lower-case "a" to specify a user-
defined "Active" variable, and the lower-case "c" to specify a user-defined Constant.
Otherwise, the ID will refer to one of the Player's required Constants
In the case of Object Variables, "Var ID" is the ID of the Object Variable that contains the pointer. The "E" tag may
be used to specify an "Extra" variable. Otherwise, the ID will refer to one of the
Object's standard variables
1184 - Func_Set_Player_Collision_Area
(ALL) (REG) (Example)
Sets the given Player to the specified "Collision Area". This is primarily used so that Objects may properly test for
collisions with Players during their own movement
when the Level is set for looping
Also Sets the "Current Player" to the Player whose ID is given by the parameter. Manually modifying
"Curr_Player" is insufficient; this Command will
perform a proper setting, including automatically modifying "Curr_Player"
This Command is meant to be used in Functions that are not a part of normal Player processing.
This is not necessary during normal Player/Object collision testing because
it is handled automatically, nor is it at all necessary when the level is not looping
Parameters:
1185 - Func_Set_Player_Collision_Area_CurrObj
(ALL) (REG) (Example)
Sets the given Player to the same "Collision Area" as the "Current Object". This is primarily used so that Objects may properly test for
collisions with Players during their own movement
when the Level is set for looping
Also Sets the "Current Player" to the Player whose ID is given by the parameter. Manually modifying
"Curr_Player" is insufficient; this Command will
perform a proper setting, including automatically modifying "Curr_Player"
This Command is meant to be used in Functions that are not a part of normal Player processing.
This is not necessary during normal Player/Object collision testing because
it is handled automatically, nor is it at all necessary when the level is not looping
Parameters:
- Player ID
ID number of the Player to set as the "Current Player", and whose "Collision Area" to set by the given ID. The "R" and "r" tags may
be used to obtain a Player ID from a Register
Examples:
# 94 ;Set Player Character (Set Player 1 to use Player Character 0)
: 0 ;(Plyr ID) Player 1
: 0 ;(Char ID) Player Character 0
; ----------
# 94 ;Set Player Character (Set Player 1 to use the Player Character whose ID is stored in User Register 0)
: 1 ;(Plyr ID) Player 2
: R6 ;(Char ID) Value stored in User Register 6
824 - Func_Restore_Chr_Constants
(Description)
# 824 ;Restore Player Constants (Restore the default values of User-created "Constant"s 5 through 9 of the Player "Fetched" to "Reference 2")
: c5 ;(Start) User-created "Constant" of the Player "Fetched" to "Reference 2"
: c9 ;(End) User-created "Constant" of the Player "Fetched" to "Reference 9"
; ----------
# 824 ;Set Player Character (Restore the default values of the User-created "Constant"s of the Player "Fetched" to "Reference 2" whose values begin at the value stored in User Register 16, and end at the value stored in User Register 17)
: R16 ;(Start) Value stored in User Register 16
: R17 ;(End) Value stored in User Register 17
826 - Func_Set_Player_Position
(Description)
# 826 ;Set Player Position (Set the Current Player's X and Y position to exactly 50,256, without aligning him against the level and without adjusting his viewport to follow [this will cause the screen to scroll to him if he is flagged for automatic viewport updates])
: 0 ;(ChrID) Player 1
: 50 ;(X)
: 256 ;(Y)
: 0 ;(Align) None
: 0 ;(VPAdj) No
; ----------
# 826 ;Set Player Position (Set the Current Player's X and Y position to the values of User Registers 7 and 8, respectively, adjusting his Y position to set him onto the floor, and adjusting the viewport to follow)
: r9 ;(ChrID) Current Player
: R7 ;(X) User Register 7
: R8 ;(Y) User Register 8
: 1 ;(Align) With Floor
: 1 ;(VPAdj) Yes
Player Fetching:
# 137 ;FetchPlayer (Fetch Player 1 to Reference 0, Reference 1, and Reference 2)
: 6 ;All References
: 0 ;Player 1
; ----------
# 137 ;FetchPlayer (Fetch the "Current Player" to Reference 0)
: 0 ;Reference 0
: r9 ;Current Player
; ----------
# 137 ;FetchPlayer (Fetch Player 2 to Reference 0 and Reference 2)
: 5 ;References 0 and 2
: 1 ;Current Player
990 - Func_FetchPlayer_Reg
991 - Func_FetchPlayer_Curr_Chr
992 - Func_FetchPlayer_Curr_Obj
993 - Func_FetchPlayer_Fetched_Chr
994 - Func_FetchPlayer_Fetched_Obj
(Description)
# 990 ;FetchPlayer Reg (Fetch the Player whose pointer is stored in User Register 4 to Reference 0, Reference 1, and Reference 2)
: 6 ;All References
: U4 ;User Register 4
; ----------
# 991 ;FetchPlayer Curr Chr (Fetch the Player whose pointer is stored in User-created "Active Variable" 32 of the "Current Player" to Reference 2)
: 2 ;Reference 2
: a32 ;User-created "Active Variable" 32 of the "Current Player"
; ----------
# 994 ;FetchPlayer Fetched Obj (Fetch the Player whose pointer is stored in "Extra Variable" 8 of the Object "Fetched" to Reference 0 to Reference 1 and Reference 2)
: 4 ;References 1 and 2
: E8 ;"Extra Variable" 8 of the Object "Fetched" to Reference 0
1246 - Func_CopyFetch_Player
(Description)
#1246 ;CopyFetch Player (Fetch the Player Fetched to Reference 1 to Reference 2 [Both will reference the Player originally referenced by Reference 1])
: 1 ;(Src) Reference 1
: 2 ;(Dest) Reference 2
; ----------
#1246 ;CopyFetch Player (Fetch the Player Fetched to Reference 2 to both Reference 0 and Reference 1 [All three will reference the Player originally referenced by Reference 2])
: 2 ;(Src) Reference 2
: 3 ;(Dest) References 0 and 1
1248 - Func_SwapFetch_Player
(Description)
#1248 ;SwapFetch Player (Swap the Players that were Fetched to References 0 and 2 [Ex: If Reference 0 previously referenced Player 1, and Reference 2 previously referenced Player 2, then Reference 0 will now reference Player 2, and Reference 2 will now reference Player 1])
: 2 ;References 0 and 2
Player Collision Testing:
842 - Func_Current_Player_Test_Collisions
(Description)
# 842 ;Current Player Test Collisions (Cause the "Current Player" to test for Collisions with all Objects within "Activity Range")
843 - Func_Other_Player_Test_Collisions
(Description)
# 843 ;Other Player Test Collisions (Cause Player 2 to test for Collisions with all Objects within "Activity Range")
: 1 ;Player 2
; ----------
# 843 ;Other Player Test Collisions (Cause the Player whose ID is stored in User Register 5 to test for Collisions with all Objects within "Activity Range")
: R5 ;Value stored in User Register 5
Function Control:
951 - Func_Call_Function_CharVar
952 - Func_Run_Function_CharVar
953 - Func_Stop_Function_CharVar
(Description)
# 951 ;Call Function CharVar (Cause the "Current Player" to queue the Character-Common Function whose ID is stored in User-created "Constant" 13 of the "Current Player")
: c13 ;User-created "Constant" 13 of the "Current Player"
; ----------
# 952 ;Run Function CharVar (Cause the "Current Player" to queue and immediately process the Character-Common Function whose ID is stored in User-created "Active Variable" 27 of the "Current Player")
: a27 ;User-created "Active Variable" 27 of the "Current Player"
; ----------
# 953 ;Stop Function CharVar (Cause the "Current Player" to remove from its queue the Character-Common Function whose ID is stored in User-created "Active Variable" 5 of the "Current Player")
: a5 ;User-created "Active Variable" 5 of the "Current Player"
954 - Func_Call_Function_CharListing
955 - Func_Run_Function_CharListing
956 - Func_Stop_Function_CharListing
(Description)
# 954 ;Call Function CharListing (Cause the "Current Player" to queue Character-Specific Function 8 of the Character Def that corresponds with its Player Character Type)
: 8 ;Character-Specific Function 8
; ----------
# 955 ;Run Function CharListing (Cause the "Current Player" to queue and immediately process the Character-Specific Function whose value is stored in User Register 4, of the Character Def that corresponds with its Player Character Type)
: R4 ;Value stored in User Register 4
; ----------
# 956 ;Stop Function CharListing (Cause the "Current Player" to remove from its queue Character-Specific Function 16 of the Character Def that corresponds with its Player Character Type)
: 16 ;Character-Specific Function 16
1134 - Func_Call_Function_CurrPlayer_Const
1135 - Func_Call_Function_CurrPlayer_Chr
1137 - Func_Run_Function_CurrPlayer_Const
1138 - Func_Run_Function_CurrPlayer_Chr
1140 - Func_Stop_Function_CurrPlayer_Const
1141 - Func_Stop_Function_CurrPlayer_Chr
1143 - Func_Call_Function_FetchedPlayer_Const
1144 - Func_Call_Function_FetchedPlayer_Chr
1146 - Func_Run_Function_FetchedPlayer_Const
1147 - Func_Run_Function_FetchedPlayer_Chr
1149 - Func_Stop_Function_FetchedPlayer_Const
1150 - Func_Stop_Function_FetchedPlayer_Chr
(Description)
#1134 ;Call Function CurrPlayer Const (Cause the "Current Player" to queue Character-Common Function 10)
: 10 ;Character-Common Function 10
; ----------
#1137 ;Run Function CurrPlayer Const (Cause the "Current Player" to queue and immediately process the Character-Common Function whose value is stored in User Register 2)
: R2 ;Value stored in User Register 2"
; ----------
#1150 ;Stop Function FetchedPlayer Chr (Cause the Player "Fetched" to "Reference 2" to remove from its queue the Character-Common Function whose value is stored in User-created "Active Variable" 9 of the Player "Fetched" to "Reference 2")
: a9 ;User-created "Active Variable" 9 of the Player "Fetched" to "Reference 2"
1136 - Func_Call_Function_CurrPlayer_PList
1139 - Func_Run_Function_CurrPlayer_PList
1142 - Func_Stop_Function_CurrPlayer_PList
1145 - Func_Call_Function_FetchedPlayer_PList
1148 - Func_Run_Function_FetchedPlayer_PList
1151 - Func_Stop_Function_FetchedPlayer_PList
(Description)
#1136 ;Call Function CurrPlayer PList (Cause the "Current Player" to queue Character-Specific Function 31 of the Character Def that corresponds with its Player Character Type)
: 31 ;Character-Specific Function 31
; ----------
#1148 ;Run Function FetchedPlayer PList (Cause the Player "Fetched" to "Reference 2" to queue and immediately process the Character-Specific Function whose value is stored in User Register 19, of the Character Def that corresponds with its Player Character Type)
: R19 ;Value stored in User Register 19
; ----------
#1149 ;Stop Function FetchedPlayer PList (Cause the Player "Fetched" to "Reference 2" to remove from its queue the Character-Specific Function whose value is stored in User Register 1, of the Character Def that corresponds with its Player Character Type)
: R1 ;Value stored in User Register 1
Player Pointers:
978 - Func_Reg_Equ_Pointer_Curr_Chr
980 - Func_Chr_Equ_Pointer_Curr_Chr
982 - Func_Obj_Equ_Pointer_Curr_Chr
984 - Func_Reg_Equ_Pointer_Fetched_Chr
986 - Func_Chr_Equ_Pointer_Fetched_Chr
988 - Func_Obj_Equ_Pointer_Fetched_Chr
(Description)
# 978 ;Reg = Ptr to CurrPlayer (Store a pointer to the "Current Player" in User Register 7)
: U7 ;User Register 7
; ----------
# 986 ;Chr2 = Ptr to FetchedPlayer (Store a pointer to the Player "Fetched" to "Reference 0" in User-created "Active Variable" 11 of the Player "Fetched" to "Reference 2")
: a11 ;User-created "Active Variable" 11 of the Player "Fetched" to "Reference 2"
; ----------
# 988 ;Obj2 = Ptr to FetchedPlayer (Store a pointer to the Player "Fetched" to "Reference 0" in "Extra Variable" 0 of the Object "Fetched" to "Reference 2")
: E0 ;"Extra Variable" 0 of the Object "Fetched" to "Reference 2"
ShovePlayer:
1120 - Func_ShovePlayer_Path_Reg
1121 - Func_ShovePlayer_Path_Chr
1122 - Func_ShovePlayer_Path_Obj
1123 - Func_ShovePlayer_Path_Const
(Description)
#1120 ;ShovePlayer Path Reg ("Shove" the Player "Fetched" to "Reference 2" along the path with the velocity given by User Register 8)
: U8 ;User Register 8
; ----------
#1121 ;ShovePlayer Path Chr0 ("Shove" the Player "Fetched" to "Reference 2" along the path with the velocity given by User-created "Active Variable" 15 of the Player "Fetched" to "Reference 0")
: a15 ;User-created "Active Variable" 15 of the Player "Fetched" to "Reference 0"
; ----------
#1122 ;ShovePlayer Path Obj0 ("Shove" the Player "Fetched" to "Reference 2" along the path with the velocity given by "Extra Variable" 1 of the Object "Fetched" to "Reference 0")
: E1 ;"Extra Variable" 1 of the Object "Fetched" to "Reference 0"
; ----------
#1122 ;ShovePlayer Path Const ("Shove" the Player "Fetched" to "Reference 2" along the path with a velocity of 512)
: 512 ;Velocity 512 (512/256 = 2 pixels per frame)
1124 - Func_ShovePlayer_X_Reg
1125 - Func_ShovePlayer_X_Chr
1126 - Func_ShovePlayer_X_Obj
1127 - Func_ShovePlayer_X_Const
1128 - Func_ShovePlayer_Y_Reg
1129 - Func_ShovePlayer_Y_Chr
1130 - Func_ShovePlayer_Y_Obj
1131 - Func_ShovePlayer_Y_Const
(Description)
#1124 ;ShovePlayer X Reg ("Shove" the Player "Fetched" to "Reference 2" through freespace with the X velocity given by User Register 21)
: U21 ;User Register 21
; ----------
#1129 ;ShovePlayer Y Chr0 ("Shove" the Player "Fetched" to "Reference 2" through freespace with the Y velocity given by User-created "Active Variable" 6 of the Player "Fetched" to "Reference 0")
: a6 ;User-created "Active Variable" 6 of the Player "Fetched" to "Reference 0"
; ----------
#1126 ;ShovePlayer X Obj0 ("Shove" the Player "Fetched" to "Reference 2" through freespace with the X velocity given by "Extra Variable" 12 of the Object "Fetched" to "Reference 0")
: E12 ;"Extra Variable" 12 of the Object "Fetched" to "Reference 0"
; ----------
#1131 ;ShovePlayer Y Const ("Shove" the Player "Fetched" to "Reference 2" through freespace with a Y velocity of 1024)
:1024 ;Velocity 1024 (1024/256 = 4 pixels per frame)
1195 - Func_ShovePlayer_Diag_Reg
1196 - Func_ShovePlayer_Diag_Chr
1197 - Func_ShovePlayer_Diag_Obj
1198 - Func_ShovePlayer_Diag_Const
(Description)
#1195 ;ShovePlayer Diag Reg ("Shove" the Player "Fetched" to "Reference 2" through freespace with the X and Y velocities given by User Registers 7 and 8)
: U7 ;(Reg X) User Register 7
: U8 ;(Reg Y) User Register 7
; ----------
#1196 ;ShovePlayer Diag Chr0 ("Shove" the Player "Fetched" to "Reference 2" through freespace with the X and Y velocities given by User-created "Active Variable"s 17 and 18 of the Player "Fetched" to "Reference 0")
: a17 ;(Chr0 X) User-created "Active Variable" 17 of the Player "Fetched" to "Reference 0"
: a18 ;(Chr0 Y) User-created "Active Variable" 18 of the Player "Fetched" to "Reference 0"
; ----------
#1197 ;ShovePlayer Diag Obj0 ("Shove" the Player "Fetched" to "Reference 2" through freespace with the X and Y velocities given by "Extra Variable"s 0 and 1 of the Object "Fetched" to "Reference 0")
: E0 ;(Obj0 X) "Extra Variable" 0 of the Object "Fetched" to "Reference 0"
: E1 ;(Obj0 Y) "Extra Variable" 1 of the Object "Fetched" to "Reference 0"
; ----------
#1198 ;ShovePlayer Diag Const ("Shove" the Player "Fetched" to "Reference 2" through freespace with X and Y velocities of 4096 and 1024)
:4096 ;(Const X) Velocity 4096 (4096/256 = 16 pixels per frame)
:1024 ;(Const Y) Velocity 1024 (1024/256 = 4 pixels per frame)
1182 - Func_ShovePlayer_ObjectBounds
(Description)
#1182 ;ShovePlayer ObjectBounds ("Shove" the Player "Fetched" to "Reference 2" through freespace to the top of the "MainBounds" Box of the "Current Object")
: 0 ;Player to Top of Object
; ----------
#1182 ;ShovePlayer ObjectBounds ("Shove" the Player "Fetched" to "Reference 2" through freespace to the left of the "MainBounds" Box of the "Current Object")
: 2 ;Player to Left of Object
1186 - Func_ShovePlayer_Within_TiledObject_X
1187 - Func_ShovePlayer_Within_TiledObject_Y
(Description)
#1186 ;ShovePlayer Within TiledObject X ("Shove" the Player "Fetched" to "Reference 2" through freespace on the X axis to the outside of the Object's Tile Solidity in the direction specified by "Extra Variable" 4 of the "Current Object")
: E4 ;"Extra Variable" 4 of the "Current Object"
; ----------
#1187 ;ShovePlayer Within TiledObject Y ("Shove" the Player "Fetched" to "Reference 2" through freespace on the Y axis to the outside of the Object's Tile Solidity in the direction specified by "Extra Variable" 5 of the "Current Object")
: E5 ;"Extra Variable" 5 of the "Current Object"
1188 - Func_ShovePlayer_Within_TiledObject_Diag
(Description)
#1188 ;ShovePlayer Within TiledObject Diag ("Shove" the Player "Fetched" to "Reference 2" through freespace to the outside of the Object's Tile Solidity in the direction specified by "Extra Variable"s 4 and 5 of the "Current Object")
: E4 ;(Obj0 X) "Extra Variable" 4 of the "Current Object"
: E5 ;(Obj0 Y) "Extra Variable" 5 of the "Current Object"
1189 - Func_ShovePlayer_Riding_TiledObject_X
1190 - Func_ShovePlayer_Riding_TiledObject_Y
(Description)
#1189 ;ShovePlayer Riding TiledObject X ("Shove" the Player "Fetched" to "Reference 2" through freespace on the X axis along with the Object's Tile Solidity in the direction specified by "Extra Variable" 4 of the "Current Object")
: E4 ;"Extra Variable" 4 of the "Current Object"
; ----------
#1190 ;ShovePlayer Riding TiledObject Y ("Shove" the Player "Fetched" to "Reference 2" through freespace on the Y axis along with the Object's Tile Solidity in the direction specified by "Extra Variable" 5 of the "Current Object")
: E5 ;"Extra Variable" 5 of the "Current Object"
1191 - Func_ShovePlayer_Riding_TiledObject_Diag
(Description)
#1191 ;ShovePlayer Riding TiledObject Diag ("Shove" the Player "Fetched" to "Reference 2" through freespace along with the Object's Tile Solidity in the direction specified by "Extra Variable"s 4 and 5 of the "Current Object")
: E4 ;(Obj0 X) "Extra Variable" 4 of the "Current Object"
: E5 ;(Obj0 Y) "Extra Variable" 5 of the "Current Object"
1192 - Func_ShovePlayer_Within_SolidObject_X
1193 - Func_ShovePlayer_Within_SolidObject_Y
(Description)
#1192 ;ShovePlayer Within SolidObject X ("Shove" the Player "Fetched" to "Reference 2" through freespace on the X axis to the outside of the Object's "MainBounds" Box in the direction specified by "Extra Variable" 4 of the "Current Object")
: E4 ;"Extra Variable" 4 of the "Current Object"
; ----------
#1193 ;ShovePlayer Within SolidObject Y ("Shove" the Player "Fetched" to "Reference 2" through freespace on the Y axis to the outside of the Object's "MainBounds" Box in the direction specified by "Extra Variable" 5 of the "Current Object")
: E5 ;"Extra Variable" 5 of the "Current Object"
1194 - Func_ShovePlayer_Within_SolidObject_Diag
(Description)
#1194 ;ShovePlayer Within SolidObject Diag ("Shove" the Player "Fetched" to "Reference 2" through freespace to the outside of the Object's "MainBounds" Box in the direction specified by "Extra Variable"s 4 and 5 of the "Current Object")
: E4 ;(Obj0 X) "Extra Variable" 4 of the "Current Object"
: E5 ;(Obj0 Y) "Extra Variable" 5 of the "Current Object"
Viewport Setting:
#1407 ;Player Force VPUpdate (Update the viewport corresponding with the Player "Fetched" to "Reference 2" based on his automatic viewport settings)
Setting the "Current Player":
#1428 ;Set CurrPlayer ByID (Set Player 1 as the "Current Player")
: 0 ;Player 1
; ----------
#1428 ;Set CurrPlayer ByID (Set the Player whose ID is stored in User Register 3 as the "Current Player")
: R3 ;Value stored in User Register 3
1429 - Func_Set_CurrPlayer_Reg
1430 - Func_Set_CurrPlayer_Chr
1431 - Func_Set_CurrPlayer_Obj
(Description)
#1429 ;Set CurrPlayer Reg (Set the Player whose pointer is stored in User Register 20 as the "Current Player")
: U20 ;User Register 20
; ----------
#1430 ;Set CurrPlayer Chr (Set the Player whose pointer is stored in User-created "Active Variable" 1 of the Player "Fetched" to "Reference 0" as the "Current Player")
: a1 ;User-created "Active Variable" 1 of the Player "Fetched" to "Reference 0"
; ----------
#1431 ;Set CurrPlayer Obj (Set the Player whose pointer is stored in "Extra Variable" 8 of the Object "Fetched" to "Reference 0" as the "Current Player")
: E8 ;"Extra Variable" 8 of the Object "Fetched" to "Reference 0"
1184 - Func_Set_Player_Collision_Area
(Description)
#1431 ;Set Player Collision Area (Set Player 1 as the "Current Player", and to Collision Area 5, the incoming area beyond the horizontal end of the looping area)
: 0 ;Player 1
: 5 ;The incoming area to the right of the loop's horizontal end
; ----------
#1431 ;Set Player Collision Area (Set Player whose ID is stored in User Register 6 as the "Current Player", and to the Collision Area whose ID is stored in User Register 7)
: R6 ;(Player) Value stored in User Register 6
: R7 ;(ColArea) Value stored in User Register 7
1185 - Set Player Collision Area CurrObj
(Description)
#1431 ;Set Player Collision Area (Set Player 1 as the "Current Player", and to the Collision Area that the "Current Object" is in)
: 0 ;Player 1
; ----------
#1431 ;Set Player Collision Area (Set Player whose ID is stored in User Register 9 as the "Current Player", and to the Collision Area that the "Current Object" is in)
: R9 ;(Player) Value stored in User Register 9