Chapel's Custom Macro Collection (v2.9.0)
- Gameplay Systems and Mechanics
- Interface and Style
- User Interaction and Events
- Grammar and Language
- Utilities and Other
To install these macros, all you need is the code. You can get the code by copy and pasting from the repo, or by generating a custom download using the download utility. If you use the downloader, select the scripts you want and click the
Create Download button. Extract the files from the downloaded zip file and install the
bundle.css files (see below).
If you opt to get the files from GitHub, It is highly recommended that you install the minified versions (found in the
scripts/minified/ directory of the repo), 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. Links to both the minified and pretty scripts are available on the individual documentation pages for each macro / system.
[!WARNING] 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
.cssfiles as appropriate and include them in your directory / command line options just as you would any other code files.
[!NOTE] If you're using Cyrus Firheir's excellent Twee3 Language Tools for VSCode you can find macro definitions in the
chapel.twee-config.yamlfile in the root of this repository. You can copy the whole file over and remove the macros you don't have installed. You don't have to remove the macros you aren't using, but they will make the tool that much more effective if you do. More on where to put the file and how to use the language tools can be found at the above link.
If you're having issues, please try some of these solutions.
If you're getting the code from GitHub, 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.
If you downloaded the files with the download utility, make sure to open the files and copy them with a text editor, not a word processor.
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).
[!NOTE] Please try to screen grab or copy/paste any specific error messages, and provide sample code or steps to reproduce the issue if possible.
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.
Have ideas? I'm open to contributions, both in the form of ideas and code. Open an issue or pull request if you want to help out or make suggestions for new macros or systems.
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:
- The Twine Category at IntFiction.org
- The Official Twine Discord Server
- The Unoffical Twine Subreddit
[!TIP] 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 that.
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.
Credit and Attribution
This code is dedicated to the public domain. You don't need to provide credit, attribution, or anything else if you don't want to.
[!NOTE] If you do wish to credit me, which I always appreciate, you can credit me as Chapel, but please do not imply that I directly worked on your game.
[!TIP] If you have any questions or concerns about this, refer to the license or reach out to me.