
Guidebook.md
Add Markdown guides to BTA, allowing modders to efficiently create and format guides. Markdown books were added to BTA, allowing users to create, edit, and organize complete, structured Markdown-compatible documents.
Screenshots






About this Mod
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
Available Versions
How to Install Guidebook.md on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set bta-babric Loader
In the panel under "Egg", select the bta-babric loader and matching Minecraft version (b1.7.3).
Install Mod
Open the mod browser in the dashboard and search for "Guidebook.md". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
b1.7.3
Server-side
~ OptionalRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Guidebook.md server crashes on startup – what to do?
Most common cause: wrong bta-babric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (b1.7.3). You can switch loaders with one click in the panel.
Is Guidebook.md compatible with bta-babric?
Guidebook.md officially supports bta-babric for Minecraft b1.7.3. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Guidebook.md – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Guidebook.md consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Guidebook.md with just one click on your server.