JobX

💼 JobX - The Ultimate Citybuild Job System

JobX is a highly configurable job and reward system designed for Paper and Spigot servers (Vault required). Players earn money and gain XP by performing everyday actions such as mining, killing entities, fishing, crafting, trading, or exploring. The plugin features a complete leveling system, automated periodic payouts, hourly income limits, server-wide top lists, per-player YAML storage, and intuitive in-game GUIs for both players and admins.

---

✨ Main Features

• 10 Default Jobs: HUNTER, MINER, WOODCUTTER, DIGGER, FARMER, EXPLORER, CRAFTER, TRADER, FISHER, BUILDER.
• Job Leveling: Earn XP per action with a fully customizable level-up XP curve. Higher levels require significantly more XP.
• Periodic Payouts: Earnings are bundled and automatically paid out via Vault at fixed intervals (Default: every 1200 ticks (60 seconds)).
• Income Limits: Optional hourly/timed earnings limits with an integrated cooldown display.
• Statistics: Clear daily, weekly, and monthly statistics tracked per player and job.
• Server-Wide Leaderboards: Top lists for every single job (based on Level + XP), viewable directly inside the GUI (up to 28 slots).
• Smart Listeners: Full tracking and XP/money allocation for BlockBreak, BlockPlace, EntityKill, Fishing, Crafting, Trade, and PlayerMove.
• Data & Security: Persistent storage in data/users/<UUID>.yml. Safe Plugman reload notices and error-free reload handling.

---

🖥️ In-Game GUIs & Commands

👤 For Players (/job or /jobx)

Opens a visually appealing interface displaying all active jobs:

• Personal level & XP status including visual progress bars.
• Current earnings per action (Formula: baseIncome + (level * levelUpMultiplier)).
• Head slot showing the current hourly limit status (earned / max / reset).
• Direct access to job leaderboards.

👑 For Admins (/jobadmin or /jobxadmin)

Allows editing almost all plugin values directly inside the game (utilizing Anvil-UIs for text inputs):

• Toggle jobs on/off, change the DisplayName, and swap GUI icons (Material).
• Adjust the baseIncome and levelUpMultiplier values.
• Set specific block and entity XP values.
• Configure job earnings limits and manually reset individual player limits.

---

🔑 Commands & Permissions

• /job or /jobx — Opens the player job GUI. (No permission required)
• /jobadmin or /jobxadmin — Opens the admin GUI. (Permission: jobcfg.admin)
• /jobadmin resetlimit <player> — Resets the hourly income limit for a specific player. (Permission: jobcfg.admin.resetlimit)
• /jobadmin reload — Safely reloads all configuration files. (Permission: jobcfg.admin.reloadPlugin)

---

🚀 Installation & Dependencies

Prerequisites:

• Server: Paper or Spigot (Paper heavily recommended)
• Economy: Vault

Installation Steps:

1. Download the JobX.jar file.
2. Place the file inside your server's plugins folder.
3. Start the server to generate the default configuration files.
4. Customize the config.yml to your liking and reload it via /jobadmin reload.

---

⚙️ Configuration Snippet (Example)

prefix: "§b§lJobX §7» "

JobLimitEnabled: true
JobLimit: 500.0
JobLimitCooldown: 3600
TopListSize: 10

Jobs:
  MINER:
    Enabled: true
    DisplayName: "Mining"
    Material: "DIAMOND_PICKAXE"
    baseIncome: 5.0
    levelUpMultiplier: 1.5

blocks:
  MINER:
    DIAMOND_ORE:
      XP: 20.0

---

⚡ Special Perks & Boosters

JobX comes packed with advanced gameplay features that can be managed via GUI or permissions:

• Boosters: Temporary global or personal multipliers to accelerate your gameplay (e.g., active 2x Money & XP for 30 minutes) Or Booster like Fly and Haste
• Job Rewards: Custom item packages that players can claim every 5 job levels they achieve.

---

❓ FAQ (Frequently Asked Questions)

Q: Is Vault strictly required?
A: Yes. Without Vault and a running economy provider, the system cannot distribute cash rewards to players.

Q: Can I disable specific jobs entirely?
A: Yes, you can do this either by setting Enabled: false in the config.yml or instantly via the /jobadmin GUI.

Q: Are XP still awarded if a player hits their money limit?
A: Yes! Once a player reaches their hourly money cap, cash earnings freeze, but they continue to gather job XP normally.

---

🛠️ Support & Contact

If you encounter any bugs or want to suggest new features, feel free to reach out! Please always include your server logs and the affected player file from plugins/JobX/users/<UUID>.yml when reporting issues.

---

📜 Credits & Inspiration

This plugin was heavily inspired by the features found on the popular German Citybuild server OPSUCHT.net.