The Chord Manual
The Chord Manual is the book for Chord. It teaches the language from an empty file to a published story, by building one game, The Relighting, a chapter at a time. It has forty chapters in eight parts and seven appendices, and it is written for Chord 4.1.0 and Sharpee 5.7.0.
Read it
- Read the book online, one chapter to a page.
- Download the PDF (1.7 MB, 595 pages, laid out at 6 by 9 inches).
- Download the EPUB (0.5 MB), for an e-reader.
The companion folders
The book prints the lines it teaches and not every line of the story. The story as it stands at the end of each chapter is in a folder named for the chapter, and each chapter from the fifth on begins by copying from one.
https://sharpee.net/chord-manual/4.1.0/relighting/
Each folder can be downloaded whole by adding .zip to its name, as in
chapter-05.zip.
What it covers
- A first story. The shape of a story file, its header, the player, and how to build, play and read an error.
- The world. Rooms, things, containers, doors, the trait words, light and regions.
- Making things happen. States, clauses, conditions, scoring and time.
- Words. Phrases, a thing's own words, the standard messages, new verbs and new kinds of thing.
- People. People who act, conversation, inner lives and more than one protagonist.
- Larger machinery. Machines, vehicles, open water and the opt-in systems.
- Presentation. Sound, music, pictures and the page the player sees.
- Proving and shipping. Test trees, claims and publishing.
The book has two reading tracks beside its main text. Boxes headed "Under the Hood" name the platform concept a line of Chord becomes, and boxes headed "From another system" compare Chord with Inform 10 and TADS 3.
Which version
This edition is pinned to Chord 4.1.0 and Sharpee 5.7.0. Every example in it
was compiled, and every quoted reply was played, on that release. To follow it,
install that release as chapter 4 describes; sharpee --version should print
Sharpee 5.7.0 · Chord 4.1.0.