JustQuests

A lightweight quest book for NeoForge, Fabric & Forge. No GUI bloat, no heavy dependencies — just quests and a handful of commands. Built as a focused, server-friendly alternative to FTB Quests and HQM for packs that want questing without the weight.

Now on three loaders — NeoForge, Fabric and Forge — across Minecraft 1.18 – 1.21. In-game quest book (press J) on 1.20.1 and newer; older versions are command-only. Singleplayer and servers.

The GUI is an early, interim version — the final design is being chosen by a community Discord poll. Come vote!

---

💬 Join the community — help shape the GUI

The big in-game GUI is being designed by the community: its style, layout and features will be decided by polls on the Discord. The more people vote, the better the GUI everyone gets.

👉 Join the JustQuests Discord to:

• 🗳️ Vote on the upcoming GUI — style, layout and which features land first
• 🛟 Get support, report bugs and follow update news
• 👀 See sneak peeks and try early builds before release

In-game you can run /quest discord anytime to get the invite.

---

✨ What JustQuests does

• In-game quest book (GUI) — press J to browse quests, track objective progress, and accept with a click (early/interim version, singleplayer for now, on MC 1.20.1+). The full /quest command set works everywhere.
• Ready to play — ships with a built-in quest progression you can start right away, no setup required.
• Lightweight — tiny and fast, with no heavy dependencies.
• Make your own quests — drop them in a simple per-world JSON file or a datapack. No restart needed: the file reloads automatically as you edit it.
• Speaks the player's language — quest text can be written in multiple languages, and item/mob/block names show up translated for each player automatically (per-player language on 1.20.2+; English on older versions).
• Persistent progress — saved per world, kept across sessions and through death.
• Server-friendly — runs server-side with per-world storage; stays out of the way of other mods and UI overhauls.

---

🧩 Objective & reward types

Quests are built from these objectives — mix and match, and choose whether a quest needs all objectives or just any one of them:

• collect_item – gather items (mining, harvesting, mob drops)
• mine_block – break blocks of a type
• craft_item – craft a given item
• smelt_item – smelt items in a furnace
• consume_item – eat or drink an item
• place_block – place blocks
• kill_mob – defeat entities of a type
• tame_animal – tame animals
• breed_animal – breed animals of a type
• reach_level – reach an XP level
• reach_location – arrive at a position (optionally in a set dimension)
• visit_dimension – enter a dimension (vanilla or modded, by id)
• gain_advancement – earn an advancement

