BlackUtils

BlackUtils

API Version: 1.0-SNAPSHOT API Version: 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:

- Warp Commands: Helpful tools for players to manage their own health and hunger. - Warp Commands: Quick access to various crafting stations and utility blocks. - Warp Commands: Easy-to-use commands for navigation and teleportation within the world. - Warp Commands: Fun and useful tools, including the ability to roll dice and set a wearable "hat." - Warp 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 Modrinth. 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