Premium Punishments

A lightweight, easy to use plugin that allows you to manage punishments on your Minecraft server. From bans to warns, Premium Punishments is equip to handle anything that staff may need while moderating a server.
Explore the project »

View Spigot · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Features
   • Commands
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Roadmap
4. Contributing
5. License
6. Acknowledgements

About The Project

A lightweight, easy to use plugin that allows you to manage punishments on your Minecraft server. From bans to warns, Premium Punishments is equip to handle anything that staff may need while moderating a server.

Features

1. Fully customizable configuration file
2. Lightweight architecture that allows the server to run smoothly along with Premium Punishments
3. Built-in MySQL support that allows the server to make use of databases.
4. Optional staff-chat plugin that allows staff to converse privately.
5. Built in language files that allow you to change your language by just typing the language name.

Permissions

• premiumpunishments.ban Access to the ban command.
• premiumpunishments.unban Access to the unban command.
• premiumpunishments.mute Access to the mute command.
• premiumpunishments.unmute Access to the unmute command.
• premiumpunishments.kick Access to the kick command.
• premiumpunishments.warn Access to the warn command.
• premiumpunishments.freeze Access to the freeze command.
• premiumpunishments.unfreeze Access to the unfreeze command.
• premiumpunishments.note Access to the note command.
• premiumpunishments.staff-broadcast Can see silent punishments (E.g, if a ban is silent, every player with this permission will still see the message.)
• premiumpunishments.punishment-immune If a player has this permission, they will be immune to all punishments.

Commands

Tags: -s - Only broadcasts the punishment message to players with the permission premiumpunishments.staff-broadcasts

• Ban /premiumpunishments ban [-s] <player> <time> <reason>- Ban a player with a custom duration and message. Banning a player will disconnect them from the server and display to them the custom message, as well as prevent them from re-connecting to the server until the duration has expired, or they have been manually unbanned. Banning also has the option to be silent only to staff.
• Unban /premiumpunishments unban [-s] <player> <time> <reason>- Unbans a player. Unbanning a player will revoke all ban punishments on them, and will allow them to join the server if they were banned before unbanning them.
• Mute /premiumpunishments mute [-s] <player> <time> <reason>- Mute a player with a custom duration. Muting a player prevents them from sending chat messages. The player will remain muted upon disconnecting and re-connecting to the server.
• Unmute /premiumpunishments unmute [-s] <player> - Unmute a player. Unmuting a player will allow them to chat again if they were muted before unmuting them.
• Kick /premiumpunishments kick [-s] <player> - Kick a player with a custom message. Kicking a player will disconnect them from the server and display to them the custom message.
• Warn /premiumpunishments warn [-s] <player> <reason> - Warn a player with a custom message. Warning a player will send them the custom message as a formal warning.
• Freeze /premiumpunishments freeze [-s] <player> - Freeze a player with a custom duration. Freezing a player prevents them from moving, breaking blocks, placing blocks, interacting with the world, and running chat commands. The player will remain frozen upon disconnecting and re-connecting to the server.
• Unfreeze /premiumpunishments unfreeze [-s] <player> - Unfreeze a player. Unfreezing a player will allow the player to continue playing on the server like normal before they were frozen.
• Note /premiumpunishments note <add|remove|list> <player> <name> - Notes allow staff to make notes on different players. They can remove, add, and list notes they have on a player.

Built With

• Spigot API
• Plugin Utils
• Maven

Getting Started

To add Premium Punishments to your Minecraft server, follow these simple steps.

Prerequisites

• A Spigot Minecraft server

  https://www.spigotmc.org/
  

Installation

1. Download the latest jar file at the spigot page.
2. Drag and drop the jar file into your Minecraft server's plugins directory.

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the Apache 2.0 License. See LICENSE for more information.

Acknowledgements

• Spigot API
• Plugin Utils
• Maven
• README Template
• Punishment for Inspiration