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 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