ContractRPG

• ✨Create market orders from the menu: /contract market > Create an order > pick the item, set the amount and payment, publish. No commands needed.
• ✨The item list has every item in the game with a search, and hides items that cannot be obtained in survival (market.picker-hidden).
• ✨Custom items (Nexo, ItemsAdder, MMOItems...): while creating an order, click the item in your own inventory to ask for that exact item.
• ✨Right-click an order in /contract market to preview the item exactly as it is, with its name, lore, enchantments and everything its plugin adds.
• ✨The preview lists what the tooltip may hide (enchantments, durability, custom model data, source plugin) and lets you deliver from there.
• ✨In the order creator, click the chosen item to preview it the same way before publishing the order.
• 🔧Items show their real name in the market, deliveries, shop and rewards: the custom name first, then the item name used by Nexo and ItemsAdder.
• 🔧Items without a custom name show a readable name, like "Iron Ingot" instead of IRON_INGOT.
• 🐛Items from Nexo and newer ItemsAdder showed as their base material (for example PAPER) in the market: only the anvil-style name was checked.
• 🐛%contractrpg_active_N_objective% showed "Missing message: translation-keys..." for objectives not in the translation list. It now shows a readable name.
• 🐛On 1.21.1 and 1.21.2, biome visit contracts never progressed: the biome was always read as empty because of an API change in 1.21.3.
• 🔧Drop the jar in and restart. The new config and language keys are added to your files automatically.

• ✨Pages in the contract menus. A category only had room for 28 contracts, and everything past that — accepted, offered or locked — was silently cut off. The list is now split into pages with arrows at t
• 🐛The contract offer did not follow the player's level. Dailies and weeklies are frozen the first time the menu is opened, but the offer was never checked again after a level change: a player who went f
• 🐛SQLite: the shop purchase history was not being loaded since 2.3.0. It was saved but never read back, so on every login it came back empty — one-time shop items could be bought again and cooldowns wer

• 🐛On Minecraft 1.21.1 and 1.21.2, completing a contract failed with an IncompatibleClassChangeError and stopped right there: the player got the XP and the points but no money and no items, and the contr
• 🐛Contracts that got stuck at 100% because of the above are paid out automatically. They stayed active with full progress, and in that state they could never be completed again — the progress had alread
• 🔧A wrong sound or particle name in config.yml now just skips the effect and says so once in the console, instead of silently doing nothing.

• 🐛Hex colours and gradients in the language files were turned into the nearest of Minecraft's 16 basic colours before being sent. A <#8A2BE2> or a <gradient:...> in a message, the prefix, a menu or the
• ✨/contract global start <id>: start any global contract from global.yml right away (the ids tab-complete). The one currently running ends without rewards.
• ✨/contract global stop: end the current global contract without rewards and keep them stopped — even after a restart — until you start one again.
• ✨global-contracts.automatic in config.yml. true (the default) keeps today's behaviour: global contracts start and rotate on their own. false makes them manual: none runs until you start one, and after
• 🔧/contract global next now announces the new global contract to the whole server. Before, the boss bar simply switched to another contract with no message.
• 🐛One message of the contract editor used by add-ons ("that is not a number") was hardcoded in Spanish. It now comes from the language file.

• ✨FancyNpcs support for NPC deliveries. Put the NPC's name — the one you gave it with /npc create — in delivery-fancynpc, and right-clicking it does exactly what the Citizens delivery NPC does: it takes
• 🔧Citizens and FancyNpcs share one delivery logic, so they cannot behave differently: both apply worlds, anti-farm-ms and party-shared, both only take the item when something accepts it, and both confir
• 🐛A cancelled click on the delivery NPC still handed the item over. If another plugin cancelled the click on the Citizens NPC (a cooldown, a protected area), the delivery went through anyway. It no long

