How to Write a Board Game Manual

I was going to do a picture of all my manuals together until I realized how much work that would take.

Hi there! I’m Dan Thurot. I’m not a professional at writing board game rulebooks, but I’m here to tell you how to write board game rulebooks.

If you’re now thinking, Well why the hell should I listen to you?, here’s my response: Wow. That was kind of harsh. Maybe I’m just some dummy, but I’m a dummy who reads a freighter’s worth of board game manuals every year, and I’ve come to appreciate certain details that make them easier to read and much better at actually teaching me your game. What follows is a list of ten tips I’d appreciate you following the next time you’re seated at your computer trying to type out your new board game’s rules.

From the manual for Kemet, which is so enthusiastic about telling you the goal of the game that it dispenses with a front page at all.

#1: Your First Objective is to Explain My Objective

This might seem obvious. Crap, I agree, it’s really obvious. Still, I feel like I have to say it because some rulebooks like to play clever and squirrel away their victory conditions in the middle of a wall of text or at the end of the book. After all, victory comes at the end of the game, right?

The thing is, there’s very little worse than getting halfway through a manual and still having no idea how all the different actions, options, and components tie together. So your game has a betrayal mechanic? Great! But why should I care? Is the goal to betray as many people as possible? To keep from being betrayed? To find the traitor and bury them?

You need to tell me why I’m doing the stuff your game has me doing, otherwise there’s no purpose or context to the actions you’re explaining over the course of your manual. Instead of holding back, tell me the objective as soon as possible. Make it your first paragraph if possible. And rather than being smart and telling me that the goal of your game is to discover the goal of the game, go write that in your rulebook, because in that rare case, that’s the goal.

From 3012, a modestly innovative deck-building game that nonetheless has way too much lore for me to pick through.

#2: Lore Is Great, But Use It Wisely

I love theme! Not only does it transform your game from an abstract combination of pieces into a coherent whole, it also lends your game’s actions a feeling of internal logic. If I’m playing a game about being a fireman, for instance, I’ll instinctively know that a fire-axe breaks through obstacles while the fire-hose is for pacifying rioters. And if you include a little vignette at the beginning of the rulebook that introduces me to the game’s characters, I’ll be aware that the Hotshots dig trenches, the Chief orders people around and isn’t very patient, the firehouse mascot is a mean dalmatian who the Chief saved from the pound, and Doug takes unnecessary risks because his wife left him.

Or maybe that’s an example of theme being misapplied.

I’m not arguing that your theme has to have a certain volume to it, or that too much is a bad thing. Yes, sometimes that’s the case: in the above picture there are four massive pages of silly exposition that have literally nothing to do with the game they’re prefacing other than the fact that the game takes place in a future Mesoamerican setting and so does that huge story. On the flipside, it’s even possible for your thematic introduction to be too short. Merely telling me, “This is a dungeon crawl” only acquaints me with the barest explanation of the game’s genre, and I probably already knew that because the cover showed a warrior, a mage, an improbably-endowed ranger elf babe, and a hobbit crawling into a dungeon.

Rather, use as much theme as your game needs in order to explain the connection between the theme and the mechanics. Some games need a short paragraph, others make good use of short stories. Twilight Imperium, for instance, can get away with a fairly lengthy intro because it lends the game’s actions a sense of import, intrigue, and urgency, all of which support the game’s intended method of play. None of this is necessarily easy, but you were smart enough to design a board game, so I’m sure you can figure out how much lore to drip-feed us.

From Archipelago, which had such a great manual that I was inspired to write this article.

#3: List Your Bits

Not only is including a component list a handy way to show off your game’s production values, it also serves a couple very helpful functions.

For one, sometimes I zone out when I’m reading rulebooks. Maybe that’s disrespectful or something, but it isn’t usually a problem because I’ve read so many in the past that I can usually figure out what I missed. If I’m not sure what you mean when you refer to “Rune Mutation Cards” though, I can use your component list to quickly catch up, and I appreciate not having to skim back through the rules to figure it out.

