MarkdownManual is a library mod for Minecraft that allows painless definition of in-game manuals backed by Markdown documents.
This mod is licensed under the MIT license. All assets are public domain, unless otherwise stated; all are free to be distributed as long as the license / source credits are kept. This means you can use this mod in any mod pack as you please. I'd be happy to hear about you using it, though, just out of curiosity.
In general, please refer to the API, everything you need to know should be explained in the Javadoc of the API classes and interfaces.
To define a new manual, create an instance of Manual and
register it with the manual registry. For convenience, the location of this registry is available in
the Constants class.
final DeferredRegister<ManualModel> MANUALS = DeferredRegister.create("your_mod_id", Constants.MANUAL_REGISTRY);
final RegistrySupplier<ManualModel> MANUAL = MANUALS.register("your_manual", Manual::new);To get content into the newly created manual, you'll want to add
a DocumentProvider. A simple setup just needs to add
single NamespaceDocumentProvider for
the current mod, e.g.:
final DeferredRegister<DocumentProvider> DOCUMENT_PROVIDERS = DeferredRegister.create("your_mod_id", Constants.DOCUMENT_PROVIDER_REGISTRY);
final RegistrySupplier<DocumentProvider> DOCUMENT_PROVIDER = MANUALS.register("your_document_provider", () ->
new NamespaceDocumentProvider("your_mod_id", "doc"));Where doc is a path in your mod's assets, in this case your directory structure would be like this:
your_mod_dev_dir
|-+ src
|-+ main
| ...
|-+ resources
|-+ assets
|-+ your_mod_id
|-+ doc
|-+ en_us
|- index.md
| ...
Usually you'll then also want to add an item representing this manual in the game. For a simple setup, subclass
the AbstractManualItem and return the
ManualModel created above in getManualModel. This will provide you with a default UI, as well. To customize the UI, see below.
The contents of manuals are regular Markdown pages. Manual rendering only supports a basic subset of markdown, including header scaling, italic, bold, monospace and lists.
It also supports links to other manual pages and has basic support for image rendering. They must explicitly use the texture protocol. Rendering blocks and items is also possible using the block and item protocols.
Examples:
Mods may also add additional custom content rendering. For example, you could add a content renderer that renders recipes, if you were so inclined.
To extend an existing manual, register providers that match the manual to extend. For example, implement
a DocumentProvider and override
the matches(ManualModel) method to return true for the manual to add content for. By default, providers will only
match manuals defined in the same namespace as themselves, i.e., defined by the same mod, as this is usually the desired
behavior.
To add additional entry points next to the manual (tabs), follow the same basic procedure as when extending a manual
with any other provider. Simply register a new Tab implementation with the
tab registry.
When using the AbstractManualItem or using the ShowManualScreenEvent the built-in manual screen implementation is
used. This implementation can be styled using implementations of
the ManualStyle
and ManualScreenStyle interfaces. These allow changing
textures used in the screen (background, tab, scroll bar) as well as changing content rendering parameters such as
fonts, text color and so on.
To use a completely customized manual screen, you'll want to override AbstractManualItem.showManualScreen() or use a
custom item. In this case you'll need to query content from the ManualModel and use the Document
class directly. See the implementation of the default ManualScreen for details on its usage.
To add a dependency to this mod for use in your mod, add the following to your build.gradle:
repositories {
exclusiveContent {
forRepository { maven("https://cursemaven.com") }
filter { includeGroup("curse.maven") }
}
}
dependencies {
// Forge via ForgeGradle
implementation(fg.deobf("curse.maven:markdownmanual-502485:4713960"))
// Fabric via Loom
modImplementation("curse.maven:markdownmanual-502485:4713962")
}
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent