MCA: Quests
An RPG-style, datapack-driven quest system for MCA:Reborn villagers. Right-click a villager, open the new Quests menu, accept a job, complete it out in the world, and turn it in for sweet rewards and hearts.
!Banner Image for MCA: Quests Please Consider Donating - Every Dollar Counts
An RPG-style, datapack-driven quest system for Minecraft Comes Alive: Reborn villagers. Right-click a villager, open the new Quests menu, accept a job, complete it out in the world, and turn it in for items, XP, status effects — and a meaningful boost to your MCA hearts with that specific villager.
Server-authoritative, dup-proof, and fully data-driven: every quest is a JSON file, so modpacks and players can add their own without writing code.
Features
- 🗨️ Integrated menu — a Quests button is injected directly into MCA's villager interaction screen (no extra steps, no separate UI to learn).
- 📜 69 built-in quests spanning every villager profession — farmer, fisherman, shepherd, librarian, cleric, armorer, weaponsmith, toolsmith, mason, butcher, fletcher, leatherworker, cartographer — plus jobless/nitwit villagers and MCA's guard (with bonus content for archers, adventurers, and mercenaries).
- 🎭 Multi-offer conversation UI — villagers present several quests at once, each with flavor dialogue, objectives, and a reward summary; Accept / Decline / Complete / Abandon inline.
- 🎯 10 objective types — deliver items, gather, craft, fish, kill mobs, break/place blocks, visit biomes or dimensions, and talk to professions.
- 🎁 7 reward types — items, XP, XP levels, status effects, loot tables, commands (off by default), and MCA hearts.
- 🔒 12 condition types +
all_of/any_of/notcomposites — gate offers by hearts, profession, biome, dimension, time, weather, held item, advancement, level, random chance, and quest history. - 🧭 Quest tracking — a keybind-toggled Quest Log, a fully repositionable HUD tracker that names the giver, and a toast + sound when a quest is ready to turn in.
- 🛡️ Server-authoritative & exploit-resistant — all selection, validation, and reward granting happen on the server; turn-in is atomic and idempotent, so packet-spam can't duplicate rewards.
- 🧩 Extensible — a public Java API lets add-ons register their own objective/reward/condition types, and five Forge events (
QuestAccepted/Ready/Completed/Abandoned/Failed) let other mods react.
Requirements
| Minecraft | 1.20.1 |
| Mod loader | Forge 47.4.10 or newer |
| MCA Reborn | Required — 7.6.x |
| Architectury API | Required (Forge) — MCA Reborn depends on it |
MCA: Quests does nothing on its own — it is an add-on for MCA Reborn.
Installation
- Install Forge for Minecraft 1.20.1.
- Drop MCA Reborn, Architectury API, and MCA: Quests into your
mods/folder. - Launch. Right-click an adult MCA villager and click Quests.
How it works
Right-click a villager → Quests → pick an offer → Accept. Track it via the HUD or the Quest Log keybind (bind "Open Quest Log" in Controls). When the objective is done you'll get a toast; return to an eligible villager and Complete it to claim your rewards and earn hearts.
Configuration
Two files are generated in config/ on first run:
mcaquests-common.toml— gameplay rules (offer counts, cooldowns, hearts scaling, turn-in rules, the villager-follow toggle, …).mcaquests-client.toml— visuals (HUD position, toasts, sounds, the menu button).
See CONFIG.md for every option and its default.
Add your own quests
Quests load from any datapack at data/<namespace>/mcaquests/quests/**.json. Run /mcaquests export-schema in-game for a working example, and see DATAPACK.md for the full field reference and a step-by-step datapack walkthrough. Useful commands: /mcaquests list, /mcaquests validate, /mcaquests reload.
Building from source
Requires JDK 17.
./gradlew build
The jar lands in build/libs/. MCA Reborn and Architectury are pulled automatically (MCA via the Modrinth Maven). Note: gradle.properties pins org.gradle.java.home to a local JDK 17 path — adjust it to your own JDK 17 install, or remove it and run Gradle with JAVA_HOME pointed at JDK 17.
Compatibility note
MCA Reborn exposes no public API, so MCA: Quests links against its internal classes and is therefore pinned to the 7.6.x line. A future MCA major version may require an update here. All MCA access is isolated behind a single McaCompat adapter to make that easy.
License & credits
Licensed under GPL-3.0, matching MCA Reborn (whose internals this mod links against).
- Minecraft Comes Alive: Reborn by Luke100000 and contributors — the mod this builds on.
- Created by otectus.
