ContractRPG add-on · 1.21+
ContractRPG: Professions
Four guilds, twenty skills and player-to-player services. A blacksmith signs your weapon, a farmer brews you a better potion, a builder sells you a blueprint that saves material — with money and goods held in escrow until the work is done.
1.0Version
1.21+Minecraft
ContractRPG 2.2.1+Requires
ES·ENLanguages
The part nobody else does
Most profession plugins give one player a bigger number. This one gives a player something the others have to come and ask for.
🛠️
OfferOnly someone with the skill can offer that service🤝
HireMoney and the item go into escrow when the order is placed⚒️
WorkNothing is released until the work is actually done⭐
RateA good artisan builds a reputation. A bad one carries it around✅
Free ContractRPG never gets worse. Nothing is taken away from servers without the add-on: this only adds. And nobody gets stuck — every recipe has a second, slower route that needs no guild. The profession is the fast way, never the only way.
Installation
- You need ContractRPG 2.2.1 or newer installed first. With anything older the add-on shuts down with a readable message.
- Drop ContractRPGProfessions.jar into your plugins/ folder.
- Restart the server (Java 21).
- Paste your licence into license: in config.yml and restart again.
⚠️
Without the licence the plugin will not start. You will find it under "My panel" in your account. It covers one server: used on two at once, both shut down. If our site is unreachable the plugin keeps working for 48 hours — an outage on our end never takes your server with it.
Optional integrations
| Plugin | What it unlocks |
|---|---|
| Vault + economy | Money for services and orders |
| PlaceholderAPI | The guild, rank and level placeholders |
| Citizens | Workshop NPCs that open the service board |
| ElementalArms | Signing elemental weapons |
| MMOItems | Signing MMOItems gear |
| WorldGuard | Restricting workshops by region |
ℹ️
None of them are required except ContractRPG. Each switches on a feature if you run it, and stays out of the way if you don't.
The four guilds
Each one is the fast route to something the others can't do as well — and each is a customer for the other three. Chosen with /professions; switching afterwards needs an admin command.
| Guild | What it does | Its 5 skills |
|---|---|---|
| ⛏️ The Iron Forge | Signs weapons, repairs with no penalty, adds durability | Thrifty Smith I · Thrifty Smith II · Master's Touch I · Molten Fury · Blacksmith's Seal |
| 🌾 The Green Harvest | Improves potions, harvests better, breeds better than anyone | Green Thumb I · Green Thumb II · Expert Shepherd I · Touch of Gaia · Elixir of Life |
| 🧱 The Stone Compass | Sells blueprints that save material, raises walls instantly | Swift Architect I · Swift Architect II · Tool Restoration · Instant Wall · Master's Blueprint |
| 🏹 The Order of the Fang | Marks prey, takes the hits, turns the kill into cured leather | Hunter's Instinct I · Hunter's Instinct II · Thick Hide I · Hunter's Mark · Trophy |
How active skills are cast
Sneak and right-click with your trade's tool, or use /professions cast. If you're holding the wrong tool, the plugin tells you which one you need.
💡
All 20 skills, their costs, cooldowns and activation tools live in
skills.yml. Everything is configurable, names included.The service board
Opens with /professions services, from a workshop sign, or by talking to an NPC. Artisans post what they do and what they charge; customers hire them.
| Service | Guild | What it does |
|---|---|---|
| 📜 Signing | The Iron Forge | Signs a weapon or tool: more attack damage |
| 🔧 Repair | The Iron Forge | Repairs gear with no penalty |
| ⬆️ Upgrade | The Iron Forge | Adds durability to gear |
| ⚗️ Alchemy | The Green Harvest | Improves a potion |
| 📐 Blueprints | The Stone Compass | A single-use blueprint that saves material |
How an order works
- The customer picks a service and hands over the item. Money and item go into escrow.
- The artisan does the job with
/professions work. - The customer collects with
/professions claimand can rate the artisan. - An order nobody works expires after 48 hours and everything goes back to its owner.
🔒
Nobody has to trust anybody: until the work is done, the artisan doesn't have the money and the customer hasn't lost the item.
Workstations
Stand at a smithing table, cartography table, loom or fletching table and open your workstation. Queue a batch and walk away — the queue survives restarts.
| Setting | Value |
|---|---|
| Recipes included | 8 — 2 per guild |
| Station blocks | SMITHING_TABLE · CARTOGRAPHY_TABLE · LOOM · FLETCHING_TABLE |
| Batches at once | 3 |
| Quality by level | +1 unit every 10 levels |
Knowledge spreads
- Recipes can be discovered by playing, taught face to face, or written into a book you can sell.
- Teaching needs the other player within 8 blocks: it's something you do in person, not a remote command.
- Your veterans become teachers, and that is content you don't have to write yourself.
⚖️
No recipe is locked behind a guild. Every one has a second ingredient list — costlier or slower — that anyone can use. The profession saves you effort, it doesn't gate you.
Ranks
You climb by working for other people, not by grinding alone. Ranks and their levels are set in config.yml.
| Rank | Key |
|---|---|
| 🥉 Apprentice | apprentice |
| 🥈 Journeyman | journeyman |
| 🥇 Master | master |
| 👑 Grandmaster | grandmaster |
📣
Promotions are announced server-wide from level 25 up, so early levels don't flood the chat. Change it with
ranks-announce-from-level.Workshops on the map
- An artisan claims a spot as their workshop and customers get a compass pointing to it.
- A
[Service]sign opens the board straight from the workshop. - With Citizens, an NPC can act as the workshop's shopkeeper.
Commands
The main command is /professions, with the aliases /prof, /guild, /g and /gremio. You can add your own in command-aliases.
| Command | What it does |
|---|---|
/professions | Opens your profession menu |
/professions services | The service board |
/professions work | Do a job somebody ordered from you |
/professions claim | Collect a finished order |
/professions cast | Cast your active skill |
/professions sign | Sign the weapon in your hand |
/professions top | Artisan leaderboard |
/professions help | Help, with version and author |
/professionsadmin | Admin commands |
/professionsadmin reload | Reloads the configuration |
Permissions
| Permission | What it allows | Default |
|---|---|---|
professions.admin | Every admin command | op |
professions.admin.reload | Reload the configuration | op |
ℹ️
Everything else is open to any player: joining a guild, offering services, hiring and crafting need no permission.
Placeholders
They need PlaceholderAPI.
| Placeholder | Returns |
|---|---|
%professions_guild% | Their guild |
%professions_rank% | Their rank |
%professions_level% | Their profession level |
%professions_exp% | Their experience |
%professions_jobs% | Jobs done for other players |
%professions_rating% | Their average rating |
The files
| File | What's inside |
|---|---|
config.yml | Licence, guilds, the ContractRPG bridge, services, production, ranks and knowledge |
skills.yml | The 20 skills: cost, cooldown, activation and tools |
recipes.yml | The 8 recipes, with their fast route and their slow one |
levels.yml | The level curve |
gui.yml | The structure of the menus |
languages/es.yml · en.yml | Every line a player can read |
The ContractRPG bridge
- ContractRPG missions pay guild EXP, with 1.5× when the mission belongs to your trade.
- Contracts can be filtered by guild, so a miner sees mining work.
- A Guild EXP button appears in the contract editor just from having this installed.
🔄
When you update the jar, new options are merged into your files and the comments are refreshed. Your values are left alone.
ContractRPG: Professions / Changelog
Version history
Every release and what changed in it.
v1.0
2026-08-17 Latest
No notes for this version.
ContractRPG: Professions / Discussion
Discussion
Comment and share your experience on each plugin version.
ContractRPG: Professions / Reviews
Player reviews
What server owners think of this plugin.
—
★★★★★
0 reviews
Log in to leave a review.Log in
No reviews yet.