ExcellentJobs ⭐ Lightweight Jobs System

ExcellentJobs ⭐ Lightweight Jobs System -----

A lightweight, flexible, and modern jobs system for your server

v1.14.0

OBJECTIVES SYSTEM REWORK:
This update brings new job's objective system, which is more flexible and easier to configure.

Your current configs will be auto-converted to the new format (with backup), but mistakes are possible!

SOME CLEAN UP:
This version removes a few features that can be unexpected to you, but I believe that this change makes the ExcellentJobs more clean and easy to use. Anyway, any feedback is appreciated!

Special Orders feature was removed in this version. This feature is not really useful and does not bring anything really special for the jobs system. So I decided to remove it until I come up with something more unique and useful. Also I believe the configuration for this one was horrible lol. Anyway, I have a semi-ready "Missions" alternative, so if you'll miss this feature, it won't take much time to bring you a replacement
Objectives GUI was removed in this version, because the new objective system finally got some decent flexibility and can not be unified enough for this without messy workarounds.

ADDED:

Configurable XP & Income penalty value for killing spawner mobs.
Configurable XP & Income bonus/penalty for manual/automated brewing/cooking.

IMPROVED:

Updated default layout of the Stats GUI.
Updated default layout of the Job GUI.
Added support for multiple slots for Stat Entries in the Stats GUI.
Added dialog for players to change job status.
Smelting, Cooking and Brewing actions now properly pays the owner.
Automated smelting, cooking and brewing is also supported now.

FIXED:

A bug, where upcoming rewards in the GUI were displayed incorrectly.

----------, Sep 7, 2025

v1.13.1

Fixed errors

----------, Aug 2, 2025

v1.13.0

ADDED:

Ability to provide multiple levels in level rewards configuration.
Config option to disable XP & Income for pet kills.
Config option to enable manual reward claiming.
Job state requirements for level rewards.
On leave and on join commands.
Placeholder '%objective_lore%' to display objective's icon lore in Objectives GUI.
Config option to set explicit icon for locked objectives in Objectives GUI.
[Experimental] Job leave confirmation dialog screen for 1.21.7+.

CHANGED:

Removed level cap for secondary jobs.
Split XP and Income bonus for primary and secondary jobs. By default it's -30% XP and -60% income for secondary jobs.
Job Preview GUI was removed and merged with regular Job GUI.

IMPROVED:

Players can change job priority (state) in the Job GUI without need to leave the job.
Improved display format for negative xp/income bonus.
Improved `/jobs join` command to auto join the job.

FIXED:

A few minor bugs and issues.

----------, Aug 1, 2025

v1.12.2

Minor update to newest nightcore and packetevents versions.

----------, Jul 26, 2025

v1.12.1

Fixed objective parsing.

----------, Jun 6, 2025

v1.12.0

ADDED:

Placeholder '%excellentjobs_total_level%' that displays total level of all user jobs.
Support for CustomCrops plugin (experimental).

CHANGED:

Previous total level placeholder changed to '%excellentjobs_total_effective_level%' (displays total level of all currently joined user jobs).

IMPROVED:

Use translatable components for objective names in GUIs and messages.

FIXED:

A bug, where level rewards displayed in random order in Levels GUI.
A bug, where daily limits placeholder not updated on expiration until any objective is completed.

----------, Jun 4, 2025

v1.11.1

FIXED:

Broken XP for job objectives.

----------, May 14, 2025

v1.11.0

ADDED:

Job Cooldowns. Prevent players from changing their jobs too often with rank-based cooldown values.
Support to exclude certain items from job objectives that uses wildcards `*` by adding the `-` prefix.
Config option for instant job payments.
Config option to display job progress in the action bar.
Command `/job levels` to open the levels menu.
PlaceholderAPI job placeholder to display upcoming payment for recent work.

IMPROVED:

Pay player instantly when leaving a job or reset job progress.
Simplified job payment messages.

FIXED:

Optimized and improved level & XP calculation for player's job datas.
Optimized XP & level management commands.
Incorrect level step calculation for the config modifiers.
Minor issues in default config generation.

----------, May 13, 2025

v1.10.0

NEW:

Revamped Wiki

ADDED:

