Mebahel's RPG: Villager Quests & Companions

Turn Minecraft villages into living RPG hubs.

Mebahel's RPG: Villager Quests & Companions adds story-driven villager quests, branching choices, named enemies, rumors, quest tracking, companion recruitment, and RPG-style notifications to your world. Villagers are no longer just traders standing around a bell. They can send you after threats, ask for supplies, reveal rumors, start multi-step storylines, or pull you into decisions that change what happens next.

Some quests are simple village jobs. Others become full story arcs with investigations, moral choices, ambushes, raids, hidden follow-ups, and enemies who might not deserve the axe you were sent to bring.

If you like vanilla Minecraft but wish villages had more reasons to explore, protect, question, and return, this mod is built for that.

---

Dependencies

Forge / NeoForge

• Sinytra Connector
• Forgified Fabric API

Fabric

• Fabric API

---

What This Mod Adds

• Over 40 included quests built around villages, roads, mines, raids, ruined portals, witches, raiders, skeletons, and strange survivors.
• Branching storylines where killing, sparing, exposing, defending, or helping can lead to different follow-up quests.
• Named quest targets with custom dialogue, equipment, locations, health, ambushes, and spare/attack choices.
• Recruitable companions from selected mercy paths, including restored enemies who can later fight beside you.
• Villager rumors that organically unlock hidden quests instead of throwing every story at you immediately.
• Quest journal and HUD tracking so you can follow objectives, locations, destinations, and threat targets.
• Skyrim-style quest notifications with custom sounds when quests start, update, or complete.
• Multi-step objectives including combat, item collection, building, escorting, structure discovery, raid defense, timed waits, and optional bonus objectives.
• Datapack support for creators who want to add their own quests and rumors without changing the mod code.

---

How It Feels In Game

You arrive at a village. A farmer has heard something moving near an old portal. A smith remembers smoke below a mine. Someone claims a hero's medal was stolen. A witch at the edge of the woods might be the threat, or she might be the only one telling the truth.

You talk, choose responses, accept the quest, track it in your journal, follow coordinates or structure clues, and return for rewards. Some targets fight immediately. Some talk first. Some can be spared. Sometimes mercy opens a longer path. Sometimes it brings danger back to the village.

The goal is to make villages feel like places with memory, consequences, and unfinished business.

---

Major Story Arcs

The Armed Dead

Investigate a ruined portal guarded by Sir Alaric Ashward, an armed zombie with fragments of a soldier's memory. Kill him to seal the restless gate, or spare him and help recover the identity buried under the undead curse. The mercy path can lead to a recruitable companion.

No-Banner Vindicator

A rogue raider named Rurik stands outside the usual pillager order. Is he hunting, mourning, or hiding from something worse? Your choice can end his story in ash or push him through a trial that may turn an enemy into an ally.

The False Hero

A celebrated village champion may be wearing stolen glory. Follow the evidence, find the last witness, and decide whether to bury the truth or expose the person the village has been praising.

The Witch at the Hut

The village fears a witch. The easy answer is to kill her. The harder answer is to listen. Sparing her can reveal a larger plot involving curses, raiders, undead proxies, and an evoker pushing danger toward the village.

Village Defense and the Quiet Ledger

Prepare a village for attack, raise iron golems, survive a raid, and earn a reputation. But fame has consequences. After the bell rings, a hidden follow-up can draw assassins from the Quiet Ledger.

The Cold Forge

A rumor about a cold forge leads into a darker thread about a smith, an old mine, and a curse tied to the forge's last work.

Village Arrival

A lighter chain about helping a new villager settle in. It starts with a clock and a home, then escalates into questionable decorating decisions.

Skeleton Cleanup

A local skeleton problem grows into a deeper Nether-linked cleanup chain, including spawner destruction and proof taken from the dead.

---

Quests, Rumors, and Discovery

Not every quest appears the same way.

Some villagers can offer jobs directly. Others may only give you a rumor. Hearing the right rumor can unlock hidden content, such as smoke below an old mine, a stranger among the dead, or trouble that appears after a village has already survived a raid.

This means the world can reveal stories gradually as you play instead of dumping every quest into your face on day one.

---

Moral Choices and Consequences

Several major quests use a kill or spare system.

Choosing mercy is not just a softer completion button. It can:

• unlock a different quest chain,
• change the reward flow,
• trigger ambushes or follow-up danger,
• send you on escort missions,
• restore a named character's identity,
• lead to a recruitable companion.

Choosing violence can also open its own path. Some stories become shorter, darker, or more direct depending on what you do.

---

Companions

Certain spared characters can eventually become permanent companions.

Companions are designed to be useful without turning villages into chaos. During escort and companion behavior, they follow your lead and avoid randomly attacking peaceful villagers, iron golems, or passive animals. They focus on hostile threats you engage, so they feel like allies instead of uncontrolled mobs.

Some companions also support equipment interaction through the companion inventory screen.

---

Quest Journal and HUD

Press J by default to open the quest journal.

The journal and tracker help you follow active objectives with contextual labels such as:

• Threat location for named enemy targets,
• Destination for escort quests,
• Structure location for exploration objectives,
• Target location when no more specific label applies.

Coordinates in the journal are clickable, and active objectives can be followed directly through the HUD tracker.

---

Objective Variety

Quests are not limited to killing mobs.

Included objective types support:

• killing specific mobs or named quest targets,
• collecting items,
• finding quest items generated in chests or containers,
• breaking or placing blocks,
• escorting entities to structures,
• bringing entities back to a location,
• discovering structures,
• defending villages during raids,
• timed waits and next-day objectives,
• optional objectives with bonus rewards,
• sequential quest stages.

---

For Modpacks and Datapack Creators

The quest system is data-driven. Quests and rumors are loaded from JSON files, and the loader scans all namespaces from installed mods and datapacks.

Datapack layout:

data/<your_namespace>/quests/<quest_id>.json
data/<your_namespace>/rumors/<rumor_id>.json

This makes it possible to add your own village stories, bounty chains, custom rumors, quest rewards, named threats, mercy paths, structure objectives, and companion outcomes.

Rumors use weight for relative random selection. A rumor with weight: 10 is ten times as likely as a rumor with weight: 1, after player and world conditions are checked.

{
  "weight": 10,
  "line": "Someone saw smoke below the old mine.",
  "unlock_quest": "your_namespace:mysterious_mine"
}

Supported quest features include:

• chained quests,
• kill/spare branches,
• required completed quests,
• required advancements,
• player traits,
• rumor-unlocked hidden quests,
• custom quest items,
• generated quest containers,
• threat target spawning,
• multiple threat targets,
• ambush outcomes,
• XP and item rewards,
• enchanted item rewards.

---

Configuration

Server/world config file:

config/mebahelrpgrquest.json

Current configurable values:

{
  "villagerQuestChance": 0.20,
  "villagerRumorChance": 0.33
}

• villagerQuestChance is the quest assignment weight for a newly loaded villager.
• villagerRumorChance is the rumor assignment weight for a newly loaded villager.

The two values compete in one roll. Any remaining weight up to 1.0 means no quest or rumor is assigned. Values are clamped between 0.0 and 1.0; if their sum is above 1.0, quest and rumor are normalized against each other with no empty outcome.

---

Current Status

This mod is under active development. More quests, story branches, objective types, companion features, and datapack options may be added over time.

Feedback, bug reports, quest ideas, and modpack testing are welcome.

---

Community

Join the Discord to follow development, report bugs, share ideas, or talk about custom quest lines:

https://discord.com/invite/y8uC2NepkB