Second, sometimes parts go missing. Sometimes it’s a problem on the manufacturer’s end, which I’ve had happen a couple times and didn’t discover until we were playing and suddenly had no idea why we didn’t have the right or enough components. Other times, people have these really oblivious kids who put things, like colorful eurocubes, up their noses. And it would be a shame to not know that you were missing a game piece when you rush your kid to the doctor’s office for an obstructed nasal passage, because then you couldn’t ask your doctor to hold onto anything he fished out of there.

#4: General, Then Specific

Don’t rush right into the rules. Start from a broad perspective and give me an outline of the phases of your game, and then deal with each one by one. Learning a game is easier when we can visualize where each phase is in the overall structure of one game round rather than being hurled into the water and not being sure whether we’re in a pool or the ocean.

#5: What Can I Do? (Not What Can’t I Do?)

The same advice as above also applies to explaining special circumstances. Tell me what the actions are, and leave exceptions for very last, usually listed as a helpful reference. It’s confusing to be told that I can’t do stuff, unless it’s something like “Don’t discuss the objectives on your hidden objective card.” Most of the time, pointing out things I can’t do is a surefire way to confuse me.

From Dungeon Heroes. I didn't like Dungeon Heroes all that much. Poor Dungeon Heroes.

#6: Ambiguities are ???

If you aren’t clear what I mean, I’ll finish that sentence: Ambiguities are shit.

For instance, the above picture shows a rulebook that’s explaining the role of four heroes. The Warrior, it tells us, “Slays monsters without taking damage by moving onto their square.” One might assume that therefore all our heroes can slay monsters, it’s just that they take damage instead of avoiding it. Turns out that isn’t the case, and I needed to consult a rules clarification thread in order to resolve what seemed like a logical conclusion to me. This is sub-optimal.

Unfortunately, ambiguities are often in the eye of the beholder, so perhaps the best course of action is to…

#7: Give Examples

For anything reasonably tricky, give examples. Even if your battle system makes absolute sense to you — maybe you just take the damage and subtract the defender’s armor value and there you go, voilà, only a moron wouldn’t get it. But instead of assuming I’m intelligent and have the vocabulary to understand all your big words, just pretend I’m dumb and give an example. If I understand the rule, I’ll skip the example anyway, and if I’m having a brain-fart or a bad day, I can take the extra thirty seconds to acquaint myself with it. I promise to feel appropriately idiotic if it turns out to be simple enough that a water buffalo could understand it.

A great example of doing this well is the Mage Wars rulebook, which includes a four page (these are big pages) walkthrough on how to play the game. It covers basically everything major, from building a custom deck for each example mage and then through multiple example rounds. Better yet, Mage Wars uses this walkthrough to teach me the game before even bothering with any of the nitty-gritty, so reading one simple section gives a comprehensive idea of how an entire game plays.

Archipelago again, keeping me on track by making sure I don't forget any little rules.

#8: Remind Me Like I’m Your Spouse

As in, remind me a lot. Especially if your game has lots of little nitpicky rules. And maybe this is asking a lot, but please offset these in a different color that I can quickly skim and ignore if it turns out I did indeed remember that particular rule.

The above picture has a great example from the rulebook for Archipelago, which does a fantastic job of reminding players of certain easily-forgotten rules.

#9: Proofreed

You’re a genius at making games, it’s true. The very fact that you’re making a board game means you’re probably a pretty smart human being, and quite possibly very attractive too. Still, you aren’t infallible (unless you’re the Pope and you’re making a game too, in which case, pardon me). You’re going to make mistakes. Sometimes with spelling, or a misplaced number, or just an instance of poor phraseology. This is linked to many of the points I’ve listed above, and the best way to stamp it out is proofreading.

