SpellbookMaster - Manual

Contents

Introduction

SpellbookMaster is a playaid for the d20 and Pathfinder roleplaying game systems. During those intense roleplaying sessions it is all too easy to lose time browsing through the big, hardcover books looking for spell descriptions. SpellbookMaster makes it easy to find spells fast.

You can search for spells by name, class, level, domain, description or any other piece of information. You can create collections of spells by dragging spells from the list to the collection area on the left. Add spells to collections by dragging them on the collection.

To get you started, SpellbookMaster can automatically import d20 System Reference spells from the Wizards of the Coast website and also Pathfinder reference spells from www.d20pfsrd.com. You can also import or create and edit your own spells.

Features

Here's a short highlight list of some the most important features of SpellbookMaster.

  • Support for spells in d20 3.5 (a.k.a. Dungeons & Dragons v3.5) and Pathfinder formats.
  • Find spells by name, spell caster class, spell level, spell school/domain.
  • Edit and create spells.
  • Create collections spells like playlists in iTunes.
  • Print favorite spells for quick reference.
  • Import reference spells automatically from the Internet.
  • Import spells from RTF and plain text documents.
  • Export spells as HTML documents.
  • Interoperable standards-based document file format.
  • Share documents with iPhone app.
  • Spotlight and Quick Look plugins.

Spell Document Window

Spell Document Window or Spell List Window is the main window for each document. On the left side there's the Library and all Collections. On the top right, there's the list of all spells in the currently selected collection or Library. Selecting a spell or multiple spells shows their info in the info area, just below the spell list.

Main spell list can be sorted by spell name, level, school/domain, range and other categories. Sorting by level is a bit tricky, because a spell can be of different level depending on class. If no class is selected for filtering, lowest level of a spell is used. If a class is used to filter results, that class will be used to determine the level of the spell. If multiple classes are used for filtering, only one class is used for determining spell level. Level column contents will change depending whether classes are being filtered or not, making it easier to see the level of each spell.

Filtering Spells

SpellbookMaster has great filtering abilities to help you find the spells you need. You can search spells based on their name using the Search field in the toolbar. Additional filterings allow you to show spells that match a specific class/cleric domain, are of specific level, or belong to a certain school/domain. Show All Spells (Cmd-L) command clears all filterings.

Additional filtering lists (Class, Level, and School) show only those classes, levels and schools used in that document. When document is opened and edited, any unknown classes are added to the classes list. Global list can be edited from the preferences.

Spell Sheet Window

Spell Sheet Window is meant for printing out a quick sheet for the most important info of spells. Also, it contains areas to mark the number of spells available for your spell caster per day, what is the save DC when casting spells and what are the different ranges based on your character's level.

To show the Spell Sheet Window click the Show Spell Sheet button in the toolbar or choose Show Spell Sheet (Cmd-T) from the Window menu.

Editing and Creating Spells

New to SpellbookMaster 2.0 is the ability to edit spells. Edit spells by double clicking on a spell or by selecting a spells and choosing Edit Spell (Cmd-Alt-E) from the Spell menu. You're presented with a window which allows you to edit all aspects of a spell. Area and target has a popup which selects which text is used to describe the area and/or target description. Some spells have a specific target, others affect an area, and some spells can be cast to a specific target or area. The choice made in the popup will be what SpellbookMaster shows.

You can also create new spells. Choose New Spell from the Spell menu. This will open a window for you to edit the newly added spell.

HTML and table support

SpellbookMaster supports HTML formatting in spell descriptions. This includes tables, which were not too pretty in old versions. HTML support gives the opportunity to create nicely formatted tables.

Spell description has to begin with <p> or <div>, and end with </p> or </div> (respectively). This way SpellbookMaster knows the description is HTML formatted.

For the tables you need to use the HTML table syntax, which is pretty easy, but needs some work and precision to get right. Place the table between <table> and </table>. Each row is starts with <tr> and ends with </tr>, and each cell on each row is marked with <td> and </td>.

Also note there's a special element <th> (for table header) you can use instead of <td>. This gives the table header a special look to make it stand out from normal rows.

Each normal paragraph of text in the description begins with <p> and ends with a </p>. You don't need to use those inside table cells.

Example

<table>
<tr>
	<th>Animal Kind</th>
	<th>Given Bonus</th>
</tr>
<tr>
	<td>Animal 1</td>
	<td>bonus 1</td>
</tr>
<tr>
	<td>Animal 2</td>
	<td>bonus 2</td>
</tr>
<tr>
	<td>Animal 3</td>
	<td>bonus 3</td>
</tr>
</table>
		

Collections

SpellbookMaster allows you to arrange spells in collections. Collections allow you to create lists of favorite spells, or group them by your spellcasters or their differently styled sets, for example.

