ContractRPG | Daily, Weekly & Global Contracts [1.21+]

ContractRPG
A full missions & contracts economy for your server — hunt, mine, fish and craft for real rewards. Parties, a player marketplace, global server goals and a complete in-game editor.

Made by infinity3113 · Minecraft 1.21+ · Spigot / Paper · Java 21
✔ No required dependencies — runs standalone! · 4 languages (EN / ES / FR / ZH)

Full Documentation & Wiki

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

What is ContractRPG?
ContractRPG adds a full missions / contracts system to your server. Players pick up daily, weekly and special contracts — hunt mobs, mine, fish, craft or deliver items — and earn money, XP, contract points and item loot. Spend points in a built-in shop, climb the leaderboards, group up in parties, trade with other players in a marketplace, and team up on server-wide global goals shown on a boss bar.

The whole plugin is fully configurable, comes with 56+ ready-made contracts, and includes a complete in-game mission editor — no config editing required.

✨ Contracts

• Daily / Weekly / Special — offers lock per period (no free rerolls), completed ones are marked, specials complete only once.
• 22 mission types — Hunt, Mine, Fish, Craft, Deliver items (via a Citizens NPC), Deliver MMOItems, Hunt MythicMobs, plus Enchant, Smelt, Breed, Tame, Trade, Place blocks, Gain XP, PvP kills, Explore, Visit biome, Visit structures (village, fortress…), Deal/Take damage, Ride and Playtime.
• Multi-objective contracts — one contract with several goals at once; all must be completed.
• Rarity system — Common / Rare / Legendary (fully custom): each rarity has a colour, a spawn weight and optional glow. Set the odds by weight or by straight percentage, whichever you find easier, and let players preview the chances from the level you choose. Rarer contracts become more likely as players level up.
• Reroll — players spend contract points to reroll their offered contracts.
• Locked missions stay visible — players see what is waiting at higher levels instead of an empty menu. Hide them if you prefer the surprise.
• Contracts by world, anti-farm cooldowns, smart reminders on join, and sound + particles on completion.
• 56+ contracts included — 24 daily, 12 weekly and 20+ special, weighted by tier.

Played together

• Party contracts — group up with /contract party and share progress and/or rewards (the admin decides per contract).
• Player marketplace — post /contract market orders ("pay X for Y items"); others fulfill them and get paid, with escrow so nobody has to trust anybody. Orders can ask for a specific custom item, not just a material. (Needs Vault.)
• Global server contracts — community goals the whole server fills together, shown on a live boss bar; all contributors get rewarded, then it rotates.
• Leaderboards — /contract top by level, points or contracts completed, with PlaceholderAPI support.

Rewards & progression

• Rich rewards — money (via any economy), XP, contract points, and item loot tables with drop chances.
• Custom reward commands — run any console command on completion (ranks, kits, crates…) with your own display text, from the editor or the YAML.
• Meaningful leveling — built-in level system (or MMOCore) with level-up effects (message, title, sound) and configurable milestone rewards. Your level gates contracts, unlocks & discounts shop items, and boosts your rare-contract chance.
• Point Shop — buy items with contract points. Per-item stock, cooldown, one-time-purchase, level requirement and level discounts, all via an in-game editor.
• Reward boosters — /contract booster <mult> <seconds> multiplies money, points & EXP for a while, and survives restarts.
• Redeemable codes — /contract redeem <code> for events or Discord, with usage limits and an optional once-per-player rule.
• Profile / stats GUI — /contract profile: level, points, total, daily streak, favorite type and a breakdown by mission type.

️ Made for the server owner

• In-game mission editor — create, edit and delete contracts from a GUI (/contract create · /contract edit), organized by category. Clickable pickers for mobs, fish and MythicMobs, or it reads the item in your hand. Drag-safe and fully translated.
• In-game shop editor — same idea for the point shop.
• Admin analytics — /contract analytics: completion counts per contract. A contract nobody takes is not a contract, and this is how you spot it.
• Community suggestions — /contract suggest pings any admin online; review them with /contract suggestions.
• Your own command names — add /missions, /contratos or /quests from the config, no jar editing. If a name is already taken, the console tells you which plugin has it.
• Tab completion on everything, for players and admins alike.
• Your settings survive updates — new options are merged into your config on start, with their documentation, and your values are left exactly as you set them.
• SQLite or YAML storage.
• 4 languages included and fully editable (English, Spanish, French, Chinese). Every line a player can read lives in a language file.

⚡ Add-on API
Other plugins can extend contracts without touching ContractRPG's internals: cancellable offer and accept events, a completion event, their own buttons inside the contract editor, their own lines under a contract in the menu, and extra data saved per contract.

