?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
MCA: Quests

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.

7
0
7
0

Compatibility

Minecraft: Java Edition

1.20.1

Platforms

Supported environments

Client and server

Links

Report issues View source Join Discord server
Buy Me a Coffee

Tags

Creators

Details

Licensed GPL-3.0-or-later
Published 20 hours ago

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 / not composites — 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

  1. Install Forge for Minecraft 1.20.1.
  2. Drop MCA Reborn, Architectury API, and MCA: Quests into your mods/ folder.
  3. 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.