Installation

This guide walks you through installing zJobs on your Minecraft server.

Requirements

Requirement	Version
Minecraft	1.21+
Java	Java 21 (required)
Server Software	Paper, Purpur, or Folia

Dependencies

Required

Plugin	Description
Vault	Economy integration

Optional

Plugin	Description
zMenu	Custom GUI menus
zItems	Job boost runes
PlaceholderAPI	Placeholder support

Download

You can download zJobs from:

SpigotMC: https://www.spigotmc.org/resources/zjobs.120454/
Discord: Development builds available in #builds channel at discord.groupez.dev

Installation Steps

Step 1: Install Vault

zJobs requires Vault for economy support:

Download Vault
Place it in your plugins/ folder
Install an economy plugin (EssentialsX, CMI, etc.)

Step 2: Download zJobs

Download the latest version of zJobs.jar from one of the sources above.

Step 3: Install the Plugin

Stop your Minecraft server if it's running
Place the zJobs.jar file in your server's plugins/ folder
Start your server

Step 4: Verify Installation

After starting your server, verify that zJobs loaded correctly:

Check the server console for:
```
[zJobs] zJobs has been enabled!
```
Run /jobs in-game to verify commands work

Step 5: Initial Configuration

After the first startup, zJobs will create the following folder structure:

plugins/zJobs/
├── config.yml           # Main configuration
├── jobs/                # Job definitions
│   ├── miner.yml
│   ├── farmer.yml
│   ├── hunter.yml
│   └── fisherman.yml
├── storage/             # Player data
└── inventories/         # GUI menus (if using built-in)

Configuration

config.yml

The main configuration file:

# Maximum jobs a player can have at once
max-jobs: 3

# Allow players to leave jobs freely
allow-job-leave: true

# Cooldown between job changes (in seconds)
job-change-cooldown: 3600

# Economy settings
economy:
  # Money format
  format: "#,##0.00"
  # Currency symbol
  symbol: "$"

# Database settings
storage-type: SQLITE

# MySQL configuration (if storage-type is MYSQL)
mysql:
  host: localhost
  port: 3306
  database: zjobs
  username: root
  password: ""

Economy Setup

zJobs requires a working economy through Vault. Supported economy plugins:

EssentialsX - Full-featured server essentials
CMI - Comprehensive server management
PlayerPoints - Points-based economy
CoinsEngine - Custom currency support

Verify Economy

Test your economy setup:

/eco give <player> 100

If this works, zJobs will be able to give money rewards.

Updating

To update zJobs:

Download the latest version
Stop your server
Backup your plugins/zJobs/ folder
Replace the old zJobs.jar with the new one
Start your server
Run /jobs reload if needed

Backup First

Always backup your plugins/zJobs/ folder before updating.

Troubleshooting

Plugin Not Loading

If zJobs doesn't appear in /plugins:

Check console for errors during startup
Verify you're using Java 21
Verify you're using Minecraft 1.21+
Ensure Vault is installed and enabled

Economy Not Working

If players don't receive money:

Verify Vault is installed: /plugins
Check you have an economy plugin
Test with /eco give <player> 100
Check console for economy errors

Jobs Not Saving

If player job data isn't saved:

Check file permissions on plugins/zJobs/storage/
Verify database connection if using MySQL
Check console for storage errors

Requirements​

Dependencies​

Required​

Optional​

Download​

Installation Steps​

Step 1: Install Vault​

Step 2: Download zJobs​

Step 3: Install the Plugin​

Step 4: Verify Installation​

Step 5: Initial Configuration​

Configuration​

config.yml​

Economy Setup​

Verify Economy​

Updating​

Troubleshooting​

Plugin Not Loading​

Economy Not Working​

Jobs Not Saving​

Next Steps​