// ContractRPG is optional: check before touching anything
if (ContractRPGAPI.isAvailable()) {
    int level = ContractRPGAPI.getLevel(uuid);
    Contract c = ContractRPGAPI.getContract("mine_stone");

    // your own button inside the contract editor
    ContractRPGAPI.registerEditorOption(myOption);

    // your own lines under a contract in the menu
    ContractRPGAPI.registerLoreProvider(myLoreProvider);
}

Add softdepend: [ContractRPG] to your plugin.yml, unregister on disable, and require 2.2.0 or newer.

Dependencies
None are required — ContractRPG runs on its own. Every integration below is optional and turns on automatically only if that plugin is installed:

• Vault + any economy — money rewards & the player marketplace. https://www.spigotmc.org/resources/vault.34315/
• PlaceholderAPI — placeholders. https://www.spigotmc.org/resources/placeholderapi.6245/
• Citizens — NPC item-delivery contracts. https://www.spigotmc.org/resources/citizens.13811/
• MythicMobs — hunt-MythicMob contracts. https://www.spigotmc.org/resources/mythicmobs.5702/
• MythicLib — required by MMOItems. https://www.spigotmc.org/resources/mmolib-mythiclib.90306/
• MMOItems — deliver-MMOItem contracts. https://www.spigotmc.org/resources/mmoitems.39267/
• MMOCore — use MMOCore levels/XP instead of the built-in one. https://www.spigotmc.org/resources/mmocore.70575/

⌨️ Commands
Players

• /contract — open the contracts menu
• /contract shop — open the point shop
• /contract top [level|points|contracts] — leaderboard
• /contract global — the active global contract, its objective & rewards
• /contract profile — your profile & stats
• /contract party <invite|accept|leave|...> — group contracts
• /contract market — player marketplace (create|fulfill|cancel|claim|mine)
• /contract redeem <code> — redeem a code
• /contract suggest <text> — suggest a contract
• /contract help — command list

Admins

• /contract create · /contract edit — create / edit contracts (GUI)
• /contract shopedit — in-game shop editor
• /contract booster <mult> <seconds> — reward booster
• /contract analytics — completion analytics (GUI)
• /contract suggestions — view player suggestions
• /contract reload · /contract reset · /contract resetplayer <player>
• /contract points <give|take|set> <player> <amount>
• /contract level <set|add> <player> <amount>
• /contract global <next|reset>

Permissions

• contractrpg.use — base command (default: true)
• contractrpg.shop.open — open the shop (default: true)
• contractrpg.admin — create/edit, points, level, resetplayer (default: op)
• contractrpg.reload · contractrpg.admin.reset · contractrpg.admin.shopedit (default: op)

PlaceholderAPI

Placeholders

• %contractrpg_level% · %contractrpg_exp% · %contractrpg_exp_required% · %contractrpg_exp_bar%
• %contractrpg_active_contracts_count%
• %contractrpg_active_<1-N>_name% · _objective% · _progress% · _required% · _target%
• %contractrpg_top_<level|points|completed>_<1-N>_name% · _value%

Not sure of a name? /contract placeholders lists them all in game.

⚙️ Configuration
Clean, commented files — most of it can be done in-game with the editor. Leveling, storage, reroll, rarities, leaderboard, global contracts, the marketplace, command aliases and the MMOCore hook all live in config.yml; the shop and the contracts have their own editable files (or use the GUIs).

Installation

1. Drop ContractRPG.jar into your /plugins folder.
2. Restart the server (Java 21).
3. (Optional) Install any of the integrations above for the extra mission types.
4. Edit the files or use the in-game editors, then /contract reload.

Full guide & configuration: https://infinity3113.mc-paradise.com/plugins/contractrpg/

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

More plugins by infinity3113
https://infinity3113.mc-paradise.com/plugins

Minecraft 1.21+ · Version 2.2.0 · Requires Java 21 · Spigot / Paper · By infinity3113

Licence & Terms

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

ContractRPG is free, but it is not public domain. It remains the work of infinity3113.

You MAY:

• Use it on any server or network, public or private, with no player limit.
• Use it on a server that charges its players (ranks, donations, shops). What you may not charge for is the plugin itself.
• Edit the configuration and language files however you like.
• Translate the language files and share those translations.

You MAY NOT:

• Re-upload or mirror the plugin on any site, marketplace, Discord, forum or file host. Please link to this page instead.
• Sell it, or include it in any paid package, bundle, "plugin pack", server setup or hosting offer.
• Decompile, deobfuscate, reverse-engineer or republish its source code.
• Remove or alter the author credits, the plugin name or the licence notice.
• Claim authorship of it, or present a modified copy as your own work.

ContractRPG is an original work. It is not a fork, port or modification of any other plugin.

Provided "as is", without warranty of any kind. The author is not liable for any damage, downtime or data loss arising from its use.

Full terms: infinity3113.mc-paradise.com/plugins/terminos.html