Viper Jobs

Viper Jobs is a high-performance, Server-Side ONLY configurable job & quest system for Minecraft 1.211.21.11, 26.126.1.2, and 26.2. Players earn money, XP, and points for mining and hunting with daily quests, level-up rewards, leaderboards, and seamless Viper Economy integration. Zero client mods required. Fully configurable design your own jobs, actions, rewards, quests, and monthly prizes.

Supported Versions

Purpose & Function

The core mission of this project is to give server administrators total control over how players earn rewards and progress.

• 21 Custom Jobs: Digger, Miner, Farmer, Builder, Hunter, Lumberjack, Fisherman, Butcher, Warrior, Alchemist, Beekeeper, Nether Explorer, Smith, Enchanter, Ranger, Archaeologist, Herbalist, Conqueror, Explorer, Trapper, and Guardian each with its own actions, XP curve, join/leave fees, and max level.
• Action-Based Rewards: Reward block breaking and entity kills with money, XP, and job points every action's money is individually configurable.
• Low-Pay Defaults: All money rewards ship tuned low and can be raised to whatever you like in job_config.json.
• Level-Up Rewards: Grant money, XP, points, and even run commands when a player reaches a level milestone with a message on the player's screen (action bar).
• Daily Quests: Automatically assign a configurable number of quests per day with money rewards.
• Leaderboards: /jobs top <job> [page] for per-job levels and /jobs gtop [page] for total level across all jobs paginated (10 players per page).
• Monthly Prizes: Auto-grant configurable money, XP, points, and commands to the top players each month.
• Viper Economy Integration: Auto-detects the Viper Economy mod (viper-economy) and its commands money rewards just work.
• Payment Safety: Aggregated payments, configurable retries, and a failure policy keep payouts reliable even when the economy is flaky.
• Hot Reload: Change config on the fly no server restart needed.

Rewards & Features

Enhance your server setup! Check out my other server-side mods over at : Fabric Server Essentials

In-Game Commands

Player commands:

Admin commands (/jobsadmin, requires operator level 2+):

Configuration

Edit config/viper-jobs/*.json after first launch:

economy.json economy integration:

{
  "enabled": true,
  "autoDetectCommands": true,
  "validateCommandsOnStartup": true,
  "disableMoneyRewardsWhenUnavailable": true,
  "providerModIds": ["viper-economy", "viper_economy"],
  "commands": {
    "deposit": "givemoney {player} {amount}",
    "withdraw": "takemoney {player} {amount}",
    "setBalance": "setmoney {player} {amount}",
    "getBalance": "bal {player}",
    "reloadEconomy": "ecolog"
  },
  "formatting": {
    "decimalPlaces": 2,
    "minimumPayment": 0.01,
    "roundingMode": "HALF_UP"
  },
  "aggregation": {
    "enabled": true,
    "intervalTicks": 20
  },
  "failureHandling": {
    "policy": "GRANT_NON_MONEY_REWARDS",
    "maximumRetries": 1,
    "retryDelayTicks": 20,
    "logFailures": true,
    "notifyAdministrators": true
  }
}

job_config.json jobs, rewards, and monthly prizes (auto-created on first launch; an old jobs.json is migrated automatically):

{
  "settings": {
    "maxJobsPerPlayer": 1,
    "baseXpForLevel": 100.0,
    "xpGrowth": 1.5,
    "incomeLimitEnabled": false,
    "incomeLimitPerDay": "0",
    "moneyRewardsEnabled": true,
    "levelUpMoneyEnabled": true,
    "levelUpMoney": "6",
    "joinFee": "0",
    "leaveFee": "0",
    "notifyOnPay": false,
    "notifySummaryEnabled": true,
    "notifySummaryIntervalMinutes": 30,
    "topListMax": 10,
    "broadcastJoinLeave": false,
    "allowLeave": false,
    "monthlyPrizesEnabled": true,
    "monthlyPrizesDay": 1,
    "monthlyPrizes": [
      { "rank": 1, "money": "500", "xp": 500, "points": 50, "commands": ["say {player} won the Viper Jobs monthly prize!"] },
      { "rank": 2, "money": "250", "xp": 250, "points": 25, "commands": [] },
      { "rank": 3, "money": "100", "xp": 100, "points": 10, "commands": [] }
    ],
    "globalMoneyMultiplier": 1.0
  },
  "jobs": [
    {
      "id": "miner",
      "meta": { "name": "Miner", "description": "Mine ores and earn money" },
      "maxLevel": 100,
      "joinFee": "0",
      "leaveFee": "0",
      "actions": [
        {
          "id": "diamond",
          "type": "BLOCK_BREAK",
          "blocks": ["minecraft:diamond_ore", "minecraft:deepslate_diamond_ore"],
          "xp": 20.0,
          "points": 3.0,
          "money": "1.11"
        }
      ],
      "levelRewards": [
        { "level": 10, "money": "11", "xp": 0, "points": 10, "commands": ["say {player} reached Miner level 10!"] }
      ]
    }
  ]
}

Money control: Every action has its own money value lower it further for low pay, raise it for a richer server. settings.globalMoneyMultiplier scales all money at once. allowLeave: false locks players into their job (admins bypass with /jobsadmin leave).

Monthly prizes: On the configured day of the month (monthlyPrizesDay), the ranked top players get their configured prize once per month. Edit money/XP/points/commands freely; commands supports {player}, {uuid}, {job}, {job_id}, {reason}.

Notification notes: By default there are no per-action chat messages (no spam while mining). Instead a colored earnings summary is sent every notifySummaryIntervalMinutes (default 30) only if you earned something in that window. Level-ups always show a message in both chat and the action bar. Set notifySummaryEnabled: false to disable the summary, or notifyOnPay: true for instant per-action messages. topListMax caps leaderboard page size (default 10).

quests.json daily quests:

{
  "enabled": true,
  "daily": true,
  "resetHourUtc": 0,
  "questsPerDay": 3,
  "quests": [
    {
      "id": "miner_coal",
      "name": "Coal Rush",
      "description": "Mine 64 coal ore.",
      "job": "miner",
      "action": "coal",
      "required": 64,
      "rewards": { "money": "20", "xp": 100, "points": 5 }
    }
  ]
}

Money notes: Money rewards are paid through the active economy provider (Viper Economy by default). If the economy mod or its commands can't be detected, money rewards are automatically disabled job XP, points, quests, and non-money rewards keep working. If your server uses a different economy mod, point the commands in economy.json at its give/take/set commands.

Hot-reload config in-game: /jobsadmin reload

Installation

1. Drop the JAR for your Minecraft version into your server's mods/ folder
2. Install Fabric Loader 0.19.3+ (all versions)
3. Install Fabric API (required for all versions)
4. (Optional) Install Viper Economy to enable money rewards the mod auto-detects it
5. Start the server configs auto-create at config/viper-jobs/ (economy.json, job_config.json, quests.json)
6. Review and customize the configs to your needs
7. Run /jobsadmin reload or restart the server

If you previously ran a build that used jobs.json, delete it after the first launch with the new build the mod migrates it to job_config.json automatically.

Built for administrators who want a flexible, reliable job and quest system with zero client overhead. Design your own jobs, tune your economy integration, and let your players earn their keep.