# Questify<\/p>\n
A cross-platform, production-ready questing mod for Minecraft with a modern GUI, powerful theming, and a clean public API. Built on Architectury to provide identical behavior on Forge and Fabric from a single codebase.<\/p>\n
**Want to support the project?** Donations on Ko-fi help cover server expenses!<\/p>\n
—<\/p>\n
## Important Notice<\/p>\n
**Questify and all BobcatMods projects are now available exclusively on Modrinth**<\/p>\n
Due to ongoing issues with the CurseForge moderation team, all of our mods are no longer being updated on CurseForge. We’ve encountered repeated moderation blocks based on misunderstandings of standard industry practices – the same practices used by approved applications and mods across the ecosystem.<\/p>\n
After attempting to work through the appeals process with detailed technical documentation, we’ve decided to focus our efforts on platforms that better understand modern development practices.<\/p>\n
Updates will continue regularly on Modrinth, where we can provide the best experience for our users without unnecessary delays.<\/p>\n
**Note:** We’re planning to develop a Questify \u2192 FTB Quests converter for pack developers who want to use Questify’s editing tools and features on Modrinth, but need to distribute their quest pack for FTB Quests on CurseForge. This will allow the best of both worlds – powerful authoring tools with broad compatibility.<\/p>\n
—<\/p>\n
## Features<\/p>\n
Questify brings a complete quest system to Minecraft with dependencies, groups (chapters), hidden quests, tags, positions, icons, and persistent progress tracking. The visual quest GUI features an animated quest tree with dependency lines, fit-to-screen functionality, chapter images, and a detailed quest panel.<\/p>\n
The built-in theme system is compatible with FTB Quests theme files and includes a Theme Editor for customization. Players receive notifications and HUD updates for unlocks, quest completion, and celebrations. The mod also supports importing from FTB Quests with full task\/reward mapping, dependencies, and chapter metadata.<\/p>\n
Additional features include statistics-based requirements supporting all Minecraft statistics, administration commands with data validation, and a public API for registering custom requirement\/reward types and listening for quest events.<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
* **Minecraft:** 1.20.1
\n* **Architectury API:** 9.2.14+
\n* **Loaders:** Forge 47.x.x or Fabric Loader 0.17.3+
\n* **Dependencies:** Fabric API (Fabric only) | EasyScreen (Fabric\/Forge)<\/p>\n
—<\/p>\n
## Installation<\/p>\n
Download the mod JAR for your platform (Forge or Fabric) from Modrinth and place it in your `mods` folder. Start Minecraft and the mod will auto-initialize and create its data directory on first run.<\/p>\n
—<\/p>\n
## Getting Started<\/p>\n
Press `J` in-game to open the quest GUI, or run `\/quest gui`. Create your first quest by adding a JSON file under ` ## Using the GUI<\/p>\n Questify provides a graph-style quest screen (`QuestGraphScreen`) with:<\/p>\n * **Group\/chapter filters** across the top. Controls:<\/p>\n * Mouse wheel: zoom in\/out (keeps cursor focus). —<\/p>\n ## Quest Data Location<\/p>\n Quest data is stored under the game path configured by the platform. By default the mod uses:<\/p>\n * Quests: ` Quests can be organized in subfolders (commonly by group\/chapter). Files are pretty-printed JSON.<\/p>\n —<\/p>\n ## JSON Format<\/p>\n Minimal quest example (` “`json Common root fields:<\/p>\n * `id` (string) \u2013 Unique quest id. ### Requirement Types<\/p>\n **Item obtainment**<\/p>\n “`json **Item crafting**<\/p>\n “`json **Entity kill**<\/p>\n “`json **Advancement**<\/p>\n “`json **Command trigger**<\/p>\n “`json **Statistic** (all Minecraft stats supported)<\/p>\n “`json Notes for statistics:<\/p>\n * Distances are in centimeters (100 cm = 1 block). Walking 1,000 blocks is 100,000. ### Reward Types<\/p>\n **Item**<\/p>\n “`json **XP** (points or levels)<\/p>\n “`json **Command**<\/p>\n “`json **Title**<\/p>\n “`json —<\/p>\n ## FTB Quests Import<\/p>\n Import an FTB Quests pack directly and convert it to Questify format, including chapter metadata:<\/p>\n “` Imported content:<\/p>\n * Quest structure and dependencies. The importer reads SNBT and translations, performs id sanitization, and writes JSON quests under ` —<\/p>\n ## Themes and Appearance<\/p>\n Questify supports FTB Quests theme files and provides a live Theme Editor.<\/p>\n * Theme file format: INI-like sections with selectors and properties. Open the Theme Editor from the quest GUI via the Theme button. Changes preview live and can be saved for reuse.<\/p>\n —<\/p>\n ## Notifications and HUD<\/p>\n * Quest unlocked: shown when dependencies are newly met. All notifications are de-duplicated and cached per player to avoid spam. Cache resets on completion or disconnect.<\/p>\n —<\/p>\n ## Teams Menu<\/p>\n * **Team button in Quest UI**: Open the quest GUI and click the `Team` button. —<\/p>\n ## Built-in Editors<\/p>\n Questify includes first-class editors for pack authors and server admins:<\/p>\n * **Quest Editor** (`QuestEditorScreen`) \u2013 Full quest authoring with tabs for requirements, rewards, dependencies, team settings, preview, and advanced options. ### How to Enable and Open the Editors<\/p>\n Access is permission- and config-gated to prevent accidental edits on public servers.<\/p>\n 1. Server must allow the Advanced Editor for the player. Notes:<\/p>\n * A small popup recommends using **UI scale 1 or 2** for the editors due to text density. You can suppress this by setting `suppressUiScaleEditorWarning` to `true` in `config\/questory_client.json`.<\/p>\n —<\/p>\n ## HUD Improvements<\/p>\n The HUD overlay (`QuestHudOverlay`) was expanded for clarity and customization:<\/p>\n * **Track quests** from the quest details or with the keybind; displays up to 5 tracked quests. —<\/p>\n ## 0.4 Highlights<\/p>\n * **Advanced Editors**: Quest, Theme, and Chapter editors with live preview, validation, and import-friendly flows. —<\/p>\n ## Commands<\/p>\n **Player-facing:**<\/p>\n * `\/quest list` \u2013 List available quests. **Administration (OP):**<\/p>\n * `\/quest reset —<\/p>\n ## Server, Persistence, and Sync<\/p>\n * All quests are JSON files readable and writable server-side. —<\/p>\n ## Performance<\/p>\n * Efficient culling and batching on the GUI to handle large quest sets. —<\/p>\n ## Compatibility<\/p>\n * Forge and Fabric support with identical behavior via Architectury. —<\/p>\n ## Mod Compatibility<\/p>\n **FTBTeams (optional)**<\/p>\n * Auto-detected and used when present. Questify registers an external team provider and listens to team events to keep the in-game Team UI synchronized (`FTBTeamsProvider`, `FTBTeamsIntegration`). **FTB Quests import**<\/p>\n * Built-in importer converts FTB Quests packs including chapters, tasks, rewards, dependencies, and chapter images. **JourneyMap (optional, client-side)**<\/p>\n * File-based waypoint sync for Location and Region requirements. Waypoints are created in the current JM world’s `waypoints\/` folder and cleaned up automatically as progress changes (`MapCompatManager`). **GameStages (optional)**<\/p>\n * Enables stage-based gameplay via a new requirement and reward type. Works on Forge and Fabric with a soft dependency (`GameStagesHelper`). —<\/p>\n ## API and Integration<\/p>\n Questify exposes a public API to extend the system:<\/p>\n * Register custom requirement and reward types. See packages under `org.texboobcat.Questify.api` for examples and events. Custom integrations should add corresponding tracking into server-side event hooks and call `QuestManager` methods to update progress.<\/p>\n —<\/p>\n ## Troubleshooting<\/p>\n **The GUI does not open**<\/p>\n * Ensure you are on the client and press `J`, or run `\/quest gui`. **Import failed**<\/p>\n * Verify the path points at the `ftbquests` data folder containing SNBT. **Requirements not tracking**<\/p>\n * For items\/crafting\/kills\/advancements, ensure the IDs and counts match. **Performance issues**<\/p>\n * Use the Anim toggle in the GUI. —<\/p>\n ## Support the Project<\/p>\n **Support us on Ko-fi \u2192**<\/p>\n Your donations help cover server expenses and keep development going strong!<\/p>\n —<\/p>\n ## Links<\/p>\n * **Download on Modrinth** —<\/p>\n *Building better questing experiences for everyone.*<\/p>\n","protected":false},"excerpt":{"rendered":" Questify is a drop-in quest system that auto-converts FTB Quests packs, keeps theme parity, and works on Fabric & Forge without extra setup.<\/p>\n","protected":false},"featured_media":127714,"template":"","meta":{"_minecraft_slug":"questify","_minecraft_project_id":"6Adtk0PR","_minecraft_author":"Bobcat","_minecraft_license":"MIT","_minecraft_downloads":2462,"_minecraft_follows":28,"_minecraft_client_side":"optional","_minecraft_server_side":"optional","_minecraft_storage_type":"zip","_minecraft_archive_name":"questify.zip","_minecraft_size_bytes":202234178,"_minecraft_version_count":30,"_minecraft_updated_at":"2026-05-15T19:49:46.413052Z","_minecraft_date_created":"2025-10-24T06:05:50.305633Z","_minecraft_date_modified":"2025-12-17T02:18:45.875852Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/questify","_minecraft_icon_attachment_id":127714,"_minecraft_imported_at":"2026-06-07T12:20:45+00:00","_minecraft_import_hash":"e209ec66b7a9c8de41f62f40bd99a161","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,89,867,92],"mod_loader":[99,106],"minecraft_version":[36],"class_list":["post-127713","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-game-mechanics","mod_category-social","mod_category-utility","mod_loader-fabric","mod_loader-forge","minecraft_version-1-20-1"],"yoast_head":"\n
\n* **Animated quest nodes** with shapes, sizes, completion checkmarks, lock\/hidden icons.
\n* **Dependency lines** with state-aware colors, thickness, and optional animated effects.
\n* **Zoom and fit-to-screen** for large quest trees.
\n* **Details panel** showing title, description (wrapped), requirements with progress, and rewards.
\n* **Chapter images** rendered behind quests when provided by imported packs.
\n* **Theme Editor** button to open a live-editable theme screen.
\n* **Animation toggle** for performance tuning on lower-end systems.<\/p>\n
\n* Drag: pan the view.
\n* Buttons: Center, Fit, Complete selected, Theme, Anim on\/off.<\/p>\n
\n* Chapters metadata: `
\n* Player progress is stored per-player and saved automatically.<\/p>\n
\n{
\n “id”: “my_first_quest”,
\n “title”: “My First Quest”,
\n “description”: “Collect some dirt blocks!”,
\n “icon”: “minecraft:dirt”,
\n “group”: “starter”,
\n “dependencies”: [],
\n “requirements”: [
\n {
\n “type”: “item_obtain”,
\n “item”: “minecraft:dirt”,
\n “count”: 10,
\n “consume”: true
\n }
\n ],
\n “rewards”: [
\n {
\n “type”: “item”,
\n “item”: “minecraft:diamond”,
\n “count”: 1
\n },
\n {
\n “type”: “xp”,
\n “amount”: 100
\n }
\n ]
\n}
\n“`<\/p>\n
\n* `title` (string) \u2013 Display title.
\n* `description` (string) \u2013 Multi-line supported with `n`.
\n* `icon` (string) \u2013 Item ID or resource path.
\n* `group` (string) \u2013 Chapter\/category.
\n* `hidden` (bool) \u2013 Hide until conditions.
\n* `x`, `y` (int) \u2013 Position in graph (pixels or imported grid transformed to pixels).
\n* `dependencies` (string[]) \u2013 Prerequisite quest ids.
\n* `requirements` (array) \u2013 See below.
\n* `rewards` (array) \u2013 See below.<\/p>\n
\n{ “type”: “item_obtain”, “item”: “minecraft:diamond”, “count”: 10, “consume”: true }
\n“`<\/p>\n
\n{ “type”: “item_craft”, “item”: “minecraft:diamond_pickaxe”, “count”: 1 }
\n“`<\/p>\n
\n{ “type”: “entity_kill”, “entity”: “minecraft:zombie”, “count”: 20 }
\n“`<\/p>\n
\n{ “type”: “advancement”, “advancement”: “minecraft:story\/mine_diamond” }
\n“`<\/p>\n
\n{ “type”: “command”, “id”: “custom_trigger”, “description”: “Custom completion trigger” }
\n“`<\/p>\n
\n{ “type”: “statistic”, “statistic”: “minecraft:walk_one_cm”, “value”: 100000 }
\n“`<\/p>\n
\n* Values are cumulative; progress is polled at intervals and synced to the client.<\/p>\n
\n{ “type”: “item”, “item”: “minecraft:diamond_sword”, “count”: 1 }
\n“`<\/p>\n
\n{ “type”: “xp”, “amount”: 1000, “levels”: false }
\n“`<\/p>\n
\n{ “type”: “command”, “command”: “give {player} minecraft:diamond 5”, “displayName”: “5 Diamonds” }
\n“`<\/p>\n
\n{ “type”: “title”, “title”: “Achievement Unlocked!”, “subtitle”: “You did it!” }
\n“`<\/p>\n
\n\/quest import ftb
\n* Task mapping to requirements: item, craft, kill, advancement, checkmark.
\n* Reward mapping: item, xp, xp_levels, command.
\n* Positions, icons, titles, descriptions.
\n* Chapter images\/links\/defaults saved for client sync.<\/p>\n
\n* Selectors: `*`, quest id, `group:
\n* Properties include text colors, quest state colors, dependency line colors, spacing, sizes, background, icons, and more.
\n* Animated backgrounds and line effects are supported. Icon modifiers include color, alpha, tiling, scale.<\/p>\n
\n* Quest ready: shown when requirements are fully satisfied, with instructions to claim.
\n* Quest claimed: title\/subtitle, chat summary, and sounds.
\n* Optional HUD overlay can display up to three tracked quests with live progress.<\/p>\n
\n * If you are not in a team, `TeamCreationScreen` will guide you through creating one.
\n * If you are already in a team, `TeamManagementScreen` lets you manage invites and membership.
\n* Works in single-player and multiplayer. Server-side rules apply when configured.
\n* Optional integration with team libraries is supported when present.<\/p>\n
\n* **Theme Editors** (`NewThemeEditorScreen`, `ThemeEditorScreen`) \u2013 Live theme editing with property search, categories, selectors, and instant preview.
\n* **Chapter Editors** (`ChapterArtEditorScreen`, `ChapterImageEditorScreen`) \u2013 Manage chapter metadata, default options, links, and layered chapter images.<\/p>\n
\n * The server syncs a runtime flag to clients; when enabled and permitted, the Advanced button appears in the quest GUI.
\n2. Client may optionally hide the editor locally.
\n * Set `clientEnableAdvancedEditor` to `true` in `config\/questory_client.json` (default is true).
\n3. Open the quest GUI (`J`), then click **Advanced** to open the editor menu, and choose Quest\/Theme\/Chapter.<\/p>\n
\n* **Compact mode** and **full mode** with optional progress bars.
\n* **Position\/scale\/opacity**: configurable via the gear button in the quest UI or via `config\/questory_client.json`:
\n * `hudPosition` (TOP_LEFT, TOP_RIGHT, BOTTOM_LEFT, BOTTOM_RIGHT)
\n * `hudScale` (0.5\u20132.0)
\n * `hudOpacity` (0\u2013100)
\n * `hudCompactMode`, `hudShowIcons`, `hudShowProgressBars`, `hudOffsetX`, `hudOffsetY`<\/p>\n
\n* **Teams Menu**: Create and manage teams directly from the quest UI.
\n* **HUD Overhaul**: More readable, configurable overlay with compact and full modes.
\n* **UI Scale Guidance**: Non-intrusive popup suggests using UI scale 1\u20132 for best editor readability (can be disabled).<\/p>\n
\n* `\/quest info
\n* `\/quest progress` \u2013 Show overall progress.
\n* `\/quest complete
\n* `\/quest gui` \u2013 Open the quest GUI.<\/p>\n
\n* `\/quest reload` \u2013 Reload all quests from disk.
\n* `\/quest track
\n* `\/quest import ftb
\n* `\/quest validate` \u2013 Validate all quests and report issues.
\n* `\/quest config reload` \u2013 Reload configuration.<\/p>\n
\n* Player progress is saved and synced to clients automatically.
\n* On join, the server sends quests and progress to populate the client cache.
\n* Chapter metadata (images, links, defaults) is also synced to clients when present.<\/p>\n
\n* Adaptive zoom and fit mechanics to keep navigation smooth.
\n* Animated effects can be toggled off per-client.
\n* Progress tracking is event-driven and statistics polling is interval-based.<\/p>\n
\n* Vanilla-friendly item IDs, advancements, and statistics.
\n* Works alongside common modpacks; FTB packs can be converted.<\/p>\n
\n* No hard dependency. If absent, Questify’s built-in team system works normally.<\/p>\n
\n* See the “FTB Quests Import” section for the command and supported mappings.<\/p>\n
\n* Only non-completed requirements are marked. If you track quests, only tracked quests are exported.
\n* Toggle in `config\/questory_client.json`: `mapIntegrationEnabled` and `journeyMapEnabled`, or via the in-game config screen.<\/p>\n
\n* Requirement example:
\n “`json
\n { “type”: “stage”, “stage”: “bronze” }
\n “`
\n* Reward example (grant or remove a stage):
\n “`json
\n { “type”: “stage”, “stage”: “bronze”, “remove”: false }
\n “`<\/p>\n
\n* Subscribe to quest lifecycle events (unlocked, ready, completed, claimed).
\n* Query player progress for gameplay integration.<\/p>\n
\n* Check that quests are present or run `\/quest reload`.<\/p>\n
\n* Check server logs for conversion errors and invalid ids.<\/p>\n
\n* For statistics, remember distances are centimeters and values are cumulative.<\/p>\n
\n* Filter by chapter instead of viewing all at once.<\/p>\n
\n* **Support on Ko-fi**<\/p>\n