Articles on: Plugin Setup

How to install and use Vulcan anticheat [Java]

In this article, we will install and configure the Vulcan Anticheat plugin for Bukkit/Spigot/Paper/Pufferfish/Purpur. Vulcan acts silently by simply observing players actions and flags for things out of the vanilla boundaries.

📢 Now, let's begin! Installing and configuring this plugin only requires a few easy steps! 📢

🔌 Installing the plugin 🔌

Go to this link and buy/download the plugin.
To upload the file to WitherPanel, drag and drop it into the plugins folder. Alternatively, you can upload it via sFTP.
In order to apply the changes, restart your server.

⌨️ Commands

Vulcan provides a number of commands that you can use to manage checks and view players profiles.

Here are some of the most common commands:

/alertsToggles on and off Vulcan's alertsvulcan.alerts
/vulcan helpShows Vulcan's help
/vulcan menu or /vulcan guiOpen Vulcan's or vulcan.gui
/vulcan profile <player>Show's a players Vulcan profile, including sensitivity, and other useful informationvulcan.profile

Example: In-Game GUI

Vulcan's amazing in-game GUI allows you to edit any check setting on the fly, even punishment commands. (Example used is /vulcan gui)

command /vulcan gui

Example: Player Profile

For example, if you want to see a players profile, you can type /vulcan profile <player> in the chat and you will see a message like this: (Example used is /vulcan profile frep)

command /vulcan profile frep

🍵 PlaceHolders 🍵

Vulcan provides a number of placeholders that you can use to enhance players and staff experience.

Here are some of the most common placeholders:

%vulcan_client_brand%Display the user's client brand
%vulcan_total_violations%Display the user's total violations
%vulcan_total_punishments%Display the total punishments executed by Vulcan

🖱️ Basic Configuration 🖱️

The configuration of this plugin can be done enterily through the command /vulcan menu or /vulcan gui. The default configuration is the best for the plugin, but you can configure it for your needs in /plugins/Vulcan/config.yml. Full configuration file can be found here.

Example: Check Configuration

Almost every aspect of Vulcan is configurable, down to the sensitivity and values around each check.


Each letter (eg. a, b, c, etc.) are for what type of hack is detected. (A could be type vanilla, B could be type NPC). Essentially, each letter is a different method of hacking, or just different hacked clients.

Below is what every check option does and what it means. Most of these can be configured using the in-game GUI, although it can be buggy at times.

Check OptionDescription
enabledWhether or not the check is enabled or disabled
punishableWhether or not the commands will be executed when the max-violations is reached
broadcast-punishmentWhether or not the punishment broadcast (found above) should be sent when the max-violations is reached
max-violationsThe max violations threshold; when this is hit, the punishment-commands will be executed (if punishable is set to true)
alert-intervalHow often alerts for this check will be sent, for example, 2 will only send alerts for VL 2, 4, 6, 8, 3 will send alerts for violations 3, 6, 9, 12, etc. If you want to reduce the spam in the chat, then you can use this.
dont-alert-untilThis will make it so that only alerts greater than this value are sent. For example, if you set this to 6, then only alerts 6 and higher would be sent (anything less than that is still logged, but not sent to staff)
maximum-ping100000 is the default value and your ping can't go higher than this without being kicked for KeepAlive timeout. You won't really ever need to change this as ping doesn't really affect any checks and this can open the possibility of bypasses with ping spoof.
minimum-tpsIf the TPS is lower than this value, the check won't fire.
buffer:Configuration below
maxBuffer is how many times the player needs to 'fail' the check in order to actually alert. This is basically how sensitive the check is. I recommend keeping these as default, but if you want the anticheat to be a little more sensitive or less sensitive you can play with them a little. Don't set them too low or too high or else there will be too many false flags or it just won't flag at all.
multipleThis is what the buffer gets multiplied by after an alert is sent. For example, if you set it to 1, then it wouldn't do anything since (1 * is just x. You can also change this if you want alerts to happen slower, for example setting it to 0 would make it so when a player reaches the max buffer of 5 for example, their buffer is set to 0 instead of 2.5 (as it would be if the multiple was .5 and not 0.
decayHow much the buffer should decay if the player doesn't fail the check. Again, don't really touch this if you don't know what you're doing as you can cause checks to either not flag at all or false positive a lot. You need to have a balanced ratio of increasing buffers and decaying the buffer. What we mean by this is that having the decay as 1 and increasing the buffer by 1 isn't really balanced as you can just cheat for a tick and then not do anything and you will bypass. On the other hand, a buffer decay of .1 against an increase of one is much more balanced as it ensures that people who constantly fail the checks will continue to alert and be punished yet any little errors will be filtered out and not alert.
hotbar-shuffle:Configuration below
enabledWhether or not this feature will be enabled. For me.frep.vulcan.spigot.check.impl.combat checks, if the player is failing the check, this will shuffle around the item in their hand. Funny to watch as they try to frantically figure out what's going on
minimum-vl-to-shuffleThe minimum violations that a player has to be at in order for this feature to function.
shuffle-everyInterval at which this feature will be executed.
random-rotation:Configuration below
enabledWhether or not this feature will be enabled. When players fail me.frep.vulcan.spigot.check.impl.combat checks, their head will be thrown around to random locations. Again, pretty funny to watch.
minimum-vl-to-randomly-rotateMinimum violations which the player needs to be at in order for this feature to work.
rotate-everyInterval at which this will be executed.

Once you finish configuring the checks and saving the config.yml, go to console and type /vulcan reload which will save and load everything you just changed.

⚠ Incompatibilities ⚠

- CatServer
- SpigotX (and all of its forks)
- SmokSpigot
- FoxSpigot (and a lot of other Scalebound forks that unnecessarily change/move default methods/packages)
- FastLogin (in some cases)
- Denizen (breaks channeling for some unknown reason)
- SlimeWorldManager
- Butterfly/Drag Clicking, as well as any other irregular form of clicking or mouse modification.
- Non-vanilla movement mechanics
- Client-sided blocks
- Clumsy/any other irregular packet modification
- Attribute modifiers (in versions under 1.13)
- Potion effect/amplifiers/enchantments out of the vanilla limits
- Any non-vanilla client (especially Lunar Client/BlazingPack)

That should be everything. Feel free to open a live chat with any questions.

Article made by Quartz#0762 ( ID 1065714439380271164 )

Updated on: 16/06/2023

Was this article helpful?

Share your feedback


Thank you!