[![Discord](https://img.shields.io/badge/Discord-dc.gg%2Fpaperstream-5865F2?style=flat-square&logo=discord&logoColor=white)](https://dc.gg/paperstream) [![Release](https://img.shields.io/modrinth/v/vjobs?style=flat-square&label=release&color=00AF5C)](https://modrinth.com/plugin/vjobs/versions) [![Downloads](https://img.shields.io/modrinth/dt/vjobs?style=flat-square&label=downloads&color=00AF5C)](https://modrinth.com/plugin/vjobs) [![Servers](https://img.shields.io/bstats/servers/33122?style=flat-square&label=servers&color=1E90FF)](https://bstats.org/plugin/bukkit/VJobs/33122) [![License](https://img.shields.io/badge/license-GPL--3.0-blue?style=flat-square)](https://www.gnu.org/licenses/gpl-3.0.txt) [![Built with Java 21](https://raw.githubusercontent.com/intergrav/devins-badges/v3/assets/cozy/built-with/java21_vector.svg)](https://adoptium.net/) [![Available for Paper](https://raw.githubusercontent.com/intergrav/devins-badges/v3/assets/cozy/supported/paper_vector.svg)](https://papermc.io/) [![Available for Purpur](https://raw.githubusercontent.com/intergrav/devins-badges/v3/assets/cozy/supported/purpur_vector.svg)](https://purpurmc.org/) [![Available for Spigot](https://raw.githubusercontent.com/intergrav/devins-badges/v3/assets/cozy/supported/spigot_vector.svg)](https://www.spigotmc.org/) [![Available for Bukkit](https://raw.githubusercontent.com/intergrav/devins-badges/v3/assets/cozy/supported/bukkit_vector.svg)](https://dev.bukkit.org/) [![Available for Folia](https://codeberg.org/LucasTHCR/VJobs/raw/branch/main/assets/badges/folia_vector.svg)](https://papermc.io/software/folia) [![Chat with us on Discord](https://raw.githubusercontent.com/intergrav/devins-badges/v3/assets/cozy/social/discord-plural_vector.svg)](https://dc.gg/paperstream) [![Available on Codeberg](https://raw.githubusercontent.com/intergrav/devins-badges/v3/assets/cozy/available/codeberg_vector.svg)](https://codeberg.org/LucasTHCR/VJobs)

# VJobs A data-driven jobs plugin. Players join a job, get paid for the actions that belong to it - breaking blocks, placing them, harvesting, killing mobs, fishing, brewing, enchanting, crafting - and level up toward a prestige reset. Every job, price, XP curve and multiplier lives in `config.yml`, nothing is hardcoded. Ten jobs ship by default: Miner, Farmer, Lumberjack, Hunter, Fisherman, Builder, Digger, Brewer, Enchanter, Weaponsmith. You can add, remove or rebalance any of them without touching code. For the full breakdown of every job, action and config key, see [FEATURES.md](FEATURES.md). A few things worth knowing up front: - Leveling uses `xp-base * level ^ xp-exponent`, so the curve is yours to shape - Prestige resets a job to level 1 in exchange for a permanent payout bonus, up to a max tier you set - Multipliers stack per-world, per-permission, and as timed server-wide boost events - A per-location cooldown on payouts stops the usual regen-farm and mine/replace tricks - Job limits and switch cooldowns are both permission-based, so VIP tiers can hold more jobs or switch faster - Browsing and joining happens through a chest GUI that works fine on Bedrock through Geyser, and each job has its own leaderboard - Storage is SQLite or MySQL, pooled with HikariCP - PlaceholderAPI is supported (`%jobs_level_%`, `%jobs_xp_%`, `%jobs_prestige_%`), payouts go through Vault ## Requirements - Bukkit, Spigot, Paper, Purpur, or Folia: 1.21+ (Java 21) - [Vault](https://www.spigotmc.org/resources/vault.34315/) with an economy provider (required for payouts) - [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) (optional, for placeholders) ## Installation 1. Download the latest `VJobs-.jar` and drop it into your server's `plugins/` folder. 2. Start the server once to generate `config.yml` and `messages.yml`. 3. Edit `config.yml` to adjust jobs, prices, XP, and storage settings. 4. Reload with `/vjobs admin reload` or restart the server. ## Commands | Command | Description | |---|---| | `/vjobs` or `/vjobs gui` | Opens the job selection GUI | | `/vjobs join ` | Joins a job | | `/vjobs leave ` | Leaves a job | | `/vjobs info ` | Shows payout rates for a job | | `/vjobs top ` | Opens the leaderboard for a job | | `/vjobs prestige ` | Prestiges a maxed-out job | | `/vjobs togglenotify` | Toggles action bar payout notifications | | `/vjobs admin reload` | Reloads config and messages | | `/vjobs admin set ` | Sets a player's job level | `/jobs` and `/job` work as aliases for `/vjobs`. ## Permissions | Permission | Description | Default | |---|---|---| | `jobs.use` | Use the jobs system | `true` | | `jobs.admin` | Admin commands (reload, set) | `op` | | `jobs.limit.<2-5>` | Hold additional jobs simultaneously | `false` | | `jobs.cooldown.hour` | Shortens the job-switch cooldown to 1 hour | `false` | | `jobs.cooldown.instant` | Removes the job-switch cooldown | `false` | | `jobs.multiplier.vip` / `jobs.multiplier.mvp` | Configurable payout multipliers (see `config.yml`) | - | ## Configuration All jobs, action rewards, XP curve, prestige settings, multipliers, and storage options live in `config.yml`. Messages are fully customizable in `messages.yml`. Both files are commented to explain every option. ## Building from source ```bash mvn clean package ``` The shaded jar is produced at `target/VJobs-.jar`. ## License Released under the [MIT License](LICENSE).

VJobs

1.0-RELEASE