Skip to content

Tome Editor — Narrative-tree viewer and editor

License

Notifications You must be signed in to change notification settings

Oleg-Avdeev/Tome-Edtior

Repository files navigation

Tome : narrative tree editor

Tome is an editor for dialogue and story trees that allows you to plan your entire game in one place. This format allows you to design the tree, write all of the character lines, notate actions and commands and store any additional data you might need for your game: scenes, backgrounds, visuals, music cues.


  • Automatic tree building : Just write your story! No need to move blocks, editor will do its best to keep your diagram clean, readable and beautiful. Color code your blocks to make the tree even easier to understand 🎄
  • Projects : Sometimes one tree isn't enough — instead of working with individual files Tome opens project folders and allows you to switch between multiple trees;
  • Table editting : Jump into the table mode to review your story data, set meta keys like music and visual cues;

  • Work anywhere : Editor is built using Electron, which means that you will be able to run it on your Mac, Windows or Linux machine. And maybe eventually online...
  • Autosave : Don't worry about losing your progress, it's being saved after every change you make
  • Script editing : Feel like a professional script writer with script-styled editor. Easily add and remove lines, assign characters, set line actions or add narration;

Tome Format

Have you ever felt anxious about the state of your hobby project after long holidays or busy day-job months? Coming back to a project not being sure it's even going to compile, let alone play the right music for the right scene? This is the reason we (me and my wife) have designed the Tome story format — as long as everything about your game is in just one place, it's way easier to keep track and feel confident about the state of your game.

It's essentially a spreadsheet, the easiest of all formats. It's so simple you don't even need the editor, you can write your entire game using Google Spreadsheets (which we have done). Here is an example of what it looks like.

Editor works with .tsv files that you can export and import in any spreadsheet editor of your choosing. Must-have columns are:

Scene Character Text Actions Conditions
- - - - -

Everything else is considered to be Meta data that you can add or delete based on your needs.

Integrations

After you've finished working on your story it would be nice to actually start making a game with it. The format is simple enough that you can parse it with any .tsv parser, alternatively there's an export to JSON option that will provide you a file that's ready to be deserialised in your game.

For a more thorough integration that would run your story in one of the popular game engines... That would take a lot of time but it's possible! Who knows, maybe you can write one and share it with the class.

  • Unity Integration is WIP, but I'll publish it eventually;

Downloads

WIP...

Contributions

Are welcome. However a note of warning, this is a passion project that I do for fun, and for one reason or another the definiion of fun for me is doing it in vanila JS without having any prior experience in writing JS apps. Am I ignoring 10+ years of web development tech that could make my life easier and the code prettier? Yes. It works really fast though!

Cool alternatives

Tome is not the only tool out there to write stories. If you don't care too much about the meta-data and having everything in one file, might I introduce you to:

  • Twine — An open-source tool for telling interactive, nonlinear stories. You can make a full game just using it with some extensions. However it's not as easy to integrate into a game engine
  • Inky — A narrative scripting language for games. A very good tool for writing complex dialogues and stories with text-first approach. It has been very well tested, it's open-source, it has game engine integrations, give it a try!