Plugin Description (Short)

Ossentials is a lightweight, high-performance, and feature-packed core utility plugin designed to provide essential quality-of-life tools, administration features, and player conveniences for your Minecraft server. It offers flexible, permission-based control over warps, homes, kits, teleport requests, portable utility GUIs and more, all without unnecessary bloat.



Plugin Features Overview

• Teleportation Suite: Full TPA/TPAHERE system with request expiration, plus standard /spawn and unlimited, permission-based /warp access.

• Custom Homes: Players can set multiple homes with limits determined by permission nodes (e.g., sethome.5).

• Advanced Kits: A complete system featuring an interactive GUI editor, Base64 serialization for custom items, and cooldown management (time stored in hours.minutes format).

• Custom EnderChest: Instead of needing a separate PlayerVaults plugin make use of multi-page ender-chest per permissions and the /ec command for players or /ecopen <playerName> for admins. By default players only have access to a single page. (Default enderchest size is a double-chest) The multi-page feature can be disabled completely in the config.yml, resulting in the vanilla enderchest, the commands will still work as intended.

• Utility GUIs: Portable, fully functional commands for /anvil, /enchant, /craft, and more, simplifying access to crucial block functionalities.

• Player Utilities: Essential commands like /fly, /feed, /repair, /flyspeed and more.

• Chat Formatting: Create custom-easy to set colors via yml, using either legacy or mini options. For example: &4 or <red>. Formatting can be turned off if using another chat plugin. /nick, prefixes,suffixes & more.

Prefix/Suffix Native Support
(Used by custom weight based perms " example is applied via LuckPerms"), highest given weighted prefix/suffix applies if multiple given to player.

Player	Permission	Description
Prefix	ossentials.prefix.<weight>.<prefix>	Set rank/player prefix based on custom permission
Suffix	ossentials.suffix.<weight>.<prefix>	Set rank/player suffix based on custom permission

Commands and Permissions List
Below is a complete table of every command implemented so far, including its permissions and a brief function description.

Command	Permission	Description
/fly [player]	ossentials.command.fly ossentials.command.fly.others	Toggle flight for yourself or another player.
/feed [player]	ossentials.command.feed ossentials.command.feed.others	Restore hunger for yourself or another player.
/flyspeed <1-10>	ossentials.command.flyspeed ossentials.command.flyspeed.others	Set a player's fly speed.
/sethome <name>	ossentials.command.sethome.<number>	Set a home (limit controlled by permission).
/home [name]	ossentials.command.home	Teleport to a saved home.
/delhome <name>	ossentials.command.delhome	Delete a saved home.
/setspawn	ossentials.command.setspawn	Set the world’s global spawn.
/spawn	ossentials.command.spawn	Teleport to the global spawn.
/warpcreate <name>	ossentials.command.warpcreate	Create a new global warp.
/warp [name]	ossentials.command.warp.<name>	Teleport to a warp (warp-specific perms).
/warpdel <name>	ossentials.command.warpdel	Delete a global warp.
/kitcreate <name>	ossentials.command.kitcreate	Create a kit using GUI editor.
/kitedit <name>	ossentials.command.kitedit	Edit a kit in GUI editor.
/kitdelay <name> <H.M>	ossentials.command.kitdelay	Set a kit cooldown.
/kitdelete <name>	ossentials.command.kitdelete	Delete a kit.
/kit [name]	ossentials.command.kit.<name>	Claim a kit (kit-specific perms).
/tpa <player>	ossentials.command.tpa	Request to teleport TO a player.
/tpahere <player>	ossentials.command.tpahere	Request a player to teleport to YOU.
/tpaccept	ossentials.command.tpaccept	Accept a pending teleport request.
/tpdeny	ossentials.command.tpdeny	Deny a pending teleport request.
/craft	ossentials.command.craft	Open a portable crafting table.
/anvil	ossentials.command.anvil	Open a portable anvil.
/enchant	ossentials.command.enchant	Open a portable enchanting table.
/loom	ossentials.command.loom	Open a portable loom.
/grindstone	ossentials.command.grindstone	Open a portable grindstone.
/stonecutter	ossentials.command.stonecutter	Open a portable stonecutter.
/smithingtable	ossentials.command.smithingtable	Open a portable smithing table.
/cartography	ossentials.command.cartography	Open a portable cartography table.
/furnace	ossentials.command.furnace	Portable furnace GUI (visual only INCOMPLETE).
/smoker	ossentials.command.smoker	Portable smoker GUI (visual only INCOMPLETE).
/blastfurnace	ossentials.command.blastfurnace	Portable blast furnace GUI (visual only INCOMPLETE).
/nick	ossentials.command.nick ossentials.command.nick.others	Set or reset nicknames.
/chatcolor <custom-color>	ossentials.chatcolor.<customcolorname>	Set your chatcolor based on custom defined colors list
/repair	ossentials.command.repair	Repairs the item currently held in the player's hand. aliases: /fix
/repairall	ossentials.command.repairall	Repairs all repairable items in the player's inventory and armor slots. aliases: /fixall
/ec	ossentials.command.enderchest	Opens your multi-page Ender Chest vault, allowing you to store items across multiple pages if permitted. aliases: /enderchest
/ecopen <player>	ossentials.command.enderchest.admin	Opens another player's multi-page Ender Chest vault. This is primarily for administrative or moderation purposes.

Key Permission Nodes

Permission Node	Description
ossentials.*	Grants access to all Ossentials commands (Admin use only).
ossentials.command.warp.*	Allows teleporting to any warp, bypassing warp-specific permissions. (Op only)
ossentials.command.kit.*	Allows claiming any kit, bypassing kit-specific permissions. (Op only)
ossentials.command.sethome.5	Allows the player to set a maximum of 5 homes. (Optional default)
ossentials.command.sethome.unlimited	Allows unlimited homes. (Op only)
ossentials.enderchest.pages.5	Grants access to up to 5 pages of storage in enderchest.
ossentials.enderchest.pages.*	Grants access to the maximum defined number of pages (useful for server admins).
ossentials.command.nick.bypass_length	THIS PERMISSION WAS REMOVED as of 1.0.2-4

Upcoming Version 1.0.3:
(Will be edited as more is created for 1.0.3 update) Information about next update will be updated as I go below.

If you have used prior ossentials versions, it is recommended you temporarily move your config.yml to a different location upon first start of a new update, then compare each, in case of updates to the auto generated config file.