mrombout / asciihero

An AsciiDoc.js extension to help authoring Fighting Fantasy style (and more) gamebooks.
https://mrombout.github.io/asciihero/
MIT License
0 stars 0 forks source link

Dungeons & Dragons style #53

Open mrombout opened 1 year ago

mrombout commented 1 year ago

It's quite outside my original scope for AsciiHero, but perhaps it isn't too much trouble to work this into it after all. It should definitely be attempted only after all other more traditional gamebook formats have been implemented.

Apart from gamebooks, there are also Solo Adventures for Dungeons & Dragons, which made me think if AsciiHero should also include a style to author those type of documents? They will probably stretch the limitations of the templatability and current features provided, but it would be an interesting addition.

Solo Adventure gamebooks are formatted much like a standard Dungeon and Dragons adventure. But come with segments similar to a gamebook where the player may make choices and are redirected to other segments. In general, they use a lot more dice rolls and use Dungeons & Dragons terminology (e.g. Make a DC 13 Wisdom (Perception) check).

Combat is almost always accompanied by a Dungeons & Dragons statblock features a lot more information than that is common with Fighting Fantasy-style gamebook. These statblocks use standardized formatting and terminology. Sometimes the book comes with instructions on how the enemy behaves.

In terms of styling they often follow Dungeon & Dragons's official styling meaning a parchment background, colored segments (with a name) and different blocks for different elements (e.g. for instructions, literal texts, etc). They always use 2 columns where the segments flow from left to right on the same page.

mrombout commented 1 year ago

I think the most effort is going to be to implement the #45. Implement the two-columns should already have been implemented by the #5 because it's quite common on old-school books as well. The visual styling should be no trouble at all, since it all seems pretty trivial.

I guess one challenge could also be images. Hopefully I've solved it by then, but Dungeon & Dragon adventures often use loads of images. Some at the top, in corners, flowing in the middle, everywhere.

Check out the awesome https://github.com/naturalcrit/homebrewery, which supports all the formatting one would need but in Markdown (with loads of extensions and custom stuff).

mrombout commented 1 year ago

I was looking to Vivliostyle as part of #55 and ran across https://www.npmjs.com/package/vivliostyle-theme-dnd-5e-phb, which looks like a perfect representation of the D&D document style :open_mouth: If we switch engines, it might be interesting to look at that instead of recreating our own style.