JustQuests

# 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 **(https://discord.gg/cMTGE9QCja)**. 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. **👉 (https://discord.gg/cMTGE9QCja)** 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 ` | 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 ex