Vulcan Punishments+ Documentation

What is Vulcan Punishments+?

Vulcan Punishments+ is a Vulcan AntiCheat Addon that allows you to have different punishments depending on how many times the player has been punished by Vulcan.

Prerequisites

To use Vulcan Punishments+ on your server, you will need:


Getting Started

To set up and use Vulcan Punishments+, first download the plugin and the Vulcan Anticheat if you haven't already.

Vulcan Anticheat: https://www.spigotmc.org/resources/vulcan-anti-cheat-advanced-cheat-detection-1-8-1-21-7.83626/

Vulcan Punishments+: https://www.spigotmc.org/resources/vulcan-punishments.123985/

You will then need to add the plugin to your server's plugin folder, usually under /plugins for a traditional spigot or paper install.

Restart your server. If Vulcan's API is not already turned on, then the plugin will do so for you, however you will need to restart your server again. Look in the console for logs.

Log onto your server and run the command /vpp-autosetup

After those steps have been completed, it is quite simple. All you need to now do is customize the punishment commands.

To do this, go to the Vulcan Punishment+'s config.yml. You can find this at: ./plugins/Vulcan-PunishmentsPlus/config.yml. Please do not edit the db.yml file.

The punishments will execute from 1-10 depending on how many times Vulcan Kicks them for reaching the punishment threshold.

If a player reaches punishment 10, then if there are any more punishments from vulcan, then punishment 10 will execute again.



Please note: This plugin/addon does not add any punishment commands. You will have to install a plugin such as essentials, advancedban, ect to have commands like /warn, /tempban, ect.

Save the config file, then run /vulcan-punishmentsplus reload to reload the config.



Configuration

The configuration file for Vulcan Punishments+ are stored at /plugins/Vulcan-PunishmentsPlus/.

The configuration is pretty self-explanatory. You can edit the files and then save them. Once you've configured them to your liking, run the command /vulcanpunishmentsplus reload in game or through console to reload the config and language files.

For reference, the default configuration file is:

# Vulcan Punishments+ | Plugin Config
# Made by Ray_y
# Need help? Visit the Support Discord at: https://discord.gg/EshbnCjhfc
# THE SUPPORT LINK ABOVE IS NOT FOR VULCAN
# DO NOT ASK FOR HELP WITH VULCAN IN RAY'S SUPPORT SERVER.
# You must have Vulcan installed on your server for the plugin to work. The plugin will disable itself if Vulcan is not detected.

# --- Options ---
plugin-prefix: "&7[Vulcan Punishments&c+&7]"
# Colour codes are allowed in the plugin prefix.

check-for-updates: true
# Automatically check if a plugin update is available

# --- Messages ---
# All messages accept colour codes.
message-no-permission: "&cYou do not have permission to execute that command!"
# Will send when a player without permissions executes a command.
# Colour codes are allowed

message-reload: "&fReloading Plugin Config!"
# Will send when a player runs /vulcanpunishmentsplus reload
# Colour codes are allowed

message-reload-success: "&fReloaded!"
# Will send if a config reload is successful
# Colour codes are allowed

message-update-available: "&7There is an update available to download. Current Version: %current_version%. Latest Version: %latest_version%"
# Message sent if there is an available update to download (if check-for-updates is true).
# Colour codes are allowed
# Placeholders:
# %current_version% - Plugin's Current Version.
# %latest_version% - Latest Plugin Version
# %link% - Link to download the latest version

message-cleared-punishments: "&fYou have reset &7%player%&f's Vulcan punishment Level."
# Message sent when /reset-vulcanpunishments  is executed.
# Placeholders:
# %player% - Player in argument 1 (player)

message-invalid-player: "&fThat player is not in the database."
# Message that is sent when a player tries to reset the punishment level of someone who isn't in the database.

message-unknown-argument: "&cUnknown Argument"
# Message that is sent when you execute a command (from the plugin) that does not recognise an argument

# --- Punishments ---
# When editing punishment commands, don't include the /.
# Note: This plugin does NOT add punishment commands. That is up to you to have punishment commands.
# This plugin only lets you have different punishments depending on how many times vulcan has punished them.
# To set the punishments up, you have to change the default "kick %player% [Vulcan] Unfair Advantage" command to "vpp-cmd %player%"
# You can use literally almost any text-editing tool for this, even Notepad. Just find and replace.
# DO NOT EDIT THE db.yml FILE. If you need to reset someone's punishment level, use /reset-vulcanpunishments 
punishment-1:
  command: warn %player% Cheat Detection
punishment-2:
  command: warn %player% Cheat Detection
punishment-3:
  command: warn %player% Cheat Detection
punishment-4:
  command: kick %player% Cheat Detection
punishment-5:
  command: kick %player% Cheat Detection
punishment-6:
  command: kick %player% Cheat Detection
punishment-7:
  command: tempban %player% 1d Cheat Detection
punishment-8:
  command: tempban %player% 5d Cheat Detection
punishment-9:
  command: tempban %player% 10d Cheat Detection
punishment-10:
  command: ban %player% Cheat Detection


Commands and Permissions

Vulcan Punishments+ has many commands and permissions for those commands. The following list will show you all commands and permissions that are a part of the plugin.

Commands
/vulcan-punishmentsplus
- description: Main command for the plugin.
- aliases: vpp
/reset-vulcanpunishments [player]
- description: Resets the Punishment Level for a player
/vpp-autosetup
- description: First time plugin setup command
        
Permissions
vulcanpunishmentsplus.help
- description: Allows the player to run the /vulcan-punishmentsplus help command.
vulcanpunishmentsplus.support 
- description: Allows the player to run the /vulcan-punishmentsplus support command.
vulcanpunishmentsplus.reload 
- description: Allows the player to run the /vulcan-punishmentsplus reload command.
vulcanpunishmentsplus.viewabout 
- description: Allows the player to run the /vulcan-punishmentsplus about command.
vulcanpunishmentsplus.autosetup
- description: Allows the player to run the /vulcan-punishmentsplus autosetup command.
vulcanpunishmentsplus.resetpunishments
- description: Allows the player to run the /reset-vulcanpunishments [player] command to reset someone's punishment level
vulcanpunishmentsplus.updatecheck
- description: Players with this permission will get a notice when they join if there is an available update for the plugin.
        


Q&A

What is Vulcan Punishments+?

Vulcan Punishments+ is a Vulcan AntiCheat Addon that allows you to have different punishments depending on how many times the player has been punished by Vulcan.

This plugin does not contain Vulcan's Anticheat. You need to have Vulcan already installed on your server for this plugin to work.

How do I set up Vulcan Punishments+?

You can read the Getting Started Article here: Click

I only want (x) Punishments instead of the 10 in the config. Can I only put (x) amount?

Although you may want to only have say, 4 amounts of different punishments, you will have to fill the table out. An example is shown below.

The plugin is disabling! Help!

If you do not have the Vulcan Anti-Cheat Plugin intalled, then the Vulcan Punshments+ Plugin will disable automatically. Please check the console for a more detailed description on the issue. If you need support, please contact us on our support discord server.



Get Help

If you are confused on how to use the plugin, found a bug, or want to get in contact, please select the most relevent option from the options below.

Issues: Need help with features: Suggestions Other:



Ray's Plugin Documentation

© Ray_y 2026 · License: GPL-2.0 | Source: View Source