Vulcan Punishments+ Documentation

Vulcan Punishments+ has recently had a large update, opensourcing the project and changing ways it works for ease of use.
This documentation is for the latest version of VP+, so please make sure your version of VP+ is up to date.


What is Vulcan Punishments+?

Vulcan Punishments+ is a Minecraft Vulcan Anticheat Addon. It allows users to set up tiered punishment levels for punishments issued 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.

Vulcan Punishments+ uses the Vulcan API, (Version 26.2.0 and Up) so you will not need to set up anything except your actual punishments

Look into the /plugins/Vulcan-PunishmentsPlus/ folder for the configuration file (config.yml) and configure it to your liking.

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.
# 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

Information about configuring the config

The # --- Punishments --- section allows you to define the specific commands executed in replacement of Vulcan kicking the player. You can execute single commands, multiple commands, or log an event without taking action.

Multi-Commands

If you wish to trigger multiple commands simultaneously on the same punishment, you can do this by changing the command: section under the punishment to commands: and use a numbered list.

Example:


punishment-1:
  commands:
    1: command to execute
    2: another command to execute
punishment-2:
  command: example command
    
Silent Monitor · Version 26.2.0 and Up

You can also silently monitor a player. For instance if you don't want a command to be executed, but still log it as them being flagged, set the command: setting to ignore.

This will not execute a command, however it will still add their punishment to the database.

Example:


punishment-1:
  command: ignore
punishment-2:
  command: kick %player%
    
Placeholders

You can use the %player% placeholder any time within the punishment command sections. This will replace the %player% variable with the player that is in question.

Vulcan Punishments+ does not add any new punishment commands.
The commands mentioned within the default config are for example purposes only. You will need an external punishment plugin or use commands your server already has.


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.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?

Yes, but you must still fill out all 10 entries in the table. If you only want, for example, only 4 punishments, you can repeat the final command for the remaining slots as shown in the example below.


punishment-1:
  command: example-command-1
punishment-2:
  command: example-command-2
punishment-3:
  command: example-command-3
punishment-4:
  command: example-command-4
punishment-5:
  command: example-command-4
punishment-6:
  command: example-command-4
punishment-7:
  command: example-command-4
punishment-8:
  command: example-command-4
punishment-9:
  command: example-command-4
punishment-10:
  command: example-command-4
    
Alternatively, you can use the new ignore flag for the extra commands. Version 26.2.0 and Up

punishment-1:
  command: example-command-1
punishment-2:
  command: example-command-2
punishment-3:
  command: example-command-3
punishment-4:
  command: example-command-4
punishment-5:
  command: ignore
punishment-6:
  command: ignore
punishment-7:
  command: ignore
punishment-8:
  command: ignore
punishment-9:
  command: ignore
punishment-10:
  command: ignore
    

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: Contribution: Suggestions Other:



Ray's Plugin Documentation

© Ray_y 2026 ยท License: GPL-2.0 | Source: View Source