Script formatting:
Lines like this contain fresh additions.
Blank lines
You can have blank lines for spacing anywhere.
Parts
Introduce a part by having a line like:
part: the name of the part
In other words, first "part:", then a space, then the name of a part.
For example: part: Hamlet
To right-align the part's dialogue, put > at the end of the line.
For example: part: Horatio >
The part will receive a color. To set another color, add another line just after like:
hue: number between 0 and 255
For example: hue: 140
A part can have one or more aliases to provide a separate/shorter form, like this:
alias: another name
In other words, first "alias:", then a space, then another name for the part.
For example: alias: prince
Dialogue
A line of dialogue looks like this:
part name: dialogue
In other words, first the name of a part, then ":", then a space, then the dialogue.
For example: Hamlet: Alas, poor Yorick!
The part name must be introduced with a part line before.
It can also be a part's alias or an abbreviation of a name or alias as long as it unambiguously matches one part.
A line of dialogue can also carry direction, like this:
part name (direction): dialogue
In other words, first the name of a part, then the direction within parentheses, then ":", then a space, then the dialogue.
For example: Hamlet (nervously): Should we really spend the night in this haunted mansion? There's a smaller, haunted cabin down the road that would require significantly less lantern kerosene.
If you have a second, third and so on line of dialogue, you have lines with just dialogue and the most recent part will be assumed.
Actions
A line describing a part's action looks like this:
part name action
In other words, first the name of a part, then a space, then the action.
For example: Hamlet effortlessly juggles a skull, a powered-on chainsaw and an apple, taking bites out of the apple every now and then
Narration/events
A line with narration looks like this:
[events]
In other words, any line completely surrounded by "[" and "]".
For example: [The sun sets over Elsinore.]
Instructions can be given like this:
% instructions
In other words, any line started with "%" and a space.
For example: % The performer is now expected to name their 10-20 favorite six digit prime numbers. If you just can't decide, you are free to list more.
You can also add a break like this:
-- (two dashes)
Part name mentions
To reference another part's name in a way that will be updated when the part is renamed, use:
@part name
In other words, first "@" and then the full name of a part.
For example: @Hamlet
Errors
If the formatting engine gets confused, you will receive an error message explaining what's going wrong.