Description

Trailmark is a quest book for Fabric and NeoForge. Chapters are laid out as maps, quest pages hold proper formatted text, and the book's whole look comes from stylesheets that packs, servers and players can each replace.
| Documentation | Example quest pack | Developer API |
|---|---|---|
| Every file and field, explained | A full, playable book to learn from | Custom tasks, rewards and events |
![]()
Icons are drawn by the game's own renderers, so modded blocks and mobs look exactly as they do in the world, and GeckoLib models can play any of their animations. Blocks keep their states and block entity data, a player icon can wear the skin of whoever opens the book, and modded fluids work even without a bucket.

Videos open in a player with full screen and keyboard controls, or play right on the map. Sounds can be any sound ID, a file in the pack, or a link. A server sends media only when a quest that shows it is opened, at a capped speed behind game traffic, and players keep it cached so it downloads once.

| What you can style | How |
|---|---|
| Every screen, the HUD tracker, toasts and pop-ups | A style.css with selectors for every part, plus states like :hover, :locked and :claimable |
| Motion | Transitions, keyframe animations, gradients and shadows, and @media rules for small screens |
| Single quests or whole chapters | Give them a style or tags and target them as classes |
| Fonts | Your own, from a resource pack or the config folder, for any element |
| Where themes come from | Resource packs, the quest pack (servers send theirs on join), and each player's own style.css |
| Players who'd rather keep their look | Prefer My Style puts their theme above the server's |
The Nether theme above ships with the example pack, along with a lighter vanilla-style theme, so you can start from either.

- On the map: drag, link, resize and box-select, nudge with the arrow keys, and undo or redo. Editing is for operators by default, with a configurable permission level.
- Templates: save a group of quests and stamp it anywhere. Templates are plain files, so they're easy to share.
- Decorations: labels, pictures, videos, sounds and 3D icons, attached to quests, layered, tilted, or locked until a quest is done.
- Safe to tinker: every save keeps a backup, and a quest that fails to load is reported by
/trailmark problems, never deleted. - Translations: export a language file with one command, or edit text in game for yourself or the whole server.
- Moving over:
/trailmark import ftbquestsconverts an FTB Quests book along with its team progress, and lists anything it couldn't match.
Quests
| Tasks | 21 built in: items, crafting, mining, placing, using, kills, interacting, observing, stats, advancements, locations, biomes, structures, dimensions, fluids, XP, check marks, custom signals, counters, stages and player data |
| Rewards | Items, pick-one choices, random rolls, loot tables, XP, commands, advancements, stages, counters, effects, recipes and toasts, claimed per player or per team |
| Unlocking | Needs all, any or a number of earlier quests. Quests can stay hidden until unlocked, or be secret |
| Flow | Repeat instantly, daily, weekly or on a cooldown, run against a timer, lock out other branches, or sit in chapters that open on set dates or weekdays |
| Look | Eight quest shapes, milestones, and connection lines per quest or per link |
| Text | Markdown, HTML, tables, call-outs, spoilers and colour codes, with items, blocks, mobs, structures and players shown inline |
| Links | To other quests, chapters, Patchouli entries and websites |
| Getting around | A HUD tracker with a compass arrow for places to visit, toasts, and a quest book tab on the inventory and advancements screens |
| Teams | Trailmark's own parties, or FTB Teams |
Works with
| Recipes | JEI · REI · EMI (press R or U over any item in the book) |
| Maps | JourneyMap · Xaero's Minimap (tracked locations show as waypoints) |
| Guides | Patchouli |
| Teams and claims | FTB Teams · FTB Chunks (chunk tasks and rewards) |
| Accessories | Accessories · Curios · Trinkets (worn items count, rewards go into slots) |
| Storage | Backpacks and shulker boxes · Refined Storage · Applied Energistics 2 |
| Machines | Create · Mekanism · any mod that stores Forge Energy (NeoForge) |
| Scripting and NPCs | KubeJS (NeoForge) · NPC mods like EasyNPC, through /trailmark signal |
| More | Cobblemon · GeckoLib |
All of these are optional. A quest that needs a missing mod shows as unavailable until it's installed.
Good to know
| Install on | Client and server |
| Needs | Fabric API on Fabric. Dungeon Config is bundled |
| Open the book | Press I, click the quest book tab in your inventory, or use the quest book item |
| On servers | The book syncs file by file and players only download what changed |
| Video and MP3 | Uses FFmpeg. If it's missing, Trailmark offers to download it |
| First time? | Grab the example quest pack and change what you like |