Item objectives accept a single id (minecraft:oak_log), a list, or a tag (#minecraft:logs).

Rewards:

• give_item – hand over items
• loot_table – roll a loot table for a random reward
• xp – give experience points
• effect – apply a potion effect
• message – send the player a message (per-language supported)
• command – run any command as the player ({player} is substituted) — covers economy payouts, effects and more with no hard dependency

Quest logic: quests can require other quests first (requires → chains, with a locked teaser until unlocked), and can be repeatable with an optional cooldown (e.g. daily quests).

---

🎮 Commands

Command	What it does
/quest list [category]	List all quests (grouped by category), or just one category
/quest categories	List the categories and how many quests each has
/quest stats	Your personal stats (completed %, per category, dates)
/quest leaderboard	Server top 10 by quests completed
/quest accept <id>	Start a quest (with tab completion)
/quest progress	Show your active quests and how far along you are
/quest abandon <id>	Drop an active quest (suggests your active ones)
/quest discord	Get the community Discord invite (vote on the GUI!)
/quest reload	(OP) reload custom quests
/quest test	(OP) run a self-test and write a diagnostics report
/quest admin view|reset|complete <player>	(OP) manage a player's quest progress

Server admins: quest completions are announced to everyone by default (toggle in <world>/justquests/settings.json).

Quest ids support tab completion — accept suggests every available quest, abandon suggests only the ones you've taken.

---

✍️ Custom quests

On first launch, JustQuests writes a custom-quests.json file into your world folder (<world>/justquests/) with an explained example and blank slots to fill in. Save the file and your quests appear in-game within a few seconds — no restart. A custom quest overrides a datapack quest with the same id.

Quest titles and descriptions can be a plain string:

"title": "Mining Trip",
"description": "Mine 20 iron ore."

…or a per-language map keyed by language code (en_us, de_de, fr_fr, …), so a single quest reads correctly for everyone:

"title": { "en_us": "Mining Trip", "de_de": "<German title here>" },
"description": { "en_us": "Mine 20 iron ore.", "de_de": "<German text here>" }

Each player sees their own client language, falling back to English.

---

📦 Built-in quests

JustQuests ships with 25 ready-to-play quests across categories (gathering, farming, combat, building, crafting, exploration, challenges, survival, daily) — each in English, German, French and Spanish out of the box, so you can jump in right away. A sample:

Quest	Goal	Reward
First Steps	16 oak logs	4 bread
Stone Age	32 cobblestone	16 torches, stone pickaxe
Master Miner	mine 64 stone	iron pickaxe
Home Builder	place 64 oak planks	16 torches
Animal Friend	tame a wolf	16 bones
Into the Nether	enter the Nether	4 obsidian
Level Up	reach XP level 20	XP + Strength
Prospector	mine 3 diamond ore	mystery loot
Daily Bread	eat 3 bread (repeatable, 24h)	emerald
…and 16 more

Good to know: collect_item counts items picked up (mining, harvesting, mob drops). To track items the player makes, use craft_item.

Want to make your own? A full example datapack with one quest per objective & reward type is on GitHub.

---

📥 Installation

1. Install your loader for your Minecraft version: NeoForge, Fabric (+ Fabric API), or Forge.
2. Download the JustQuests jar that matches your loader and version — the file name says which, e.g. JustQuests-fabric-1.20.1-0.2.1.jar or JustQuests-neoforge-1.21.1-0.2.1.jar — into your mods folder.
3. Launch the game, press J for the quest book (1.20.1+) or run /quest list.

---

✅ Compatibility

Pick the jar for your loader and exact Minecraft version:

• NeoForge: 1.20.4, 1.20.6, and 1.21 – 1.21.10

• Fabric (requires Fabric API): 1.18.2, 1.19.2, 1.19.4, 1.20.1, 1.20.4, 1.20.6, and 1.21 – 1.21.10

• Forge: 1.18.2, 1.19.2, 1.19.4, 1.20.1

• Environment: singleplayer and servers (runs server-side)

• GUI: on 1.20.1 and newer; 1.18/1.19 are command-only (the full /quest set and all quest tracking still work)

Why the gaps? NeoForge only exists from 1.20.2 up, so 1.18–1.20.1 are covered by Fabric/Forge. Forge and NeoForge split at 1.20.1, so 1.20.2+ is served by NeoForge (and Fabric) rather than duplicating it on Forge.

---

🗺️ Roadmap

JustQuests is built step by step. Already shipped: a deep set of objective and reward types, item tags, quest modes & categories, per-world custom quests with live reload, multi-language quest text, and now NeoForge, Fabric and Forge across 1.18–1.21.

Planned next:

• Final GUI design: chosen from 3 mockups by a Discord community vote, with the polished textures, a claim button, choice rewards, an optional HUD tracker — and multiplayer support (the current GUI is singleplayer)
• Server & QoL: difficulty settings and permission gating
• Automatic quest generator: rotating, registry-aware generated quests
• Wider reach: a Paper/Bukkit plugin edition

Feedback shapes the priorities — bug reports and suggestions are very welcome on the issue tracker.

---

📄 License

Released under the GNU LGPL v3. Free to use in any modpack, no permission needed. Modified versions and forks must stay open source under the same license.

💬 Community & GUI polls: https://discord.gg/cMTGE9QCja Source & issues: https://github.com/ErikEdits/JustQuests