Skip to content

04. Fixtures

Exenco edited this page Apr 20, 2024 · 2 revisions

What is a fixture?

Fixtures are all lights that are controlled by a lighting controller.

Beacon

Description

Creates glass stack at specified location to display input colour via beacon. It does not create the beacon structure.

Config

OffBlock:String - used to set block whenever beacon is turned off.
Count:int - used to set amount of blocks being used including the one specified in location.

Coding

Channel Name Type Size
001 Enabled HTP 8 bit
002 Red LTP 8 bit
003 Green LTP 8 bit
004 Blue LTP 8 bit

BlockUpdater

Description

Creates simple function of switching a block on and off.

Config

EnabledState:String - block which is resembling on-state.
DisabledState:String - block which is resembling off-state.
Lit:boolean - Whether block is lightable and shall be used as such (e. g. redstone_lamp)

Coding

Channel Name Type Size
001 Enabled HTP 8 bit

Crystal

Description

Uses an end crystal to summon a beam.

Config

MaxDistance:String - maximum distance for the beam.

Coding

Channel Name Type Size
001 Distance HTP 8 bit
002 Pan LTP 16 bit hi
003 Pan 2 LTP 16 bit lo
004 Tilt LTP 16 bit hi
005 Tilt 2 LTP 16 bit lo

FireworkLauncher

Description

Pretty self explanatory: Sets of firework. When set to full it fires periodically. Otherwise just once.

Config

TickSize:int - amount of system ticks in-between launches.

Coding

Channel Name Type Size
001 Enabled HTP 8 bit
002 FireworkType LTP 8 bit

FogMachine

Description

Shoots out particles in direction from given location.

Config

TickSize:int - amount of system ticks in-between particle spawns.
MaxOffset:double - max particle offset.
MaxVelocity:double - max particle velocity.
Yaw:double - directional yaw.
Pitch:double - directional pitch.

Coding

Channel Name Type Size
001 Velocity HTP 8 bit
002 Particle LTP 8 bit
003 Count LTP 8 bit
004 Offset LTP 8 bit

LogoDisplay

Description

Displays a logo or any soft of particle image. They can be set in respective config files.

Config

TickSize:int - amount of system ticks in-between particle spawns.
Size:double - max size multiplicator.
Yaw:double - directional yaw.
Pitch:double - directional pitch.

Coding

Channel Name Type Size
001 Enabled HTP 8 bit
002 Type LTP 8 bit
003 Size LTP 8 bit

MovingHead

Description

Creates moving/rotating head for displaying laser.

Config

MaxDistance:double - maximum distance for a laser to go.
TickSize:int - amount of system ticks in-between colour change call.\

Coding

Channel Name Type Size
001 Enabled HTP 8 bit
002 Pan LTP 16 bit hi
003 Pan 2 LTP 16 bit lo
004 Tilt LTP 16 bit hi
005 Tilt 2 LTP 16 bit lo
006 Distance LTP 8 bit
007 ColourChange LTP 8 bit

ParticleFlare

Description

Spawns particle on given location.

Config

TickSize:int - amount of system ticks in-between particle spawns.
MaxXOffset:double - max. x offset.
MaxYOffset:double - max. y offset.
MaxZOffset:double - max. z offset.
MaxTimt:double - max. time.
MaxSize:double - max. size.\

Coding

Channel Name Type Size
001 Count HTP 8 bit
002 Particle LTP 8 bit
003 Offset LTP 8 bit
004 Time LTP 8 bit
005 Red LTP 8 bit
006 Green LTP 8 bit
007 Blue LTP 8 bit
008 Size LTP 8 bit

SongSelector

Description

Selects and plays a song for all players to hear.

Config

None - Not even location is necessary.

Coding

Channel Name Type Size
001 Selector HTP 8 bit

Creating your own fixture

Either clone the git and work directly or add the plugin as library and register your fixture like so:

LightShow lightShow = (LightShow) Bukkit.getPluginManager().getPlugin("Light-Show");
registerFixture("Example", Example.class);

As of the current version (1.1) there are 4 APIs you can use: GuardianBeamApi, LogoApi, ParticleFlareApi and ParticleLineApi.