Installation - PaintballWarEdition/Paintball-Wiki GitHub Wiki

Header-Image

Prerequisites

Spigot

You must have Spigot (https://www.spigotmc.org/) installed on your server.
Usually every Paintball release will state which versions of Spigot/Bukkit it is compatible with.

Required Dependencies

Paintball bundles all its required dependencies within one Paintball-<version>.zip file:

  • Armory: This plugin provides the weapons and other related gadgets. You can find more information about it in the separate Armory-Wiki.
  • BlaCommon: This plugin provides common utilities and code shared between Armory and Paintball (and potentially other projects).

Optional Dependencies

A few additional features require the following plugins to be running on your server:

Installation

  1. Stop your server.
  2. Download the latest version of Paintball from here.
  3. Always read the changelogs: These can contain important notices about known issues, or special updating instructions.
  4. Extract the Paintball-<version>.zip file and move all contained files into your server's plugins folder: Paintball-<version>.jar, Armory-<version>.jar and BlaCommon-<version>.jar
  5. Start your server.
  6. Check the complete console output / server log: If all went well there should be no errors, stack traces, or warnings.

Directory structure

Paintball will create its base directory inside the server's plugins folder at:
<serverRoot>/plugins/Paintball/

The whole directory structure looks like this:

../plugins/ # The server's plugins folder
    +--Paintball/ # Base directory for Paintball
        |-- addons/ # Addons can create sub-folders for their data inside here
        |-- arenas/ # Contains the arenas
        |-- gamemodes/ # Contains sub-folders for the different gamemodes
        |-- languages/ # Contains language files
             |-- addons/ # Addons can place their language files here
             |-- core/ # Contains the language files for Paintball itself
                 |-- default_enUS.txt
                 +-- ..
        |-- lobbies/ # Contains the lobbies
        |
        |-- config.yml # Stores the core Paintball settings
        |-- data.db # SQLite database file which stores player info and statistics
        |-- levels.yml # Stores the levels
        |-- loadouts.yml # Stores the loadouts
        |-- playlists.yml # Stores the playlists
        |-- shop-items.yml # Stores the shop items (for use in shops)
        |-- shops.yml # Stores the shops
        |-- version.dat # Contains versioning information (don't modify this!)

What's next?

Paintball should work right out of the box after successful installation.

  • In case you are running some sort of permissions plugin on your server, take a look at the Permissions page to assign your admins and players the correct Paintball-related permission nodes.

  • While the default configuration of Paintball should work just fine for most servers, you might want to look through the available options and adjust whatever you need. Take a look at the Configuration page.

  • To get everything setup in-game and your first Paintball matches running, take a look at the Basic Setup page.

⚠️ **GitHub.com Fallback** ⚠️