======Resources======

//This page is written by Leon Arnott and is separate from the Twine documentation.//

This page collects a number of useful external Twine resources, macros and scripts. Don't forget that more resources and hints are available on the [[frequently asked questions]] page and the [[example files]] page.

=====Story formats=====

See the [[story format]]s page to learn how to install other story formats.
====SugarCube====

[[http://www.motoslave.net/sugarcube/|SugarCube]], by Thomas M. Edwards, is an alternative version of Sugarcane. It comes with a rewritten game engine, several additional utility macros, and a save slot menu instead of a bookmark link. Several SugarCube features inspired the development of Twine 1.4.

====Tin Cans====

[[http://www.gritfish.net/blog/tin-cans/tin-cans-making-twine-work-phones/|Tin Cans]] is a story format designed for making mobile phone games - it includes a macro for changing between jQuery UI themes, 

====Snowman====

[[http://twinery.org/forum/index.php/topic,1600.msg3621.html|Snowman]] is a minimal story format by Chris Klimas, designed solely for Javascript programmers. It offers no macros and no ability to import macros, instead requiring the author to write Javascript code directly into the passage.

=====Macros=====

Leon Arnott has developed a number of macros:

  * [[http://www.glorioustrainwrecks.com/node/5020|<<cyclinglink>>]]: A popular macro. It creates a link that, when clicked, changes its text and alters a variable.
     * Gregory Weir has made a version of this macro for use in SugarCube, available [[http://ludusnovus.net/2013/11/18/cyclinglinks-in-twine-sugarcube/|here]].
  * [[http://www.glorioustrainwrecks.com/node/5024|<<hoverlink>>]]: A passage link whose text changes when your cursor hovers over it.
  * [[http://www.glorioustrainwrecks.com/node/5108|<<goto>> and <<timedgoto>>]]: A macro that sends the player to another passage, either immediately or after a delay.
  * [[http://www.glorioustrainwrecks.com/node/5061|<<playsound>>]]: A macro that uses HTML5 audio to play MP3 or Ogg files. An easy way to add sound to Twine! Comes with a number of supplementary macros to control playback.
  * [[http://www.glorioustrainwrecks.com/node/5462|<<replace>>]]: A macro that makes links that transform or modify the passage. Comes with a broad suite of variant macros that provide a good deal of variety to Twine interactions:
      * %%<<timedreplace>>%% changes, adds or removes text after time has passed.
      * %%<<hoverreplace>>%% alters text when the mouse is over it.
      * %%<<revise>>%% creates a link that transforms text inside a %%<<revision>>%% macro.
  * [[http://www.glorioustrainwrecks.com/node/5198|<<timedloop>>]]: A macro similar to <<timedreplace>> that simply re-runs the contained macros over and over until the passage is left.
  * [[http://www.glorioustrainwrecks.com/node/5486|<<autolink>>]]: A macro that automatically turns words inside it into links to passages.
  * [[http://twinery.org/forum/index.php/topic,690.0.html|<<rememberall>>]]: A macro that causes every variable used in the story to be [[<<remember>>]]ed. Comes with a %%<<forgetall>>%% equivalent for resetting all the variables.

Other macros by other people:

  * [[http://www.glorioustrainwrecks.com/node/5475|<<playbgm>>]]: An alternative music macro that plays a YouTube movie invisibly in the background of your story.
  * [[http://twinery.org/forum/index.php/topic,705.0.html|<<pane>>]]: This macro adjusts Sugarcane so that two passages can be displayed at the same time, horizontally apart.
  * [[https://groups.google.com/forum/#!msg/tweecode/lA4bIX3iegg/k7trCW6v53kJ|<<map>>]]: A macro for creating and controlling a "mini-map" in the StoryMenu. (Note: code may need modification to work in 1.4.1 or later)
  * [[https://gist.github.com/dariusk/4644530|<<randomword>>]] by Darius Kazemi: A macro that uses [[http://developer.wordnik.com|Wordnik]] to produce random English words based on certain parameters.
  * These [[http://ivybaumgarten.com/twine/macros/gdoc/|Google Sheets macros]] by Devon Baumgarten potentially allow Google Sheets to be used as a Twine game's offline data storage.
  * [[http://www.ohiofi.com/blog/how-to-use-google-drive-to-store-high-scores-for-twine-games/|<<googleForms>>]] is, in the same vein, a macro that can use your Google Drive to store high scores (or other data).
  * [[https://github.com/th0ma5w/Twine_Fullscreen_YouTube|<<fsyoutube>>]] puts a full page background video from YouTube behind your Twine passages.
=====Stylesheets=====

  * Leon has also developed several stylesheets which can be used directly in Twine games, available [[http://www.glorioustrainwrecks.com/node/5163|here]].
  * Richard Sharpe has a number of [[http://twinery.org/forum/index.php/topic,691.0.html|stylesheets]], too.
=====Web design resources=====

  * [[http://www.google.com/fonts/|Google Fonts]] is the most common host of web fonts that you can use in your  Twine stories. See [[frequently_asked_questions#how_to_import_google_web_fonts|here]] to learn how to use them in your story.
  * [[https://developer.mozilla.org/|Mozilla Developer Network]] is a respected and accurate reference for information about CSS, Javascript and HTML. You can look up the intricacies of CSS attributes by Googling "mdn" followed by the name of the CSS property or attribute you're interested it.
  * Many sites offer resources for working with CSS. Some of these include:
    * [[http://www.colorzilla.com/gradient-editor/|ColorZilla's Gradient Editor]] for generating CSS backgrounds with gradient colour fills.
    * [[http://paletton.com/|Paletton]] is a colour palette generator. Fiddle with the colour wheel, then click "Color Tables" to obtain the HTML colour values of each part of the palette.

=====Source code=====

To obtain the source code of any Twine game, simply do the following:

  * Download the HTML file of the game.
  * Open Twine, and select Import -> Compiled HTML File, from the File menu.
  * You can then open the HTML file to import all of its passages.

Note: this will not import the story format used for the game, nor any of its metadata.

=====Other=====

  * [[http://twinegarden.tumblr.com/|Twine Garden]] is a tumblr blog celebrating aesthetics in Twine node maps, run by noted Twine author Porpentine. It accepts submissions.