Allium Plugin Documentation
This document provides a comprehensive overview of the commands and permissions for the Allium plugin.
General Information
Plugin Name: Allium
Version: 0.1.2a
Author: towkio
Description: A secure, modern Essentials solution.
Dependencies: Vault
Soft Dependencies: PlaceholderAPI
Commands
This section details all available commands in Allium, categorized by function.
General & Utility Commands
- /core
- Description: Core plugin command for administrative tasks.
- Usage:
Code (Text):
/core <reload|debug|voucher|etc.>
- Permission:
- /gc
- Description: Displays server performance details (TPS, memory, etc.).
- Usage:
- Permission:
(Default: true)
- /help [command]
- Description: Displays a list of commands or help for a specific command.
- Usage:
Code (Text):
/help [command]
- Aliases:
- Permission:
(Default: true)
- /whois <player>
- Description: Displays detailed information about a player.
- Usage:
Code (Text):
/whois <player>
- Permission:
(Default: true)
- /redeem
- Description: Allows eligible players to redeem a rank and rewards.
- Usage:
- Aliases:
- Permission: (None listed, available to all players by default)
Player Management Commands
- /heal [player]
- Description: Heals you or another player to full health.
- Usage:
Code (Text):
/heal [player]
- Permission:
- /feed [player]
- Description: Feeds you or another player to full hunger.
- Usage:
Code (Text):
/feed [player]
- Permission:
- /god [player]
- Description: Toggles god mode (invincibility) for you or another player.
- Usage:
Code (Text):
/god [player]
- Permission:
- /fly [player]
- Description: Toggles flight for you or another player.
- Usage:
Code (Text):
/fly [player]
- Permission:
- /nv
- Description: Toggles permanent night vision for yourself.
- Usage:
- Permission:
- /gamemode <mode> [player]
- Description: Changes your or another player's gamemode.
- Usage:
Code (Text):
/gamemode <survival|creative|adventure|spectator> [player]
- Aliases:
Code (Text):
gm, gmc, gms, gma, gmsp
- Permission:
Code (Text):
core.gamemode
- /explode <player> [modifier]
- Description: Creates an explosion at a player's location.
- Usage:
Code (Text):
/explode <player> [modifier]
- Permission:
Code (Text):
core.explode
Item Management Commands
- /give <player> <item> [amount]
- Description: Gives a specified item to a player. Supports aliases and advanced item data.
- Usage:
Code (Text):
/give <player> <item> [amount]
- Aliases:
- Permission:
- /itemdb
- Description: Shows information about the item/block in your hand, including its ID and name.
- Usage:
- Permission:
- /rename <name>
- Description: Renames the item currently in your main hand. Supports color codes.
- Usage:
Code (Text):
/rename <name>
- Permission:
- /lore <add|remove|clear> <text>
- Description: Manages the lore of the item in your main hand.
- Usage:
Code (Text):
/lore <add|remove|clear> <text>
- Permission: [偶
- Description: Fills the stack of the item in your hand to the maximum size (usually 64).
- Usage:
- Permission:
- /skull <player>
- Description: Gives you the head of a specified player.
- Usage:
Code (Text):
/skull <player>
- Aliases:
Code (Text):
head, playerhead
- Permission:
Economy Commands
- /balance [player]
- Description: Checks your or another player's economy balance.
- Usage:
Code (Text):
/balance [player]
- Aliases:
- Permission:
Code (Text):
core.balance
(Default: true)
- /pay <player> <amount>
- Description: Pays another player a specified amount from your balance.
- Usage:
Code (Text):
/pay <player> <amount>
- Permission:
(Default: true)
- /baltop [page]
- Description: Displays a list of the server's richest players.
- Usage:
Code (Text):
/baltop [page]
- Permission:
(Default: true)
- /money <give|take|set|clear> <player> [amount]
- Description: Admin command to manage player balances.
- Usage:
Code (Text):
/money <give|take|set|clear> <player> [amount]
- Permission:
Teleportation Commands
- /spawn
- Description: Teleports you to the server's spawn point.
- Usage:
- Permission:
(Default: true)
- /setspawn
- Description: Sets the server's spawn point to your current location.
- Usage:
- Permission:
Code (Text):
core.setspawn
- /tp <player> | <x> <y> <z>
- Description: Teleports you directly to a player or coordinates.
- Usage:
Code (Text):
/tp <player>
or
Code (Text):
/tp <x> <y> <z>
- Aliases:
Code (Text):
tpo, teleport, back
- Permission:
- /tpa <player>
- Description: Sends a teleport request to another player.
- Usage:
Code (Text):
/tpa <player>
- Permission:
(Default: true)
- /tpaccept [player]
- Description: Accepts a pending teleport request.
- Usage:
Code (Text):
/tpaccept [player]
- Aliases:
- Permission:
(Default: true)
- /tpdeny [player]
- Description: Denies a pending teleport request.
- Usage:
Code (Text):
/tpdeny [player]
- Aliases:
- Permission:
(Default: true)
- /tphere <player>
- Description: Teleports a player directly to your location.
- Usage:
Code (Text):
/tphere <player>
- Aliases:
- Permission:
- /tpahere <player>
- Description: Requests a player to teleport to your location.
- Usage:
Code (Text):
/tpahere <player>
- Permission:
Code (Text):
core.tpahere
(Default: true)
- /tptoggle
- Description: Toggles your ability to receive teleport requests.
- Usage:
- Permission:
Code (Text):
core.tptoggle
(Default: true)
- /tppos <x> <y> <z> [yaw] [pitch]
- Description: Teleports you to specific coordinates.
- Usage:
Code (Text):
/tppos <x> <y> <z> [yaw] [pitch]
- Permission:
- /top
- Description: Teleports you to the highest block directly above your location.
- Usage:
- Permission:
- /bottom
- Description: Teleports you to the lowest safe block directly below your location.
- Usage:
- Permission:
- /otp <player>
- Description: Teleports you to a player's last known location while they were online.
- Usage:
Code (Text):
/otp <player>
- Aliases:
Code (Text):
offlinetp, tpoffline
- Permission:
- /tppet
- Description: Teleports your nearby pets to your location.
- Usage:
- Permission:
- /tpmob
- Description: Teleports nearby entities/mobs to your location.
- Usage:
- Aliases:
Code (Text):
tpentity, tpent, teleportmob, tpm, tpe
- Permission:
Communication Commands
- /msg <player> <message>
- Description: Sends a private message to a player.
- Usage:
Code (Text):
/msg <player> <message>
- Aliases:
Code (Text):
tell, w, whisper, pm, message, m, t
- Permission:
(Default: true)
- /reply <message>
- Description: Replies to the last private message you received.
- Usage:
Code (Text):
/reply <message>
- Aliases:
- Permission:
(Default: true)
- /spy
- Description: Toggles social spy, allowing you to see others' private messages.
- Usage:
- Permission:
- /mail <read|send|clear|gift|claim> [player] [message]
- Description: Manages your offline mail.
- Usage:
Code (Text):
/mail <subcommand> [args]
- Permission: (None listed, available to all players by default)
Note Management Commands (New in 0.1.2a)
- /note <player> <message>
- Description: Adds a note to a player's record for staff reference.
- Usage:
Code (Text):
/note <player> <message>
- Permission:
- /notes <player>
- Description: Views all notes associated with a player.
- Usage:
Code (Text):
/notes <player>
- Permission:
- /unnote <player> <noteId>
- Description: Removes a specific note from a player's record.
- Usage:
Code (Text):
/unnote <player> <noteId>
- Permission:
Permissions
This section lists all available permission nodes and their functions.
Administrative Permissions
- core.*: Grants access to all Allium commands and features. (Default: op)
- core.admin: Grants access to administrative commands like
and
. (Default: op)
- core.staff: Grants access to staff commands (gamemode, teleportation, inventory). (Default: op)
- core.spy: Allows using
to monitor private messages. (Default: op)
Gamemode Permissions
- core.gamemode: Base permission for the
command. (Default: op)
- core.gamemode.others: Allows changing the gamemode of other players. (Default: op)
- core.gamemode.survival: Allows changing to Survival mode. (Default: op)
- core.gamemode.creative: Allows changing to Creative mode. (Default: op)
- core.gamemode.adventure: Allows changing to Adventure mode. (Default: op)
- core.gamemode.spectator: Allows changing to Spectator mode. (Default: op)
Creative Mode Manager Permissions
- core.gamemode.creative.inventory: Allows inventory management in creative mode. (Default: op)
- core.gamemode.creative.container: Allows container interaction in creative mode. (Default: op)
- core.gamemode.creative.pickup: Allows item pickup in creative mode. (Default: op)
- core.gamemode.creative.use: Allows item usage in creative mode. (Default: op)
- core.gamemode.creative.drop: Allows item dropping in creative mode. (Default: op)
- core.gamemode.creative.break: Allows block breaking in creative mode. (Default: op)
- core.gamemode.creative.place: Allows block placement in creative mode. (Default: op)
- core.gamemode.creative.interact: Allows world interaction in creative mode. (Default: op)
- core.gamemode.creative.spawn: Allows entity spawning in creative mode. (Default: op)
- core.gamemode.creative.blacklist: Allows access to blacklisted items in creative mode. (Default: op)
- core.gamemode.creative.nv: Allows night vision in creative mode. (Default: op)
Night Vision Permissions
- core.nv: Allows using
for night vision. (Default: op)
- core.nv.others: Allows toggling night vision for other players. (Default: op)
- core.nv.survival: Allows night vision in survival mode. (Default: op)
- core.nv.creative: Allows night vision in creative mode. (Default: op)
- core.nv.adventure: Allows night vision in adventure mode. (Default: op)
- core.nv.spectator: Allows night vision in spectator mode. (Default: op)
Teleportation Permissions
- core.tp: Allows using
to teleport to players/coordinates. (Default: op)
- core.tp.others: Allows teleporting other players to a target. (Default: op)
- core.tpa: Allows sending and receiving teleport requests (
,
,
). (Default: true)
- core.tpa.nodelay: Bypasses the teleport delay. (Default: op)
- core.tpa.nocooldown: Bypasses the teleport cooldown. (Default: op)
- core.tppos: Allows teleporting to specific coordinates with
. (Default: op)
- core.tphere: Allows teleporting a player to you with
. (Default: op)
- core.tpahere: Allows requesting a player to teleport to you with
. (Default: true)
- core.tptoggle: Allows toggling teleport requests with
. (Default: true)
- core.tptoggle.bypass: Bypasses a player's
setting. (Default: op)
- core.tp.offline / core.otp: Allows teleporting to offline players with
. (Default: op)
- core.top: Allows using
. (Default: op)
- core.bottom: Allows using
. (Default: op)
Player Ability Permissions
- core.fly: Allows using
. (Default: op)
- core.fly.others: Allows toggling flight for other players. (Default: op)
- core.god: Allows using
. (Default: op)
- core.heal: Allows using
. (Default: op)
- core.heal.others: Allows healing other players. (Default: op)
- core.heal.nocooldown: Bypasses the
cooldown. (Default: op)
- core.feed: Allows using
. (Default: op)
- core.feed.others: Allows feeding other players. (Default: op)
- core.feed.nocooldown: Bypasses the
cooldown. (Default: op)
- core.nv: Allows using
for night vision. (Default: op)
Item & Inventory Permissions
- core.give: Allows using
. (Default: op)
- core.itemdb: Allows using
. (Default: op)
- core.rename: Allows using
. (Default: op)
- core.lore: Allows using
. (Default: op)
- core.more: Allows using
. (Default: op)
- core.skull: Allows using
. (Default: op)
Economy Permissions
- core.balance: Allows using
. (Default: true)
- core.pay: Allows using
. (Default: true)
- core.baltop: Allows using
. (Default: true)
Note Management Permissions (New in 0.1.2a)
- core.note: Allows adding player notes with
. (Default: op)
- core.notes: Allows viewing player notes with
. (Default: op)
- core.unnote: Allows removing player notes with
. (Default: op)
Miscellaneous Permissions
- core.explode: Allows using
. (Default: op)
- core.explode.others: Allows exploding other players. (Default: op)
- core.explode.exempt: Makes a player immune to
. (Default: op)
- core.gc: Allows using
. (Default: true)
- core.msg: Allows sending and receiving private messages. (Default: true)
- core.help: Allows using
. (Default: true)
- core.spawn: Allows using
. (Default: true)
- core.setspawn: Allows setting the spawn point with
. (Default: op)
- core.whois: Allows using
. (Default: true)
- core.voucher.give: Allows giving rank vouchers via
Code (Text):
/core voucher give
. (Default: op)
Chat Formatting Permissions
- chat.color: Grants access to all legacy color codes. (Default: op)
- chat.color.<color_name>: Grants access to a specific color (e.g.,
Code (Text):
chat.color.red
). (Default: op)
- chat.color.hex: Allows using hex color codes (e.g.,
). (Default: op)
- chat.format.<style>: Grants access to formatting codes like bold, italic, etc. (Default: op)
- chat.unicode: Allows using unicode characters in chat. (Default: op)
Changelog
0.1.2a
- Added staff permission group with access to staff commands
- Added admin permission group inheriting staff permissions
- Added
,
,
commands for player note management
- Implemented automatic removal of deprecated lang.yml keys
- Fixed CreativeManager inventory saving logic