Skip to content
madmagic007 edited this page Jan 29, 2025 · 22 revisions

Setup

This guide explains how to setup & configure all of the aspects to this plugin.
Setup Guide

Fixtures are the core component of this plugin. They are the "spots" or "lights", where all of the effects are emitted from.

Grouping fixtures into groups, allows you to control all of the grouped fixtures together using only the group name. You can create as many groups as you want, each fixture can be in multiple groups at the same time.

Motions are what makes the fixtures rotate in different directions. Only changes the direction the head is facing (if head is enabled) and the direction of the beam if effect is set to guardian or particle shape is set to line.
Motions are a set of vectors.

States are collections of settings for fixtures, which can be applied to given fixtures or groups.
Used in sequences, scenes or individually.
With a state you can define:

  • turn effect on or off
  • active motion or rotation
  • active sequence
  • effect type
  • particle type (if applicable)
  • particle shape (if applicable)
  • particle color (if applicable)

Sequences are a sequential list of states. Each state gets applied to the given fixture or group after the defined delay. The delay of each individal step is configurable.
You can also define an initial state, which will apply first before the sequential list executes and a final state, which will get apllied after the sequence gets stopped. The intial and final states are not included in the loop.
You can configure how many times it loops.

Scenes are like sequences, a sequential list of states, except with scenes you choose in each step which fixtures or groups are given what state.
Each "step" has a delay after wich it will apply it's state to it's defined fixtures or groups.
You can configure how many times it loops.

Vars (using vars)

Varibles allow you to template and change any number, such as delays for motions, sequences and scenes, at runtime with a single command.
Any number (except for location and rotations) can be defined as a var.

Commands (using commands)

Commands in RaveVisuals are a collection of any other (minecraft or from other plugin) commands, which can collectively be executed when desired.
This is most usefull for turning on redstone lamps, placing/removing blocks etc. But can also be used to trigger multiple scenes or sequences at the same time.

The web API allows you to control fixtures or set vars remotely or locally over the network.
This might allow for some sweet integrations into professional pyrotechnics software.

Clone this wiki locally