Pipecannon.lua

From PGE Wiki
Jump to: navigation, search

Download latest version

A library which lets you create pipe cannons.

Documentation

This API stores all warps in your level in a table and lets you customise them using the fields below:

pipecannon.exitspeed Table of values corresponding to warp IDs. Sets speed at which the player will get launched. When set to 0, the warp behaves like normal.
pipecannon.angle Table of values corresponding to warp IDs. Defines the angle of deviation in which the player should be shot, clockwise from perpendicular. Must be between -90 and 90. See visual aids below.
pipecannon.SFX Set sound effect for exiting the warp. Default value is 22 (bill blaster).
pipecannon.effect Set visual effect for exiting the warp.
Upward
PipeCannonDiagram2.png
Downward
PipeCannonDiagram4.png

The fields angle and exitspeed can also be defined for each warp individually.

Example

local pipecannon = API.load("pipecannon")

-- You can set firing speeds for each warp.
pipecannon.exitspeed = {10,20,30,10,20,15,25,10,20,50,10,30,0,40}
-- Will ignore speeds set for doors/instant warps. When set to 0, the warp behaves like normal.

-- Firing angles, clockwise from perpendicular
pipecannon.angle = {[10]=-3, [11]=13} -- Warp IDs can be specified more easily with this syntax
pipecannon.angle[12] = 45	-- Also can be set individually. 12 - warp number; 45 - firing angle
pipecannon.angle[14] = -10

-- Any of the three syntax styles shown will work for either exitspeed or angle

-- Sound effect for firing
pipecannon.SFX = 22 -- default value (bullet bill sfx), set to 0 for silent
-- Visual effect for firing
pipecannon.effect = 10 -- set to 0 for none

Example level: http://www.mediafire.com/download/dfif4mnef64glbo/Pipe+Cannon+API+Test.zip