BlackUtils

# BlackUtils **Version:** 1.0-SNAPSHOT **Author:** BlackDev **API Version:** 1.21 BlackUtils is a versatile Minecraft plugin providing a collection of essential commands to enhance server management and improve the player experience. From convenient player utilities to world management, BlackUtils offers an all-in-one solution for server administrators and players alike. ## Features BlackUtils adds the following command categories: - **Player Commands:** Helpful tools for players to manage their own health and hunger. - **Station Commands:** Quick access to various crafting stations and utility blocks. - **World Commands:** Easy-to-use commands for navigation and teleportation within the world. - **Utility Commands:** Fun and useful tools, including the ability to roll dice and set a wearable "hat." - **Home Commands:** A comprehensive home management system with options to set, list, rename, and delete homes. - **Warp Commands:** Efficiently set, manage, and teleport to custom warp points. ## Commands and Permissions Each command is tied to a permission node, allowing server administrators to customize player access as needed. ### Player Commands - `/feed` - Refills hunger bar (Permission: `blackutils.command.feed`) - `/heal` - Restores health points (Permission: `blackutils.command.heal`) ### Station Commands - `/anvil` - Opens the anvil UI (Permission: `blackutils.command.anvil`) - `/craft` - Opens the crafting table UI (Permission: `blackutils.command.crafting`) - `/enderchest` - Access your Ender Chest remotely (Permission: `blackutils.command.enderchest`) - `/grindstone` - Opens the grindstone UI (Permission: `blackutils.command.grindstone`) - `/loom` - Opens the loom UI (Permission: `blackutils.command.loom`) - `/smithingtable` - Access the smithing table UI (Permission: `blackutils.command.smithingtable`) - `/stonecutter` - Opens the stonecutter UI (Permission: `blackutils.command.stonecutter`) ### World Commands - `/spawn` - Teleports the player to the server spawn point (Permission: `blackutils.command.spawn`) ### Utility Commands - `/hat` - Puts the item in hand on your head as a hat (Permission: `blackutils.command.hat`) - `/dice` - Roll a dice for random results (Permission: `blackutils.command.dice`) - `/back` - Return to the last location (Permission: `blackutils.commands.back`) ### Home Commands - `/home` - Teleport to your set home (Permission: `blackutils.commands.home`) - `/sethome` - Sets your current location as home (Permission: `blackutils.commands.sethome`) - `/renamehome` - Rename an existing home (Permission: `blackutils.commands.renamehome`) - `/listhomes` - List all your saved homes (Permission: `blackutils.commands.listhomes`) - `/delhome` - Delete a home (Permission: `blackutils.commands.delhome`) ### Warp Commands - `/setwarp` - Set a public warp point (Permission: `blackutils.commands.setwarp`) - `/warp` - Teleport to a warp point (Permission: `blackutils.commands.warp`) - `/delwarp` - Delete a warp point (Permission: `blackutils.commands.delwarp`) - `/listwarps` - List all available warps (Permission: `blackutils.commands.listwarps`) ### Messaging Commands - `/msg` - Send a private message to another player (Permission: `blackutils.command.msg`) - `/reply` - Reply to the last received message (Permission: `blackutils.command.reply`) ## Installation 1. Download the latest version of BlackUtils from (https://modrinth.com/). 2. Place the downloaded `.jar` file into your server's `plugins` folder. 3. Restart the server to load the plugin. ## Configuration Permissions can be configured using a permissions plugin such as LuckPerms or PermissionsEx. Customize access to commands based on your server’s needs. ## Contributing If you would like to contribute to BlackUtils, please feel free to submit a pull request on our GitHub repository or open an issue to suggest new features or improvements. ## License This project is licensed under the ARR license