JustQuests

Minecraft 版本： 1.21

平台： neoforge

标签： adventure game-mechanics utility

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

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:

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