Chapel's Custom Macro Collection
- The Dialog API Macro Set
- The UI Macro (new!)
- The Done Macro
- The Mouseover Macro (new!)
- The Event Macros
- The Fading Macro Set
- The Swap Macro Set (new!)
- The File System Macro Set
- The First Macro
- The Fullscreen Macros
- The Message Macro
- The Notify Macro
- The Operations API
- The Playtime System
- The Simple Inventory System
- The Typing Simulation Macro
To install these macros, all you need is the code. It is highly recommended that you install the minified version (found in the
scripts/minified/ directory), as these versions will have improved performance. You will only need the non-minified versions if you plan to edit the code in some way.
To install these macros, you will need to be using the most recent version of SugarCube 2 in most cases, and this is almost never the version that comes with Twine 2. See SugarCube's website for updating / installation instructions.
For Twee2, refer to its documentation for how to create the tagged passages you need.
For Tweego, simply place the code in
.css files as appropriate and include them in your directory / command line options just as you would any other code files.
If you're having issues, please try some of these solutions.
Before copying the script you want from GitHub, you can find a button above the code on the right called
raw. Try using this code instead, as it takes you to a page with only the code allowing you to copy it and paste it much more easily, and preventing potential encoding issues.
Make sure you're using the latest version of SugarCube 2 and of your preferred compiler.
If none of those common solutions help you with the problem, open an issue here on the repo. Be sure to tell me the exact version of SugarCube (found in the
Change story format menu option in Twine 2) and the exact version of your compiler (for Twine 2, the bottom right on the story list).
Also try to screen grab or copy/paste any specific error messages.
If a script doesn't seem to be working right, remember:
- Everything is case-sensitive--
<<MESSAGE>>are not going to point to the same macro.
- Follow the instructions carefully. There are a few places where my macros break with traditional SugarCube things, like the orders of arguments and stuff. I'm trying to hew closer to SugarCube's standards moving forward, though.
- Make sure you're using SugarCube 2, the most recent version you can. This is very rarely the same as the version packaged with Twine 2 or the other compilers.
If you're reasonably sure you've read the docs and are using the right version and such, feel free to open an issue.
I Need Help!
If you're having an issue with these macros and suspect that it's operator error rather than a bug, you can still open an issue, but a faster way to get help would be to post in one of these Twine communities:
Regardless of where you seek help, you'll want to provide links to the scripts you're using for your potential answerers. Don't expect people to know what "Chapel's fading macros" are or how they work just from the name.
You Don't Write Good...
Please take a minute and help me out by reporting any errors in the documentation via an issue, or pull request a fix if you've got the time and know-how. Both are greatly appreciated.
WAIT! WHERE'S THE X MACRO???????
Some macros were just too good for this world. Some turned out to be really bad ideas. Some were just so poorly written that they'll take a long time to reimplement. That said, if a macro you need / want / like isn't here, you can go here to download the original collection as it was in it's prime.
Credit and Attribution
This code is dedicated to the public domain. You don't need to provide credit, attribution, or anything else. You could even pass it off as your own! (Would be mean.)
If you do wish to credit me, you can credit me as Chapel, but please do not imply that I directly worked on your game.
If you have any questions or concerns about this, refer to the license.
Fun stuff and details.
Ever wonder what the most popular macros here are?
I don't actually track usage data or anything, but according to pure traffic numbers, the top three are:
- The fading macro set.
- The simple inventory.
- The first macro.
It's been a little over a year (almost exactly 13 months, actually) between the very first public release of this repo on May 30, 2017 and the "official" v2 release on June 29, 2018. I started working on v2 in November of 2017, with the first public updates showing up late that month.
And like writing a novel, you can get better at it if you're willing to suck at first. Be willing to suck. You will get there.