• 🐛MMOCore servers: every contract with a level-requirement above 1 was impossible to take. Contract EXP goes to MMOCore, so the plugin's internal level stayed at 1 forever — and the offer list, the lock
• 🐛/contract reload did not reload your contracts. It reloaded config, languages and shop, and silently ignored daily.yml, weekly.yml, special.yml and global.yml — a hand-edited contract needed a full se
• 🐛Mining contracts could be finished with a stack of stone: place a block, break it, repeat. Blocks a player placed are now marked and do not count when broken, and the mark is stored in the chunk so a
• 🐛Spawner farms completed hunting contracts on their own. Mobs that came out of a spawner no longer count as kills (spawn eggs optional).
• 🐛worlds, anti-farm-ms and party-shared did nothing on mining, hunting, fishing, crafting, MythicMobs and NPC deliveries. Those types walked their own code path and never reached the checks, even though
• 🐛Actions cancelled by another plugin still counted. Mining, placing, fishing or enchanting inside a protected WorldGuard region moved the counter even though nothing happened in the world, which turned
• 🐛Weekly contracts only reset if you happened to log in on a Monday. Anyone who missed that day carried their finished weeklies for the entire following week, unable to redo them and with no warning. Th
• 🐛A crash threw away the whole session. Data was written only when a player logged out and on a clean shutdown, so level, points and contract progress went back to whatever they were at login. There is
• 🐛SQLite: one connection was shared between async threads with no synchronisation, there was no reconnect if it ever dropped, and it was never closed on shutdown — which on Windows left the file locked
• 🐛Riding contracts counted teleports: a /home or a portal while mounted added the whole distance at once. Anything above anti-farm.max-ride-blocks-per-second is now treated as a teleport and ignored.
• 🐛The marketplace could take the armour off your back. Fulfilling an order counted and removed items from the armour and off-hand slots, so an order for diamond chestplates took the one you were wearing
• 🐛NPC deliveries fed sub-objectives and the global contract for free. Right-clicking the delivery NPC advanced multi-objective sub-objectives and the server-wide global contract before checking whether
• 🐛Two GUI lines were hardcoded in Spanish ("Progreso", "Recompensas") and showed up untranslated on every server. They are now in all four language files, along with four console messages that were also
• ✨Folia support. Every task now goes through the regionised schedulers, so the plugin loads and runs on Folia instead of failing at startup.
• ✨Anti-farming section in config.yml: player-placed blocks, spawner mobs, spawn-egg mobs, an exemption list and the riding cap. All of it can be turned off.
• 🔧Structure contracts no longer lag the server. The structure search — one of the most expensive calls in the API, able to generate chunks — ran every 5 seconds for every player with one of those contra
• 🔧The leaderboard no longer reads the whole table. It used to load every player row into memory and sort in Java on each refresh; it now asks the database only for the rows it needs, with indexes to mat
• 🔧Four per-player maps were never cleared on disconnect. The anti-farm one grew by one entry per player and per contract, indefinitely.
• 🔧The PlaceholderAPI expansion is now unregistered on shutdown, so reloading the plugin no longer leaves a stale one serving data from a dead instance.
• 🔧The wiki now documents worlds, anti-farm-ms, party-shared and party-split-reward — the per-contract options that were in the editor but written down nowhere — plus the new anti-farm section and the Fo

• 🐛Contracts asking for damage from a specific mob never advanced. The damage source was not passed through, and a projectile reported itself rather than its shooter — when a skeleton shoots you, the dam
• 🐛Damaging a mob with a bow did not count towards DAMAGE_DEALT contracts. The same bug in reverse: the plugin saw the arrow as the attacker instead of the player.
• 🐛An accepted contract vanished from the list after a reroll. It was never deleted — it stayed active and kept counting — but rerolling regenerates the offers, and offers leave out what you already hold

• 🐛Seven mission types could never be completed if the contract had an objective written in: PLAYTIME, EXPLORE, XP_GAIN, KILL_PLAYER, RIDE, DAMAGE_TAKEN and TRADING. They were compared against a fixed va
• ✨RIDE now accepts the mount: "ride 1000 blocks on a horse" is finally something you can ask for, and a pig no longer counts toward it.
• ✨DAMAGE_TAKEN accepts the attacker, so "survive 200 damage from skeletons" works. Falls and fire count as ANY.
• ✨TRADING accepts who you trade with, so "trade 10 times with villagers" works.
• 🔧The wiki now documents what goes in mission-objective for all 22 mission types, and ships a copy-paste example of every single one instead of only seven.