Now, if you think that you can be your own proofreader, you haven’t been hearing what I’ve been saying. You might be a fantastic writer and a pro editor, but you’re too familiar with your own work to be trusted with it — especially since you already understand how your game works, so how the hell will you be able to single out poor explanations or failed examples? You must have someone else look at your work, preferably people who don’t know how to play your game and get to learn from your prototype manual. Feel free to sit and watch them learn how to play your game, but be the creepy type and don’t offer help when they reach a confusing part, because you’ll discover a whole slew of weaknesses to shore up before your rulebook is ready for the general public.

This is actually sort of a negative example. Kemet comes with a handy reference, but it's one of those irritating multi-language things that makes you flip through more pages than necessary.

#10: Now I’m Playing Your Game… Help Me Out!

It drives me nuts when I have an obviously well-constructed game on my table, I’m ready to play, and it turns out there’s no player aid or manual index to help me out when questions inevitably arise. Now I have to flip through your big floppy rulebook looking for answers; or, worse yet, I have to go and look on the internet.

Even the simplest games are often full of small complexities. So remind me what you want: outline your phases, remind me that I’m allowed to draw a card when I lose a battle, list and explain those fifty power-up tiles with arcane symbols on them, remind me of the weird numerical values of each building type when I tax my populace, etc. The more you can cram onto your reference card (or whatever you use), the less I’ll have to dig around for clarifications.

Dear readers: What advice would you give to the author of a board game rulebook? What drives you nuts, and what do you like?

Posted on July 11, 2013, in Board Game, How-to and tagged , . Bookmark the permalink. 11 Comments.

  1. I hate it when a rule book uses a word in multiple different ways in a rule book. I just finished my first game of the Star Trek deckbuilding game and found a couple choices lacking. For instance, they name one of the character/ship attributes “Diplomacy”. But Diplomacy is also an action (a verb!) for taking over a ship. As in: “I choose to diplomacy that Klingon Bird-of-Prey”. And to make matters worse, the diplomacy action is resolved by comparing speed+diplomacy attributes of the opposing ship versus your own. So you don’t NEED diplomacy to successfully diplomacy, you just have to be really fast. At the end of the game, I hated the word.

  2. Maybe this’ll sound terrible, but I really don’t like multi-language rulebooks. Like the one for Ladies and Gentlemen. They end up being way too big, when I’d rather just have them pack multiple smaller rulebooks into the box.

    • That’s racist, man.

      Nah, just kidding! I know exactly what you mean. The L&G rulebook is a beast. And heaven forbid someone at the table needs to look something up (they will though, since lots of the icons on the gossip and servant cards are so hard to decipher at first) and can’t figure out what to do because the last page (where the reference is for the final language) is in German. Unless you’re German, then you win this time.

      #12. Don’t Make Your Rulebook a Beast

  3. Good writing, The Innocent! Very interesting! I love Board Games Manuals, and, in the other hand, it´s something that I miss in PC games nowadays… 😦

    • Good point! I remember taking the manual for the original Starcraft on a post-Christmas vacation, and drooling over the unit descriptions and wishing I was home playing the game.

  4. At the moment I’m making my second board game and it was really interesting to read your instructions …and to notice that I may have done something right 😀 thanks!

    I’m writing the manual in English and, not being a native speaker, I find it pretty challenging to use the right expressions. For example, I’m not quite sure whether you throw or shoot or roll the dice – or whether it even matters…

    My question is: do you know any pages where I could learn that secret language of the games? 🙂

    • I don’t, unfortunately. I’d recommend hiring a native English speaker to help out with those little idiomatic expressions.

    • For board games you roll the dice.

      I am a native English speaker and college graduate. I would be happy to help you with your rule book, whether you just want a quick review or more in depth help with the writing.

      Here is my website; it is still pretty new and not completely finished, but you can see my services and contact me through here: http://www.polyserv.wordpress.com

  1. Pingback: Fallen Kickstarter of Karez | SPACE-BIFF!

  2. Pingback: Games manuals | Chair of Indefinite Studies

Leave a comment

This site uses Akismet to reduce spam. Learn how your comment data is processed.