Villager Contracts

Mod for Minecraft version 1.12.2 that adds an item to the game that gives players the abillity to change the profession and career of villagers.

1.7K Downloads

forgeeconomyutility

Rent Server with this Mod

Screenshots

About this Mod

Villager Contracts

Description

Villager Contracts is a mod for Minecraft version 1.12.2 that adds an item to the game that gives players the ability to change the profession and career of villagers.

Usage

To use the Villager Contract, simply rename the contract at an anvil and interact with a villager while holding the renamed contract. If successful, the villager will change and their trades will reset.

A list of valid contract names can be seen by holding shift while hovering over the Villager Contract item.

Configuration

dumpVillagerInfo - enabling this option will dump the profession and career info of all registered villagers to the log
entityBlacklist - blacklist of entities for which the Villager Contract interaction is disabled
validContracts - A "whitelist" of valid names, professions, and careers used by the Villager Contract. Modded villagers can be easily added so long as they are correctly registered with Minecraft Forge.

Available Versions

1.12.2-1.2.1release

MC 1.12.2forge

June 28, 2024

1.12.2-1.2.0release

MC 1.12.2forge

April 11, 2024

1.12.2-1.1.0release

MC 1.12.2forge

April 2, 2024

1.12.2-1.0.0release

MC 1.12.2forge

March 28, 2024

How to Install Villager Contracts on Your Server

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

Set forge Loader

In the panel under "Egg", select the forge loader and matching Minecraft version (1.12.2).

Install Mod

Open the mod browser in the dashboard and search for "Villager Contracts". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

forge

Minecraft Versions

1.12.2

Server-side

✓ Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Villager Contracts server crashes on startup – what to do?

Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.12.2). You can switch loaders with one click in the panel.

Is Villager Contracts compatible with forge?

Villager Contracts officially supports forge for Minecraft 1.12.2. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Villager Contracts – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Villager Contracts consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.