Create a new collection by choosing New Collection (Cmd-Shift-N) from the Collection menu, by clicking the plus button at the lower left corner of the Spell Document Window or by dragging spells to the empty area of the Library and collections pane. You can add spells to collections by dragging spells to collections.

Document Sharing

Document Sharing allows you to share all your open SpellbookMaster documents to SpellbookMaster running on iPhone, iPod touch or iPad. Enable Document Sharing by choosing "Document Sharing..." from the File menu. A window appears telling you Document Sharing is switched on. From the window you can stop sharing or choose to keep sharing active even after you close the window.

You can change the name of your Document Sharing server from the SpellbookMaster preferences window. You can also enable Document Sharing from the preferences. This way you don't have to keep the Document Sharing window open.

Document Sharing only works if your Mac and iPhone, iPod touch or iPad are connected to the same Wi-Fi network. You can use your Mac to create a network, if your Mac has Wi-Fi hardware.

Document Sharing causes your Mac to become a file server. Anyone can download your open documents if they can access your computer using the Internet or through a local Wi-Fi network. Keep Document Sharing enabled only as long as needed.

Importing Spells

Importing Automatically

Just choose "Download d20 System Reference Spells..." or "Download Pathfinder Reference Spells..." from the File menu. SpellbookMaster will show a window that displays download progess for the files. After downloads have finished, spells are prosessed. A new document with the spells appears. Enjoy!

Importing Manually

Here are instructions on how to import spells manually to SpellbookMaster.

  1. Go to the SRD home page and download all the spells as one zip file. It's the Spells link at the bottom of the page under title Grouped SRD Downloads. Here's a direct link.
  2. Open the Spells.zip by double clicking it in the Finder. Finder will decompress the files and create a folder named Spells.
  3. Open the Spells folder and select all files except MagicOverview.rtf.
  4. Drag the selected files onto a spell list window’s collection or spell list area. You'll notice the cursor changes to a one with a green plus sign when it is over the correct areas of the window.
  5. Wait a moment while SpellbookMaster parses the spells from the RTF files.
  6. Done! Enjoy your spells!

Exporting Spells

SpellbookMaster can export spells as an HTML document. Select the spells you want to export, or deselect to export all spells, and then select Export Spells from the File menu. The exact title of the command varies based on whether you have spells selected or not.

Preferences

SpellbookMaster has a few preferences. You can set it to remember open documents so they're opened automatically when SpellbookMaster is opened. You can set Document Sharing to be permanently on. Please read all about Document Sharing before doing that, as it can have security implications. You can also set a name by which you can identify your shared documents on the network.

You can add and edit custom class names and domains. Built-in classes and domains are shown gray, and cannot be edited or removed. The Abbreviation column (on the left) has the abbreviation that is found from the spell description (for example: Level: Sor/Wiz 6, Water 7, WrMg 5). When a new abbreviation is found, it is added to the list. Full class/domain name is set to be same as the abbreviation. The full name can be edited in the Class/Domain Name column. That name is then shown in the filtering list in the main window.

Spotlight and Quick Look

SpellbookMaster has Spotlight and Quick Look plugins. Both only work with files saved in the new file format.

Spotlight plugin supplies the names of the spells to the index. Spell contents or other attributes are not indexed. This means that you can search for spells by name using Spotlight, but not by other attributes or description text.

Quick Look plugin displays a preview of all the spells in a file. This preview looks the same as exporting the spells as an HTML document.

Migrating From Older Versions

SpellbookMaster's file format has changed over time, so there's some migration going on when loading files of older format.

Migrating From 1.5 to 2.0

SpellbookMaster's file format has changed radically from 1.5 to 2.0. Old versions of SpellbookMaster cannot open documents saved with 2.0. There's not extra information being saved, but the format is faster to save and load, and it's based on property list binary XML format which gives some interoperability with other applications.

Migrating From 1.0 to 2.0

Migrating from 1.0 to 2.0 is not really supported or recommended. It might work, but it is recommended to first upgrade 1.0 documents to 1.5 format, and then upgrade the 1.5 format document to 2.0 format. You will lose information about marked spells when upgrading this way. Migrating through 1.5 creates a collection with the marked spells so that information won't be lost.

Migrating From 1.0 to 1.5

SpellbookMaster 1.5 opens documents saved in 1.0 format and automatically converts them to the new format when saved. When opening a 1.0 document SpellbookMaster 1.5 will create a new collection named Marked spells based on what spells were marked. Collection system replaces spell marking and SpellbookMaster 1.5 doesn't save mark information for SpellbookMaster 1.0 to read.

SpellbookMaster 1.0 will open documents created with SpellbookMaster 1.5, but, when saved, the document will lose all created collections.