

Guidebook.md
Helps BTA modders create mod guides quickly and easily using Markdown with extra features
How to Use?
Create a MDBookScreen inherited class.
Load config from asset path, include .md files.
Use as a normal screen, opened from a trigger.
Formats
Use < & >
chars for color codes:
- 0 = &0Black
- 1 = &1Dark Blue
- 2 = &2Dark Green
- 3 = &3Dark Aqua
- 4 = &4Dark Red
- 5 = &5Dark Purple
- 6 = &6Gold
- 7 = &7Gray
- 8 = &8Dark Gray
- 9 = &9Blue
- a = &aGreen
- b = &bAqua
- c = &cRed
- d = &dLight Purple
- e = &eYellow
- f = &fWhite
- s = &sShadow
- r = Reset
Syntax
Regular &3Markdown syntax adapted for &6BTA Guidebook format:
# H1
## H2
### H3
#### H4
##### H5
###### H6
* Unordered List
- Unordered List
1. Ordered List
Specials
**Images**
- [text](/assets/modid/textures/path/to/img.png)(width,height,type)
- 
- 
- Width & Height in pixels
- type = default | icon or (no text) to use default option
- The workbench last slot it's for output item
How to use?
Markdown guidebook
public class MyBook extends MarkdownGuidebook<MDPage> {
public IntroBook() {
String path = "/assets/modid/markdown/mybook/";
config = BookConfig.fromJsonResource(getClass(), path + "config.json");
DecimalFormat formatter = new DecimalFormat("000");
for (int i = 0; i<11; i++) {
String fileName = "page_" + formatter.format(i + 1) + ".md";
loadMarkdownPages(path + fileName);
}
}
}
Display markdown
Check superclass for more info.
public class MyMDScreen extends MDScreen {
public MyMDScreen() {
currentPage = MarkdownCompiler.compile("/assets/modid/markdown/path/to/your/file.md", getClass());
}
}
In-Game Markdown Editor
Use the editable book in-game and export the Markdown content to use in your project! Or use it to share information with your friends in your world!
Commands
Export or load markdown books.
-
Use: /guidebook export
- to export to: btafolder/guidebook/exported/
- to export to: btafolder/guidebook/exported/
-
Use: /guidebook load
- Load from: btafolder/guidebook/load/
- Load from: btafolder/guidebook/load/
Showcase
Download the zip with the files in the release page
https://github.com/user-attachments/assets/d2f9fe57-74f7-433e-8f00-0848fc137571