• 🐛Riding contracts never progressed on animals. Horses, pigs and striders don't fire the event the plugin was listening to — only boats and minecarts do. Distance on a mount is now measured directly.
• 🐛Multi-objective contracts could not be finished if one of their goals was moving, riding or visiting a structure. Those three checks only looked at the contract's main type, so a sub-objective of that
• 🐛NPC deliveries counted only toward their own contract: they were invisible to global contracts and to multi-objective sub-objectives.
• 🐛MythicMob kills didn't advance multi-objective sub-objectives either.

• 🐛Crafting missions could be completed without spending materials: clicking the result slot counted progress even when the craft never happened (full inventory, or a different item on the cursor).
• 🐛Crafting and trading counted 1 on a shift-click, no matter how many items were actually made or traded.
• 🐛Villager trades that never went through still added mission progress.
• 🔧command-aliases now explains itself: it names the plugin already holding an alias, and reports when the server won't refresh its command tree.

• ✨Tab completion for /contract, showing only the commands each player can actually use
• ✨Custom command aliases in command-aliases: set /missions, or whatever name you like
• ✨The marketplace accepts custom items: /contract market create hand
• ✨Rarity odds can be written as percentages with rarity-use-weight: false
• 🐛The marketplace silently discarded any item with a custom name, an enchantment or damage
• 🔧Improved — On startup, the console prints the real percentage of each rarity

• 🐛Changing offered-amount or selectable-amount had no effect on players who had already opened the mission menu
• 🔧Missions above your level are now shown greyed out with the level they need, instead of just not being there
• ✨show-locked-missions in config.yml — you decide whether locked missions are shown or hidden

• 🐛Buying from the shop crashed when the item had a coloured name

• 🐛The shop editor ignored your language setting: its menus were hardcoded. All 36 texts now come from the language files, translated to EN/ES/FR/ZH.
• 🐛Duplicate key in lang/es.yml: it threw a "duplicate keys found" warning on startup and made the shop editor's invalid-number message show without the plugin prefix.
• 🔧The 58 ready-made contracts now ship in English. They are examples - rename them to your own language from /contract editor.
• 🔧config.yml, shop.yml, global.yml, codes.yml and the contract files are now documented in English, along with the console messages.
• 🔧Language files repair themselves: a file with duplicated keys is rewritten clean on startup, keeping your texts, edits and comments.

• ✨Party contracts: form a group with /contract party and share progress and/or rewards (the admin decides per contract).
• ✨Player marketplace: post an order with /contract market ("pay X for Y items"); others fulfill it and get paid (needs Vault).
• ✨Multi-objective contracts: a single contract can require several goals at once — all must be completed.
• ✨Profile / stats GUI: /contract profile shows level, points, total completed, daily streak, favorite type and a breakdown by mission type.
• ✨Reward boosters: /contract booster <mult> <seconds> temporarily multiplies money, points and EXP from contracts.
• ✨Redeemable codes: /contract redeem <code> for events or Discord rewards (codes.yml).
• ✨Community suggestions: players use /contract suggest; admins review them with /contract suggestions.
• ✨Admin analytics: /contract analytics — a GUI with completion counts per contract to balance your economy.
• ✨Contracts by world/region: limit a contract to specific worlds (e.g. "kill 10 blazes in the Nether").
• ✨Anti-farm: a per-contract minimum time between progress to stop macro/afk abuse.
• ✨Smart reminders: on join, players are told about contracts that are almost complete.
• ✨Completion feedback: configurable sound + particles + title when a contract is completed.
• ✨New objective types: damage dealt, damage taken, riding/mounting distance, playtime, and visiting structures (village, fortress...).
• 🔧Every contract-configurable feature above is also in the in-game mission editor, with its own explanation.
• 🔧Language files now auto-update on new versions, just like the config — new messages appear without losing your edits.

• ✨Classic & color codes (&e, &6, &l, &#ff8800…) are now supported, alongside <minimessage> tags.
• 🔧You can mix & codes and <minimessage> in the same line — both work everywhere (rewards, titles, menus, boss bar).

• ✨Global contracts now rest between one another, so they stay rare and special.
• 🔧The gap is configurable (a random wait between two values in minutes).
• 🔧A server-wide announcement when a fresh global contract appears.

No notes for this version.