Work Type toggle buttons in the job Objectives GUI.
Dedicated config file "work_types.yml" with per work type settings.
Config option to toggle on/off certain work type(and therefore it's event listeners).
Support for enchantment levels in 'get_enchant' and 'remove_enchant' work types.

IMPROVED:

Split objectives by their Work Type in the Objectives GUI.
Do not display "Items" list in Objectives GUI if objective has only one item.
Use individual currency's format for income values in Objectives GUI.
Revamped and rebalanced default job XP and Objectives configurations.

FIXED:

Improved level XP calculation.
A bug, where Per Level modifier setting works a bit incorrectly.
A bug, where display name of work type can not be changed.
A bug, where /jobs reset command does not reset obtained level rewards data.
A bug, where default level rewards not worked properly due to wrong placeholder used.

----------, Apr 15, 2025

v1.9.1

FIXED:

EvenMoreFish integration.

----------, Apr 7, 2025

v1.9.0

IMPORTANT:

Requires Spigot / Paper 1.21.4 or higher.
Requires nightcore v2.7.5.
Config 'job_list.yml' has been reworked. Check it out before use in production.

BOOSTERS REWORK:

Boosters feature can be completely disabled in the main plugin config.
Dedicated config file for Boosters module.
Automatic global boosters will properly apply now between plugin reloads and server restarts with more accurated duration calculation.
Automatic global boosters accept only one time value per day now.
Removed per currency booster mutlipliers. One multiplier for all currencies (payments) now.
Added a list of exclusive from booster's effect currencies.
Server can have only one global booster at the same time.
Merged 'booster remove' and 'booster removefor' commands.
Removed 'booster info' command.
Improved booster multiplier display in GUIs and messages.

CHANGED:

Removed per-currency payment modifier in job's settings. Now payment modifier applies to all currencies in job's objectives. This should simplify jobs setup and balance.

FIXED:

A bug, where players can't access jobs even if their permission was disabled.

LOCALE:

Added Spanish translation.

----------, Apr 5, 2025

1.8.0

ADDED:

Support for CustomFishing plugin.
Support for multiple jobs per job zone.
Explicit setting to toggle zone hours.
Missing editor GUI titles to the lang config.
PlaceholderAPI placeholders for: Total jobs level, Primary job names, Secondary job names, Jobs joined, Jobs max. joinable.

CHANGED:

Zone day hours accepts single hours value now.
Slightly improved zones GUI editor.

FIXED:

Compatibility with EvenMoreFish 2.0.
Zone payment multiplier not worked at all since EconomyBridge integration.

----------, Feb 18, 2025

1.7.5

FIXED:

A bug, where job level reward requirements not worked at all.
A bug, where players can get job level rewards over and over again by leaving the job.

----------, Dec 16, 2024

1.7.4

FIXED:

A minor issue with job's level reward requirements.

----------, Dec 14, 2024

1.7.3

IMPORTANT:

Now supports 1.21.1 or higher only.
Now requires EconomyBridge to work (super lightweight provides support for many currency plugins).
Update nightcore to v2.7.3

NEW:

Now you can set permission/rank requirements for job level rewards to provide unique rewards for players with specific ranks!

ADDED:

Required Permission option for job level rewards.
Required Ranks option for job level rewards.
Requirement Info option for job level rewards.

FIXED:

Preserved level rewards order in the GUI as it's defined in the config.

----------, Dec 9, 2024

1.7.2

IMPORTANT:

ExcellentJobs requires Java 21 or higher now.

ADDED:

Internal placeholder '%rawmod_name%' for job level rewards that fixes an issue where formatted values can not be parsed properly in commands.

FIXED:

A bug, where 'return' button in job preview GUI returns to job setting GUI instead of jobs GUI.
A bug, where 'return' button in job objectives GUI closes the GUI if it was opened from the job preview GUI.

----------, Nov 19, 2024

1.7.1

FROM VERSION v1.7.1 PLUGIN REQUIRES nightcore v2.7.0 OR NEWER!

YOU MUST UPDATE (IF INSTALLED) CoinsEngine TO v2.4.0 TO USE v1.7.1 OR NEWER.

Updated CoinsEngine integration.

----------, Oct 31, 2024

1.7.0

ADDED:

A GUI where player can select job state (primary or secondary) before join the job, as well as preview job's objectives.

FIXED:

A bug in default miner job configuration where it has duplicated 'nether_gold_ore' objective.
Minor code improvements.

----------, Oct 26, 2024

1.6.0

ADDED:

A GUI to browse all job level rewards.
Config option to toggle tracking of player placed blocks.

IMPROVED:

Better job level rewards. Now supports custom modifiers and allows you to scale your rewards with job levels!
Better zone selection highlightning.

FIXED:

A bug, where job progress bar not displayed if no XP was given for an objective.
A bug, where players can't get special orders due to orders limit because of order cooldown.

----------, Oct 4, 2024

1.5.3

FIXED:

Incorrect Special Order cooldowns.

----------, Sep 11, 2024

1.5.2

ADDED:

Config option to customize Zone's wand item.
PacketEvents support for Zone selection highlighting.
Zone setting to prevent interactions with specific blocks.
Missing permissions for zone commands.

IMPROVED:

Improved Zone creation by selecting cuboid first.
Improved Zone commands by adding dedicated /jobzone command and better permissions and descriptions.
Improved Zone editor, better button icons and layouts.

FIXED:

A bug, where repair_item objective works incorrect for shift clicks.
A bug, where Special Orders do not count for wildcard * objectives.
A bug, where Job State can not be properly localized due to wrong config paths.

----------, Sep 5, 2024

1.5.0

NEW:

Job Stats: View your daily, weekly, monthly (or any other period) earnings. Add 'stats' type button to the job_settings.yml.

FIXED:

A bug, where players can place water & lava in job zones.
A bug, where players can edit signs in job zones.

----------, Aug 16, 2024

1.4.2

ADDED:

Config option to make players to lost the jobs for which they don't have permission anymore.

FIXED:

A bit improved bone meal usage detection.
Updated to the latest LevelledMobs.

----------, Jul 22, 2024

1.4.0

ADDED:

Daily Limit display in Jobs GUI. Use %daily_limits% placeholder.
Per job setting to set color for job progress bar.

FIXED:

A bug, where bone mealed trees gives no XP / money even if not prevented by the config.
A bug, where Sugar Cane and Bamboo gives no XP / money at all.
Added missing sugar cane and bamboo objectives to the default farmer job.

----------, Jun 25, 2024

1.3.0

ADDED:

Allowed States setting for jobs. With this setting you can specify which jobs are available to be joined as primary/secondary only jobs.
Config option to disable job XP / money when in vehicle.
Default job: Builder.
LevelledMobs integration (higher mob level = more XP & money).
EvenMoreFish integration with custom action type: emf_fish_item.

FIXED:

A bug, where wildcard (*) objectives not counted in Special Orders.

----------, May 21, 2024

1.2.1

FIXED:

A bug, where brew_potion action type not worked at all.
A bug, where job progress bar displays incorrect income values.
A bug, where job levelup commands not worked for '0' level to run them on every levelup.

----------, Apr 19, 2024

1.2.0

ADDED:

Job Action Type: 'collect_honey'.
More detailed job progress bar indicating gained XP and future income for latest X seconds of work.

IMPROVED:

Job Objectives GUI now displays XP and payment values including active multipliers.

FIXED:

A bug, where Ignore Fertilized setting works incorrect in some cases.
A bug, where cooldown of Special Order works incorrect in some cases.

----------, Apr 15, 2024

1.1.0

ADDED:

Commands: /jobs join, /jobs leave and /jobs setstate.
Support for asterisk (*) objects in job objectives. Now you can use '*' to include all possible objects for a job objective.
Config option to increase XP and payment rewards depends on enchanting level cost for enchant_item objectives.
Default Jobs: Enchanter

FIXED:

A few bugs with 'level' and 'xp' commands.

----------, Mar 27, 2024

1.0.4

Fixed broken farming job
Fixed level command not triggers level rewards correctly.

----------, Mar 17, 2024

1.0.3

Update nightcore to v2.5.1 before update.

ADDED:

Disabled Worlds job option. Set a list of worlds, where a job will have no effect at all.
Initial State job option. Set initial job state for new players or newly created jobs for existent players.
'Milk Entity' job action type. Gives XP & payment for milk entities (such as cows, goats).

IMPROVED:

Reduced default payment values for Farmer job (for fresh setups only).

FIXED:

A bug, where default jobs being recreated when trying to delete them.
A bug, where plugin can not load in 1.18 and 1.19.
A bug, where zone selection works incorrect sometimes.

----------, Feb 24, 2024

1.0.2 Cooldown fix

Fixed special order cooldown bug

----------, Feb 12, 2024

1.0.2

FIXED:

A bug, where Job GUI can throw errors when Special Orders are disabled.
A bug, where Job Zones were unavailable due to broken permission check.
A bug, where players don't get XP for job objectives if they are not in their current Special Order.
Some errors when creating default job configs.
Some errors when ProtocolLib is not installed.

----------, Feb 11, 2024

1.0.1

Fixed a bug, where player placed blocks gives XP & money.

----------, Feb 4, 2024

Patch

Final patch for v1.0.0 with bugfixes

----------, Feb 3, 2024

View on SpigotMC

Resource Information

Author:

----------

Total Downloads: 369