Viper Jobs

Server-side jobs, quests and leaderboard system for Fabric servers. Players join jobs and earn money, XP and points for mining, digging, farming, chopping, fishing, hunting and more. The mod includes daily quests, level-up rewards, paginated leaderboards and monthly top-player prizes. It works with Viper Economy (auto-detected) or any other economy mod through configurable console commands. No client mods are required.

What the mod is

Viper Jobs adds an RPG-style progression layer to a server. Administrators define jobs (for example Miner, Farmer or Hunter), and each job pays players for specific in-game actions such as breaking blocks or killing entities. Every action grants job XP (which levels the job up), job points and money. On top of that the mod runs daily quests, per-job and global leaderboards, and automatic monthly prizes for the best players. Everything is driven by JSON config files, and most changes can be applied live with /jobsadmin reload without restarting the server.

Features

• 21 ready-made jobs: Digger, Miner, Farmer, Builder, Hunter, Lumberjack, Fisherman, Butcher, Warrior, Alchemist, Beekeeper, Nether Explorer, Smith, Enchanter, Ranger, Archaeologist, Herbalist, Conqueror, Explorer, Trapper, Guardian
• Every job, action, reward, fee and level cap is configurable; custom jobs can be added freely
• Per-action money, XP and point rewards with low-pay default tuning
• Level-up money, XP, points and custom console commands, plus an on-screen action-bar message
• 24 daily quests with configurable goals and rewards
• Per-job (/jobs top) and global (/jobs gtop) leaderboards, paginated at 10 entries per page
• Monthly prizes for the top-ranked players (money, XP, points and commands), paid automatically once per month
• Per-player money multipliers and per-player job limits (players/<name>.json files)
• Optional leave lock (allowLeave), daily income limits, scheduled bonuses, join and leave fees
• Reliable payouts through payment aggregation, automatic retries and configurable failure policies
• Earnings summary messages instead of chat spam, fully configurable notification settings
• JSON persistence for all player progress, hot reload support, zero client overhead

Player commands

Admin commands

All admin commands use /jobsadmin and require operator level 2 or higher.

Configuration

All files are created on first launch under config/viper-jobs/. After editing, run /jobsadmin reload (or restart the server) to apply them.

economy.json

Controls how money rewards are paid out.

job_config.json

Defines all jobs, their actions, rewards and the global job settings. An old jobs.json file is migrated automatically.

Placeholders supported in reward commands: {player}, {uuid}, {job}, {job_id}, {reason}.

quests.json

Controls the daily quest system.

players folder

players/<playername>.json files hold per-player overrides and are created automatically when a player joins a job or receives an admin override. The jobs list is kept in sync on every join and leave.

data folder

data/ stores all persistent player progress: job levels, XP, points, daily earnings, quest states and the earnings ledger. You normally never need to edit these files by hand.

Money notes

Money rewards are paid through the active economy provider (Viper Economy by default, auto-detected). If no economy mod or usable money commands are found, money rewards are automatically disabled while job XP, points, quests and non-money rewards keep working. To use a different economy mod, point the commands section of economy.json at its give, take and set commands and run /jobsadmin reload.

Installation

1. Install Fabric Loader 0.19.3 or newer and Fabric API.
2. Use Java 21 for Minecraft 1.21.x, or Java 25 for Minecraft 26.x.
3. Download the file matching your Minecraft version (1.21, 26.1, 26.2 or 26.3) and put it in the server mods folder.
4. Optional: install Viper Economy for money rewards (it is detected automatically).
5. Start the server. Configs are created under config/viper-jobs/.
6. Review and customize the configs to your needs.
7. Run /jobsadmin reload or restart the server to apply changes.