Repository files navigation

This tool is intended to convertTwee projects (that you can export fromTwine) intoSAM projects. With it, it's possible to create Sega Master System adventure games using Twine.

Currently, it supports a subset of the Twine commands; so far, only links and images are supported.

You can see a working example at example/simple; run Compile.bat to make it run.

You can get a compiled version fromhttps://dl.dropboxusercontent.com/u/1235428/sms/twee2sam-2015-05-27a.rar

Or from theSMSPower thread

The images must be in the png format, have a resolution of 256x144, and can't have more than 16 colors. Be careful to not use an exceedingly detailed image, as SAM can't display images with more than 320 tiles.

Displays an image

Forces a page break or, if there's no text, just waits for the user to press any button.

Sets the value of a variable to the value of the expression.

Examples:

<<setvariable1 = 42 >>

<<setvariable1 =variable2 >>

<<setvariable1 = 42 - 24 >>

<<setvariable1 =variable1 +variable2 >>

In general terms, the basic Twine math operations (+, -, /, * ) are supported in the form:

target = operand1 operator operand2

Either or both of the operands can be variables. Compound operations (in parenthesis) are not supported.

Outputs the value of the given variable in a text passage.

Conditionally executes the code between <<if >> and <<endif>> if theexpression evaluates totrue.

Examples:

<<ifvariable1 is True >>...<<endif>>

<<ifvariable1 gt 99 >>...<<endif>>

<<ifvariable1 ltvariable2 >>...<<endif>>

Note: <<else>> is not implemented yet.

Calls a passage of text - this is effectively how twee2sam converts the Twine passages into a link story, however it can also be used to call out to specific subroutines.

Examples:

<<call inventory_passage >>

Acall is most often used to jump to another text passage, once you have finished with the 'subroutine' passage, you can return back to the original position with thereturn command:

Example:

<<return>>

The two above commands allow you to have 'subroutines' unconnected from your main Twine story which can be called from anywhere without using the traditional [[link]] syntax and then return back to the previous position - this would normally require the subroutine to know which passage to return back to, which does not work easily with subroutines that may be called from many different locations (high score screens, inventory/player status, a pause menu etc).

Jumps to a passage, when you don't need a return to the original passage. The difference is on the command. This will generate a S.A.M "j" command, instead of a "c" command.

Plays music in.epsgmod format, as exported byMod2PSG2

Acts as a non-breaking space.

Certain commands, like <<set>gt;, <<print>gt; and <<if>gt; can take an expression as a parameter; the supported operators are:

• expr1orexpr2: returnstrue if either of the expressions is true.
• expr2andexpr2: returnstrue only if both of the expressions are true.
• notexpr: turnstrue intofalse and vice versa.
• constants:true andfalse are supported; also, any numeric value that equals zero is considered false, while any nonzero numeric values are considered true.

• expr1<expr2: returnstrue if the value of the first expression is less than that of the second expression.
• expr1<=expr2: returnstrue if the value of the first expression is less than or equal to that of the second expression.
• expr1>expr2: returnstrue if the value of the first expression is more than that of the second expression.
• expr1>=expr2: returnstrue if the value of the first expression is more than or equal to that of the second expression.
• expr1==expr2: returnstrue if both expressions have the same value.
• expr1isexpr2: returnstrue if both expressions have the same value.
• expr1!=expr2: returnstrue if the values of both expressions differ from each other.
• expr1<>expr2: returnstrue if the values of both expressions differ from each other.

• expr1+expr2: Adds the values of both expressions.
• expr1-expr2: Subtracts the value of the second expression from the first expression.
• expr1 *expr2: Multiplies the values of both expressions.
• expr1/expr2: Divides the value of the first expression by the second expression.
• expr1%expr2: Returns the remaider of the division of the value of the first expression by the second expression.

2015-01-08: Implemented actual expression support.

2015-01-04: Added print, basic math functions and gt, and lt operators. Added external tiddlywiki source files.

2014-02-19: Updated SAM to use PS Gaiden compression.

2014-02-17: Corrected word wrapping bug.

2014-02-01: Implemented the <<set>> and <<if>> commands.

2014-01-30: Implemented text buffer overflow checking and also implemented the <<pause>> command.

2014-01-27: Generated a compiled exe version of twee2sam.py, so that people can use the tool without having Python installed.

2014-01-26: Implemented image displaying support.

2014-01-23: First working version. Links are supported.