Getting started

This guide will help you install and configure ZelBounty on your server.

Installation

1

Download

Download the ZelBounty plugin JAR file.

2

Place

Place the JAR file in your server's plugins folder.

3

Install Vault

Install Vault if you haven't already (required dependency).

4

Install an Economy Plugin

Install an Economy Plugin (e.g., EssentialsX, CMI).

5

Restart

Restart your server.

First Setup

After the first server start, ZelBounty will create the following files:

plugins/ZelBounty/
├── config.yml          # Main configuration
├── messages.yml        # All plugin messages
├── sounds.yml          # Sound effects
├── bounties.db         # SQLite database (default)
└── guis/
    ├── bounty.yml          # Bounty list GUI
    ├── bounty_confirm.yml  # Confirmation GUI
    └── admin_history.yml   # History GUI

License Activation

ZelBounty requires a valid license key to function.

1

Open config.yml.

2

Add your license key:

license-key: "YOUR-LICENSE-KEY-HERE"

3

Restart the server.

Get your license key from discord.gg/pikzstudios

Basic Configuration

Here are the essential settings to configure:

Set Bounty Limits

bounty:
  minimum-addable: 100.0    # Minimum bounty amount
  maximum-addable: 1000000.0  # Maximum bounty amount (0 = unlimited)

Enable/Disable Features

confirm-gui: true           # Show confirmation before placing bounty
bounty-announce: true       # Announce bounties server-wide
allow-bounty-on-self: false # Allow players to bounty themselves

Blacklist Worlds

Prevent bounty claims in certain worlds:

blacklisted-worlds:
  - "hub"
  - "spawn"
  - "lobby"

Permissions Setup

Give players basic bounty permissions:

# Basic bounty usage
zelbounty.command.player.add   # Place bounties
zelbounty.command.player.gui   # Open bounty GUI
zelbounty.command.player.info  # Check bounty info

For admins:

zelbounty.command.admin        # All admin commands

Testing

1

Give yourself permissions.

2

Run /bounty gui to open the bounty browser.

3

Run /bounty add <player> <amount> to place a bounty.

4

Have the target player get killed to test reward distribution.