Version 3 of the BGP Library Extension, polished and ready to bring Game Making to a whole new level of simplicity! Features 23 useful Actions. This download includes the Extension, a .PDF with installation instructions and a .gm81 editable file which showcases how some of the new Actions can be used!
Action Descriptions![The BGP Library in GameMaker]( "The BGP Library in GameMaker")
MOVEMENT
Jump to Previous: This Action sets the (x, y) coordinates of an Object to its previous position.
Move to Contact with Instance: This Action is similar to Game Maker’s default “Move to Contact” Action, but now allows you to specify with what Object you would like it to move into contact with. The arguments for this Action are:
- direction: The direction to move in.
- maximum: The maximum distance to move in.
- Object: The Object to “move to contact” with.
Jump to Radial Position: This Action moves an Object to the x and y coordinates of the vector determined by the arguments distance and angle.
- Distance: The distance to jump (in pixels).
- Direction: The direction to move in.
DRAW
Draw Variable Health: This Action draws a healthbar with a user-defined variable instead of Game Maker’s built-in “health” variable. It must be placed in the Draw Event in order to function. The arguments for this Action are:
- Variable: The Variable to draw the healthbar with.
- x1: The x coordinate of the upper-left corner of the healthbar.
- y1: The y coordinate of the upper-left corner of the healthbar.
- x2: The x coordinate of the bottom-right corner of the healthbar.
- y2: The y coordinate of the bottom-right corner of the healthbar.
- Bar colour: The colour with which to draw the healthbar. You may choose from several options.
Draw Self: This Action draws the Object’s Sprite using its local variables. This is important because if an Object has anything in its Draw Event, it will stop drawing its Sprite unless it is told to. It must be placed in the Draw Event in order to function.
MESSAGE BOX
Change Message Box Properties: This Action allows you to change the Message box’s background, its button, transparency value, and its (x, y) position on screen. The arguments for this function are:
- Background: The Background to be used by the Message Box.
- Button: The Sprite to be used by the Message Box button.
- Opacity (0-1): The alpha (transparency) value of the Message Box.
- Message x: The x coordinate of the Message Box.
- Message y: The y coordinate of the Message Box.
Change Message Box Text Properties: This Action allows you to change the font, size, colour and style of the Message box’s text.
- Font: The font to be used by the Message Box.
- Size: The size of the font to be used by the Message Box.
- Colour: The colour of the font to be used by the Message Box.
- Style: The style of the font to be used by the Message Box.
Change Message Box Button Text Properties: This Action allows you to change the font, size, colour and style in the Message box’s button text.
- Font: The font to be used by the Message Box’s button.
- Size: The size of the font to be used by the Message Box’s button.
- Colour: The colour of the font to be used by the Message Box’s button.
- Style: The style of the font to be used by the Message Box’s button.
MORE QUESTIONS
Test Sprite: This Action tests if the Object has the specified Sprite.
Test Room: This Action tests if the Object is in a specific Room.
Test Alarm: This Action tests the value of a specified Alarm.
Check Object in Direction: This Action looks for an instance of a specified Object at the x and y coordinates of the vector determined by the specified distance and angle.
Test Angle: This Action tests if the angle between the two specified coordinates, (x1, y1) and (x2, y2) is equal to, smaller than, or larger than a specified value.
Test Obstruction: This Action checks if there is a specified Object between points (x1,y1) and (x2,y2). The “Not Me” option refers to whether or not to include the “checking” Object. This is useful in the case where an Object is checking for other instances of itself. This Action uses “precise collision detection” by default, but it must be enabled in the Sprite Properties.
Test Distance to Object: This Action tests if the distance between the Object performing the Action, and the Object specified (based on the Sprite Origin point) is equal to, smaller than, or larger than a specified value.
Test Distance to Point: This Action tests if the distance between the Object performing the Action and the specified coordinate is equal to, smaller than, or larger than a specified value.
Test Distance between Points: This Action tests if the distance between two sets of specified coordinates is equal to, smaller than, or larger than a specified value.
INSTANCE_ID
Set Created Instance to Variable: This Action creates an instance of the specified Object at the specified coordinates and stores the instance_id of the created instance as a specified variable. The Arguments of this Action are:
- Variable name: The name of the Variable to set the instance_id of the newly created Object to.
- Object: The Object to create an instance of.
- x: The x coordinate of the instance to be created at.
- y: The y coordinate of the instance to be created at.
Set instance_id to Variable: This Action stores the instance_id of the specified Object which is the located at a position, closest to that position, or furthest from that position as a specified variable.
- Variable name: The name of the Variable to set the instance_id of the found Object to.
- Object: The Object to look for.
- Position: The Object is either at (Position) closest to (Nearest) or furthest from (Furthest) from the coordinates specified (below).
- x: The x coordinate of the instance.
- y: The y coordinate of the instance.
Test Existence of Instance: This Action tests if an instance exists. This can either be an Object name, or a variable containing the id of a specific Object obtained using one of the first two Actions.
Perform a User Defined Event with Instance: This Action will perform a User Defined Event in the Object with the instance specified. This can either be an Object name, or a variable containing the id of a specific Object obtained using one of the top first Actions.
Set Variable in Instance: This Action will set a variable in the instance specified. You can also specify if you want to make the variable an array, and if so, which index in that array. The Arguments for this Action are:
- instance_id: The instance to set the Variable in. This can either be an Object name, or a variable containing the id of a specific Object obtained using one of the first two Actions.
- Variable: The name of the variable to set in the instance.
- Value: The value to set the Variable to.
- Array: Whether the Variable you are setting should be an array or not.
- Index: If the Variable is an array (Array is selected as “true”) this argument specifies which index in that Array you are setting.
With Instance Destroy: This Action will destroy the specified instance. This can either be an Object name, or a variable containing the id of a specific Object obtained using one of the first two Actions.
