Skip to content

wisp-forest/lavender

Repository files navigation

The landing page of a Lavender book

Lavender is tool allowing modders, modpack makers and everybody else to create player guides and other in-game documentation in the form of easy-to-read, intuitive guide books.

Everything is written using easy to learn, familiar and, most importantly, readable markdown with a bunch of special syntax to seamlessly integrate with the game. This is augmented with support for powerful macros and the entirety of the owo-ui framework at your fingertips

Further, for the first time in any guidebook mod (we believe), all books can be viewed in-game when placed in the offhand - extremely useful for referencing an entry while carrying out its instructions

Features

  • Fully data-driven book authoring with near-instant hot reloading
  • Optional grouping of entries into categories for easy discovery
  • Deep linking between entries and categories
  • Structure/Multiblock visualization and building assistance
  • Gradual content unlocking, backed by the game's advancement system
  • Built-in support for visualizing all vanilla recipe types and an easy framework for implementing custom ones
  • Localization support
  • Individual bookmarks for each save
  • Support for extending another mod's books, extremely useful for seamlessly integrating your addon's documentation

Getting started

To start making your own Lavender book right now, complete the setup and then follow Getting Started in the comprehensive documentation over at https://docs.wispforest.io.

For reference, it might be helpful to check out Affinity's Wispen Testament as a solid example book made using Lavender

Credits

  • The Patchouli team for making the original mod that inspired Lavender
  • chyzman for inspiring a range of features, notably offhand viewing