# Commands
Bookshelf provides a comprehensive command suite organized by category. All commands can be individually toggled in `config.yml`. Permissions follow the `lodestone.bookshelf.commands.<category>.<command>` pattern.
---
## Infraction Commands
| Command | Aliases | Permission | Description |
|---|---|---|---|
| `/ban <player> [reason] [-d duration]` | `/tempban` | `lodestone.bookshelf.commands.infractions.ban` | Bans a player, optionally with a duration flag (`-d 1h`). |
| `/banip <player/ip> [reason] [-d duration]` | | `lodestone.bookshelf.commands.infractions.banip` | Bans a player by IP address, optionally with a duration flag. |
| `/unban <player>` | | `lodestone.bookshelf.commands.moderation.unban` | Unbans a player. |
| `/unbanip <player/ip>` | | `lodestone.bookshelf.commands.infractions.unbanip` | Removes an IP ban. |
| `/mute <player> [reason] [-d duration]` | `/tempmute` | `lodestone.bookshelf.commands.moderation.mute` | Mutes a player, optionally with a duration flag (`-d 1h`). |
| `/unmute <player>` | | `lodestone.bookshelf.commands.moderation.unmute` | Unmutes a player. |
| `/warn <player> <reason>` | | `lodestone.bookshelf.commands.moderation.warn` | Issues a warning to a player. Reason is required. |
| `/kick <player> [reason]` | | `lodestone.bookshelf.commands.infractions.kick` | Kicks a player from the server. |
| `/infractions <player>` | `/history` | `lodestone.bookshelf.commands.infractions.infractions` | Views a player's infraction history. |
| `/banlist` | `/bans` | `lodestone.bookshelf.commands.infractions.banlist` | Lists all active bans. |
| `/mutelist` | `/mutes` | `lodestone.bookshelf.commands.infractions.mutelist` | Lists all active mutes. |
| `/warnlist` | `/warns` | `lodestone.bookshelf.commands.infractions.warnlist` | Lists all active warnings. |
| `/alts <player>` | `/altlist` | `lodestone.bookshelf.commands.infractions.alts` | Lists known alt accounts for a player. |
---
## Moderation Commands
| Command | Aliases | Permission | Description |
|---|---|---|---|
| `/vanish` | `/v` | `lodestone.bookshelf.commands.moderation.vanish` | Toggles vanish mode. |
| `/unvanish` | `/uv` | `lodestone.bookshelf.commands.moderation.unvanish` | Removes vanish mode. |
| `/socialspy` | `/ss` | `lodestone.bookshelf.commands.moderation.socialspy` | Toggles social spy to monitor private messages. |
| `/announce <message>` | `/broadcast`, `/say` | `lodestone.bookshelf.commands.moderation.announce` | Broadcasts a message to all players. |
| `/muteglobalchat` | `/mutechat` | `lodestone.bookshelf.commands.moderation.muteglobalchat` | Mutes global chat for all players. |
| `/unmuteglobalchat` | `/unmutechat` | `lodestone.bookshelf.commands.moderation.unmuteglobalchat` | Unmutes global chat. |
| `/pvp` | `/togglepvp` | `lodestone.bookshelf.commands.moderation.pvp` | Toggles server-wide PvP. |
| `/kickall` | | `lodestone.bookshelf.commands.moderation.kickall` | Kicks all players from the server. |
---
## Teleportation Commands
| Command | Aliases | Permission | Description |
|---|---|---|---|
| `/teleportto <player>` | `/tpto` | `lodestone.bookshelf.commands.moderation.teleportto` | Teleports you to a player. |
| `/teleporthere <player>` | `/tphere` | `lodestone.bookshelf.commands.moderation.teleporthere` | Teleports a player to you. |
| `/teleportall` | `/tpall` | `lodestone.bookshelf.commands.moderation.teleportall` | Teleports all players to you. |
| `/teleportoffline <player>` | `/tpoffline` | `lodestone.bookshelf.commands.moderation.teleportoffline` | Teleports you to an offline player's last location. |
| `/teleportofflinehere <player>` | `/tpofflinehere` | `lodestone.bookshelf.commands.moderation.teleportofflinehere` | Sets an offline player's location to yours. |
---
## Gamemode Commands
| Command | Aliases | Permission | Description |
|---|---|---|---|
| `/gamemode <mode> [player]` | | `lodestone.bookshelf.commands.gamemode.gamemode` | Sets gamemode for a player. |
| `/gm <mode> [player]` | | `lodestone.bookshelf.commands.gamemode.gm` | Alias for `/gamemode`. |
| `/gms [player]` | | `lodestone.bookshelf.commands.gamemode.gms` | Sets survival mode. |
| `/gmc [player]` | | `lodestone.bookshelf.commands.gamemode.gmc` | Sets creative mode. |
| `/gma [player]` | | `lodestone.bookshelf.commands.gamemode.gma` | Sets adventure mode. |
| `/gmsp [player]` | | `lodestone.bookshelf.commands.gamemode.gmsp` | Sets spectator mode. |
---
## Utility Commands
| Command | Aliases | Permission | Description |
|---|---|---|---|
| `/heal [player]` | | `lodestone.bookshelf.commands.utility.heal` | Heals a player to full health. |
| `/feed [player]` | | `lodestone.bookshelf.commands.utility.feed` | Fills a player's hunger bar. |
| `/saturate [player]` | | `lodestone.bookshelf.commands.utility.saturate` | Maximizes a player's saturation. |
| `/fly [player]` | | `lodestone.bookshelf.commands.utility.fly` | Toggles flight mode. |
| `/flyspeed <speed> [player]` | | `lodestone.bookshelf.commands.utility.flyspeed` | Sets fly speed. |
| `/walkspeed <speed> [player]` | | `lodestone.bookshelf.commands.utility.walkspeed` | Sets walk speed. |
| `/godmode [player]` | `/god` | `lodestone.bookshelf.commands.utility.godmode` | Toggles god mode (invulnerability). |
| `/nightvision [player]` | `/nv` | `lodestone.bookshelf.commands.utility.nightvision` | Toggles night vision effect. |
| `/back` | | `lodestone.bookshelf.commands.utility.back` | Returns to your previous location. |
| `/top` | | `lodestone.bookshelf.commands.utility.top` | Teleports to the highest block above you. |
| `/spawn` | | `lodestone.bookshelf.commands.utility.spawn` | Teleports to world spawn. |
| `/warp` | | `lodestone.bookshelf.commands.utility.warp` | Manages and uses warps. |
| `/world` | | `lodestone.bookshelf.commands.utility.world` | Teleports to another world. |
| `/fix` | `/fixitem`, `/repair` | `lodestone.bookshelf.commands.utility.fix` | Repairs the held item. |
| `/rename <name>` | | `lodestone.bookshelf.commands.utility.rename` | Renames the held item. |
| `/lore <text>` | | `lodestone.bookshelf.commands.utility.lore` | Modifies the lore of the held item. |
| `/hat` | | `lodestone.bookshelf.commands.utility.hat` | Puts the held item on your head. |
| `/skull <player>` | | `lodestone.bookshelf.commands.utility.skull` | Gets a player head. |
| `/clone` | | `lodestone.bookshelf.commands.utility.clone` | Duplicates the held item. |
| `/bundle` | | `lodestone.bookshelf.commands.utility.bundle` | Bundle management command. |
| `/armortrim` | | `lodestone.bookshelf.commands.utility.armortrim` | Applies armor trims. |
| `/disenchant` | | `lodestone.bookshelf.commands.utility.disenchant` | Removes enchantments from the held item. |
| `/durability <value>` | | `lodestone.bookshelf.commands.utility.durability` | Sets the durability of the held item. |
| `/maxdurability` | | `lodestone.bookshelf.commands.utility.maxdurability` | Restores the held item to max durability. |
| `/itemmodel <model>` | | `lodestone.bookshelf.commands.utility.itemmodel` | Sets the item model on the held item. |
| `/itemcooldown` | `/ic` | `lodestone.bookshelf.commands.utility.itemcooldown` | Manages item cooldowns. |
| `/workbench` | `/wb`, `/bench` | `lodestone.bookshelf.commands.utility.workbench` | Opens a portable crafting table. |
| `/endersee [player]` | `/echest`, `/enderchest`, `/esee`, `/ec` | `lodestone.bookshelf.commands.utility.enderchest` | Opens an ender chest or views another player's. |
| `/kill <player>` | | `lodestone.bookshelf.commands.utility.kill` | Kills a player. |
| `/killall` | `/clearlag` | `lodestone.bookshelf.commands.utility.killall` | Removes entities from the world. |
| `/summon <entity>` | | `lodestone.bookshelf.commands.utility.summon` | Summons an entity. |
| `/smite <player>` | | `lodestone.bookshelf.commands.utility.smite` | Strikes a player with lightning. |
| `/extinguish [player]` | `/ext` | `lodestone.bookshelf.commands.utility.extinguish` | Extinguishes fire on a player. |
| `/day` | | `lodestone.bookshelf.commands.utility.day` | Sets the time to day. |
| `/night` | | `lodestone.bookshelf.commands.utility.night` | Sets the time to night. |
| `/midnight` | | `lodestone.bookshelf.commands.utility.midnight` | Sets the time to midnight. |
| `/toggledownfall` | | `lodestone.bookshelf.commands.utility.toggledownfall` | Toggles weather. |
| `/sudo <player> <command>` | | `lodestone.bookshelf.commands.utility.sudo` | Forces a player to execute a command. |
| `/powertool` | `/pt` | `lodestone.bookshelf.commands.utility.powertool` | Binds a command to the held item. |
| `/velocity <player>` | | `lodestone.bookshelf.commands.utility.velocity` | Launches a player with velocity. |
| `/center <targets>` | | `lodestone.bookshelf.commands.utility.center` | Centers players to the center of their current block. |
---
## Attribute Commands
| Command | Aliases | Permission | Description |
|---|---|---|---|
| `/scale <value> [player]` | | `lodestone.bookshelf.commands.attributes.scale` | Sets player scale. |
| `/health <value> [player]` | | `lodestone.bookshelf.commands.attributes.health` | Sets player health. |
| `/maxhealth <value> [player]` | | `lodestone.bookshelf.commands.attributes.maxhealth` | Sets player max health. |
| `/gravity [player]` | | `lodestone.bookshelf.commands.attributes.gravity` | Toggles player gravity. |
| `/reach <value> [player]` | | `lodestone.bookshelf.commands.attributes.reach` | Sets both block and entity reach. |
| `/blockreach <value> [player]` | | `lodestone.bookshelf.commands.attributes.blockreach` | Sets block interaction reach. |
| `/entityreach <value> [player]` | | `lodestone.bookshelf.commands.attributes.entityreach` | Sets entity interaction reach. |
| `/knockbackresistance <value> [player]` | | `lodestone.bookshelf.commands.attributes.knockbackresistance` | Sets knockback resistance. |
| `/resetattributes [player]` | | `lodestone.bookshelf.commands.attributes.resetattributes` | Resets all attributes to defaults. |
---
## Social and Privacy Commands
| Command | Aliases | Permission | Description |
|---|---|---|---|
| `/whisper <player> <message>` | `/msg`, `/w`, `/tell`, `/pm` | None | Sends a private message. |
| `/reply <message>` | `/r` | None | Replies to the last private message. |
| `/block <player>` | | None | Blocks a player from messaging you. |
| `/unblock <player>` | | None | Unblocks a player. |
| `/privacy` | | None | Manages privacy settings. |
| `/chat [channel]` | | None | Switches chat channel. Channel access requires `lodestone.bookshelf.chat.<channel>`. |
---
## Vanilla Enhancement Commands
| Command | Aliases | Permission | Description |
|---|---|---|---|
| `/enchant <enchantment> [level]` | | `lodestone.bookshelf.commands.vanilla.enchant` | Enhanced enchant with optional unsafe bypass (`-f` flag requires `.bypass`). |
| `/i <item> [amount]` | `/item` | `lodestone.bookshelf.commands.vanilla.give` | Gives an item to yourself. |
| `/tellraw <player> <message>` | | `lodestone.bookshelf.commands.utility.tellraw` | Sends a raw message with MiniMessage support. |
| `/title <player> <title>` | | `lodestone.bookshelf.commands.vanilla.title` | Displays a title to a player. |
| `/time` | | `lodestone.bookshelf.commands.vanilla.time` | Enhanced time command (merges with vanilla). |
| `/ride <entity>` | | `lodestone.bookshelf.commands.vanilla.ride` | Mounts an entity. |
| `/dismount` | | `lodestone.bookshelf.commands.vanilla.dismount` | Dismounts from the current entity. |
---
## Administration Commands
| Command | Aliases | Permission | Description |
|---|---|---|---|
| `/bookshelf` | | `lodestone.bookshelf.commands.bookshelf` | Main admin command with reload and integration subcommands. |
| `/tps` | | `lodestone.bookshelf.commands.tps` | Displays server TPS. |
| `/ping [player]` | | None (toggleable) | Shows player ping/latency. |
| `/healthreport` | `/serverhealth` | `lodestone.bookshelf.commands.healthreport` | Generates a server health report. |
| `/profiler` | | `lodestone.bookshelf.commands.profiler` | Server performance profiler with start, stop, info, open, and cancel subcommands. |
| `/clearpack [player]` | | `lodestone.bookshelf.commands.clearpack` | Clears the resource pack from a player. |
| `/craft` | `/ci` | `lodestone.bookshelf.commands.craft` | Opens a crafting interface. |
---
## Related Pages
- [[Bookshelf/Server Owners/Overview]] - Plugin features and dependencies
- [[Bookshelf/Server Owners/Configuration]] - Command toggle configuration