Launchpad/README.md

Launchpad

Launchpad is a simple but configurable plugin able to make any placeable block into a launchpad which launches a player with the desired velocity in their current or in a fixed direction. While anything can be a launchpad, pressure plates have more accurate hit-detection as that's built into Minecraft.

Launchpads will prioritize values specifically set for that launchpad. If not set, they will look for material-specific values. If not set, they will look for the generic velocities in the config.

Known problems

Jumping on a pressure plate causes a Player moved too quickly message in the console, and the player is weirdly glitched for a moment

This happens because the server thinks the player moved faster than it should, and forcefully prevents the player from moving. Increasing moved-too-quickly-multiplier in spigot.yml may fix this issue.

Commands

Note that changing a property for a block which isn't currently a launchpad will turn the block into a launchpad. If you alter several launchpad values in succession, they'll all be applied to the next block you right-click.

Command	Arguments	Description
/launchpad add		Makes the clicked block into a launchpad.
/launchpad remove		Removes the clicked block as a launchpad.
/launchpad abort		Clears any unprocessed launchpad modifications.
/launchpad verticalVelocity	Decimal number / "null"	Sets the vertical velocity for the clicked launchpad. Use "null" to unset.
/launchpad horizontalVelocity	Decimal number / "null"	Sets the horizontal velocity for the clicked launchpad. Use "null" to unset.
/launchpad velocities	<Decimal Number / "null"> <Decimal Number / "null">	Sets the horizontal and vertical velocities at once. The first argument is for the horizontal velocity.
/launchpad fixedDirection	NORTH / SOUTH / EAST / WEST / "null"	Sets a fixed direction the launchpad will launch every player. Use "null" to unset.
/launchpad:reload		Reloads the configuration and launchpads from disk.

Permissions

Permission	Description
launchpad.admin	Gives all other permissions
launchpad.modify	Allows modifying, adding and removing launchpads.
launchpad.reload	Allows reloading the launchpad plugin.

Configuration

Node	Type	Description
launchpad.materials	List	A list of materials, or material tags (+TAG_NAME), which are always treated as launchpads, without the need for manual registration.
launchpad.materialWhitelist	List	A list of materials, or material tags (+TAG_NAME), which can be manually turned into launchpads. Use this to prevent unwanted blocks from being turned into launchpads.
launchpad.verticalVelocity	Decimal number	The vertical (upwards) velocity applied to launchpads if not specified otherwise.
launchpad.horizontalVelocity	Decimal number	The horizontal (sideways) velocity applied to launchpads if not specified otherwise.
launchpad.materialVelocities.<MATERIAL>.horizontalVelocity	Decimal number	The horizontal (sideways) velocity applied to launchpads of type <MATERIAL> if not overridden for the block.
launchpad.materialVelocities.<MATERIAL>.verticalVelocity	Decimal number	The vertical (sideways) velocity applied to launchpads of type <MATERIAL> if not overridden for the block.
launchpad.particles.trailsEnabled	True / False	Whether to enable particle trails behind players
launchpad.particles.trailSpawnDelay	Positive integer	The amount of ticks (1 second = 20 ticks) between each time the particle(s) of a trail should be spawned.
launchpad.particles.trailType	Particle	The type of trail to spawn behind launched players.
launchpad.particles.randomTrailType	True / False	Whether to use a random value from randomTrailWhitelist as the trail on each launch.
launchpad.particles.randomTrailWhitelist	List	A list of all particles selectable for random trails.
launchpad.particles.enabled	True / False	Whether to display some kind of particle effect above manually added launchpads.
launchpad.particles.spawnDelay	Positive integer	The amount of ticks (1 second = 20 ticks) between each time the particle(s) should be spawned again. Depending on the particle, higher values will make the particle(s) completely disappear and reappear.
launchpad.particles.particle.mode	SINGLE / SQUARE / PYRAMID / SPHERE / CIRCLE / CUBE	The mode used for drawing particles. SINGLE directly spawns the particle(s) in one spot above the launchpad. The other ones spawn particles a bunch of times in a pattern.
launchpad.particles.particle.type	Particle	The type of particle to spawn above launchpads.
launchpad.particles.particle.amount	Positive integer	The amount of particles to spawn. Use 1 if mode is anything except SINGLE, unless you know what you are doing!
launchpad.particles.particle.offsetX	Decimal number	The offset, or spread of the particles in the X direction, relative to the launchpad
launchpad.particles.particle.offsetY	Decimal number	The offset, or spread of the particles in the Y direction, relative to the launchpad
launchpad.particles.particle.offsetZ	Decimal number	The offset, or spread of the particles in the Z direction, relative to the launchpad
launchpad.particles.particle.heightOffset	Decimal number	The amount of blocks above the launchpad the particle should spawn. 0.5 = half a block. 1 = one block.
launchpad.particles.particle.particleDensity	Decimal number	A definition for the number of particles used to draw shapes. The number of particles is basically distance / particleDensity, so lower numbers create a more dense shape.
launchpad.particles.particle.extra	Decimal number	Extra data for the specific particle. Check the Spigot documentation for details.
launchpad.particles.materialParticles	Configuration section	This section allows specifying different particle configurations for a material or a material tag. So you'd set materialParticles.LIGHT_WEIGHTED_PRESSURE_PLATE.type to set the particle type for LIGHT_WEIGHTED_PRESSURE_PLATE.

License

Launchpad is licensed under the GNU Public License Version 3.0. This includes every source and resource file. See the HEADER file for a more detailed license description.