Modifies the parameters of an existing Explod. This controller is subject to future change. Any code relying on this controller is not guaranteed to work in the future.
Required parameters:
Optional parameters:
- ID = id_no (int)
id_no specifies an ID number for this explod. Used to identify particular explods in triggers and controllers that affect explods.
- space = space (string)
Specifies the coordinate space in which the explod is to be created. Valid values for space are:
- screen - This coordinate space maps to the screen. The upper-left corner is 0,0 and the lower-right corner is ScreenWidth,ScreenHeight (refer to the triggers with these names). Explods created in screen space are not affected by camera movement or zoom.
- stage - This coordinate space maps to the stage space in which players reside. 0,0 is the center of the stage at ground level. Explods created in screen space are affected by camera movement and zoom. This is the default.
- pos = x_pos, y_pos (int)
If the explod is not bound, off_x and off_y specify the position at which to create the explod. If the explod is bound, off_x and off_y specify the offset from the object to which the explod is bound to.
- postype = string (string)
Deprecated -- use space, pos and facing parameter instead
string specifies the postype -- how to interpret the pos parameters. In all cases, a positive y offset means a downward displacement. Valid values for postype are the following:
- p1 - Interprets pos relative to p1's axis. A positive x offset is toward the front of p1. This is the default value for postype.
- p2 - Interprets pos relative to p2's axis. A positive x offset is toward the front of p2.
- front - Interprets xpos relative to the edge of the screen that p1 is facing toward, and ypos relative to the top of the screen. A positive x offset is away from the center of the screen, whereas a negative x offset is toward the center.
- back - Interprets xpos relative to the edge of the screen that p1 is facing away from, and ypos relative to the top of the screen. A positive x offset is toward the center of the screen, whereas a negative x offset is away from the center.
- left - Interprets xpos and ypos relative to the upper-left corner of the screen. A positive x offset is toward the right of the screen.
- right - Interprets xpos and ypos relative to the upper-right corner of the screen. A positive x offset is toward the left of the screen.
- none - Interprets off_x and off_y as an absolute position. This is the default value for postype for characters with a mugenversion of 1.1 or higher.
- facing = facing (int)
Set facing to 1 to have the explod face in the same direction as the positive off_x, and -1 to have the explod face in the opposite direction. Defaults to 1.
- vfacing = facing (int)
Set vfacing to -1 to have the explod display vertically flipped, or 1 to have the explod display vertically unflipped. Defaults to 1.
- bindID = bind_id (int)
ID number of a player or helper to bind to. The position of a bound explod is relative to the object that it is bound to. Special values are -1 (bind to any single player) and -2 (do not bind). Defaults to -2. The bindtime parameter is required if bindID is not -2. Screen space explods cannot be bound.
- bindtime = bind_time (int)
Specifies the number of game ticks to keep the explod bound. After the bindtime has expired, the explod will be explod will no longer be bound to the bind point, and will maintain its position (unless affected by the vel or accel parameters). If bind_time is -1, then the explod will be bound until the explod is removed or another controller affects the bindtime.
- vel = x_vel, y_vel (float)
Specifies initial X and Y velocity components for the explod. These are interpreted relative to the explod's "facing" direction. These default to 0 if omitted.
- accel = x_accel, y_accel (float)
Specifies X and Y acceleration components for the explod. These default to 0.
- random = rand_x, rand_y (int)
Deprecated
Causes the explod's bind point to be displaced by a random amount when created. rand_x specifies the displacement range in the x direction, and rand_y specifies the displacement range in the y direction. For instance, if pos = 0,0 and random = 40,80, then the explod's x location will be a random number between -20 and 19, and its y location will be a random number between -40 and 39. Both arg1 and arg2 default to 0 if omitted.
- removetime = rem_time (int)
If rem_time is positive, the explod will be removed after having been displayed for that number of game ticks. If rem_time is -1, the explod will be displayed indefinitely. If rem_time is -2, the explod will be removed when its animtime reaches 0. The default value is -2.
- supermove = bvalue (boolean)
Deprecated -- use supermovetime parameter instead
Set supermove = 1 to have the explod persist until the end of a super pause, regardless of the value of removetime. Defaults to 0.
- supermovetime = move_time (int)
Specifies the number of ticks that the explod will be unfrozen during a SuperPause. Used where you want the explod to be animated during a SuperPause, such as for custom super sparks. Defaults to 0.
- pausemovetime = move_time (int)
Specifies the number of ticks that the explod should be unfrozen during a Pause. Defaults to 0.
- scale = x_scale [,y_scale] (float)
x_scale and y_scale specify the scaling factors to apply to the explod in the horizontal and vertical directions. Both default to 1 (no scaling) if omitted.
- angle = angle (float)
angle specifies the explod's drawing angle in degrees. Defaults to 0.
- yangle = y_angle (float)
y_angle specifies the explod's drawing angle around the y-axis in degrees. Defaults to 0.
- xangle = x_angle (float)
x_angle specifies the explod's drawing angle around the x-axis in degrees. Defaults to 0.
- sprpriority = pr (int)
pr specifies the drawing priority for the explod. Animations with higher priority get drawn over animations with lesser priority. For instances, setting sprpriority = -3 will cause the explod to be drawn under most characters and other explods, which usually have sprpriority >= -2. Defaults to 0 if omitted.
- ontop = bvalue (boolean)
Set ontop = 1 to have the explod drawn over all other sprites and background layers. This parameter has precedence over sprpriority. Defaults to 0.
- shadow = shad_r, shad_g,shad_b (int)
If shadow is not 0, a shadow will be drawn for the explod, else no shadow will be drawn. Defaults to 0.
- removeongethit = bvalue (boolean)
Setting this to 1 will cause the explod removed if the player gets hit. Defaults to 0.
- ignorehitpause = bvalue (boolean)
If this is 1, the explod will be animated independently of the player that created it. If set to 0, it will not be updated when the player is in hitpause. Defaults to 1.
- trans = trans_type (string)
Overrides the explod's animation transparency settings. See the Trans controller for details. An "alpha" parameter may be specified if trans_type is an additive type. If omitted, does nothing.
Notes:
The position of an explod that is bound to a player is determined only after all player updates have completed (compared to helpers, which are created relative to the player's immediate position when the controller was executed). This behavior is necessary to make explods bind properly to the player's screen position.
For example, assume the player has an x velocity of 5 and a position of (160,0). If an explod is created with an offset of 0,0 relative to p1, then the explod's actual screen position will be 165,0.
Example:
none