Skip to content

ArcanePlugins/BlackWidow

Repository files navigation

BlackWidow

BlackWidow is a security solution for Minecraft which aims to offer out-of-the-box defense against vulnerabilities which are commonly exploited on online servers.

Quick Links

Features

  • Command Blocking

    Featuring a comprehensive command blocker, supporting blacklist/whitelisting, regex, powerful custom command rule chains, colon syntax blocking (/plugin:command), and more.

    The default configuration blocks common commands used by players to check installed plugins and versions.

  • Secure Defaults

    The default configuration of BlackWidow provides immediate drag-and-drop security improvements for most servers.

  • Unit Testing

    Standard component logic, such as the Command Blocking logic, is unit-tested to ensure it is working correctly before any version can be shipped out.

  • Simple & Reliable

    BlackWidow is built to be robust and lightweight, and doesn't mash half-baked features together to seem appealing (..only to break next update).

  • Plenty more to come!

    There are a variety of other features planned, some major, such as command spying. It has the goal of being a pretty comprehensive security suite.

    However, we currently have no plans for BlackWidow to become an 'anticheat' plugin in the usual sense, which seems to be fulfilled by existing solutions well enough.

Feel free to see a variety of screenshots below:

Blocking working for command execution and suggestions.

BW_CmdBlocking_Filtration

Translate all of the plugin's chat messages with MiniMessage color support.

BW_Config_Translations

Very powerful command blocker with a fantastic out-of-the-box experience.

BW_Config_CommandBlocking

Get Started

Compatibility

Firstly, make sure your software setup is compatible with BlackWidow.

Please reference the Requirements page for the most up-to-date and descriptive information on the requirements of running BlackWidow.

The best-case scenario to run BlackWidow is:

  • Minecraft 1.21.3 or newer
  • PaperMC or SpigotMC server software
  • Java 21 or newer

Please be advised:

We are considering adding future support for Velocity, BungeeCord, and Minestom. Let us know if you're interested!

Derivatives of Spigot/Paper, such as Purpur or Pufferfish may work fine, but we don't support these setups. That being said, still give it a shot and see if everything works. :)

Please note that we are not interested in backporting BlackWidow to older versions of Minecraft/Java/etc. Please update your software, or feel free to fork BlackWidow and backport it.

We do NOT recommend using any server software like Magma, Mohist, and Arclight which try to make Forge mods work with Bukkit plugins. Bukkit was never designed to work with Forge/Fabric/etc mods. Trying to mix the two often causes lots of unusual issues which burden server owners and plugin maintainers.

Projects Used

Thank you to the following projects for making BlackWidow possible:

  • CommandAPI

    Used to conveniently create and manage Brigadier commands.

  • Configurate

    Used to seamlessly handle YAML configuration files.

  • MiniMessage (adventure)

    Used to format chat messages with lovely chat component features.

  • PaperMC

    API used on Paper servers for more advanced features.

Thanks to all the other projects used, such as SpigotMC, IntelliJ, etc.

License Notice

Copyright (C) 2024 lokka30 (email)

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.