# MC1253¶

MC1253 is an IC that can play a firework show using 2 available scripting languages implemented into CraftBook. Scripts go inside the /config/craftbook/fireworks folder, and come in either .txt or .fwk file formats.

## Firework Languages¶

There are two firework languages in CraftBook. A simple one called Basic, which is good for quick single firework scripts. Or Fyrestone, which is a bit more involved, but ultimately better for larger scripts.

### Basic¶

Basic files end with the .txt filetype. The syntax of ‘Basic’ is the following,

The xOff, yOff, and zOff parameters refer to the offset that the firework will be launched from.

The duration refers to the duration of the flight, in seconds.

The shape refers to the ‘type’ of the firework. The shape can be any from this list, or any provided by another mod.

The r,g,b colour, and r,g,b fade, are the base colours and fade colours respectively.

The effect is an optional parameter that can currently be either trail or twinkle, to apply those effects to the firework.

#### Example¶

launch:0,2,0;1;burst;255,0,0;0,0,255;twinkle


### Fyrestone¶

Fyrestone files are .fwk files.

Fyrestone follows the lines of some very basic languages. It supports multiple effects per firework, and each firework can be launched multiple times.

The language is effect based, where you can add effects to a defined variable.

It is done like this:

To define a variable, or to add to a variable... Type:

start <variableName>

After that, you enter all the effects you want in this format:

set.color 255,0,0
set.shape burst
set.trail
set.twinkle


You do not need to include all of these, you can select whichever ones you want. However shape is required.

And to end off the construction, you type build <variableName>, signifying that effect is done. To add a second effect to the variable repeat the process.

Durations are not bound to variables, they are set seperately. To set a duration, type: duration <duration in seconds> The duration will be applied until it is changed again.

Locations are done the same way, location x,y,z

You can also wait a certain number of ticks using... wait <ticks>

You can have spaces between the lines to make it neater, and start lines with a # to make it a comment.

#### Commands¶

 Command Parameters Description Example start Name Starts building a new firework, the first parameter is the name. start MyFirework build Name Finishes building a new firework and stores it, the first parameter is the name. build MyFirework set.color R,G,B Sets the color of the firework. Multiple can be set for random colours. set.color 255,0,0 set.fade R,G,B Sets the color of the firework.set.trail: set.fade will set color for trail. Multiple can be set for random colours. set.fade 0,255,0 set.shape Shape Sets the shape of the firework. The shape can be any from this list, or any provided by another mod. set.shape creeper set.twinkle None Enables twinkles on the firework. set.twinkle set.trail None Enables trails on the firework. set.trail set.flicker None Enables flicker on the firework set.flicker duration Time Sets the time (in seconds) the firework takes to explode. duration 1.5 location X,Y,Z Sets the offset spawn point for the firework from the IC sign. This is not absolute coordinates, but an offset! location 0,32,0 launch Name Launches the specified firework. launch MyFirework wait Ticks Waits for a specified amount of ticks. wait 20 sound SoundName X,Y,Z Volume Pitch Plays a sound at an offset. sound FUSE 0,0,0 2.0 1.0

#### Example¶

# Adding 2 effects to variable a

start a
set.color 255,255,255
set.type creeper
set.flicker
build a

start a
set.color 0,255,0
set.type lball
set.trail
build a

# Launch a
launch a

# Launch a another 2 times in different locations
location -1,2,3
launch a
location 4,-2,7
launch a

# Make another effect and launch it at the sign
start b
set.color 30,255,80
set.type burst
set.trail
build b
location 0,0,0
launch b


## Sign Lines¶

1. FIREWORK
2. [MC1253]
3. Firework Script Name
4. Stop on Low (true/false)

## IC Pins¶

### Inputs¶

• Runs script on high

• None

## Permissions¶

Node Description Default Role
craftbook.ic.safe.mc1253 Allows creation of the Programmable Firework Display (MC1253) IC. user