# Overview Bookshelf is the core infrastructure plugin for the Lodestone ecosystem. It serves as a modern replacement for EssentialsX, providing commands that feel more vanilla while adding quality-of-life features needed for any Minecraft server. --- ## What Bookshelf Replaces Bookshelf replaces **EssentialsX** and its associated modules. Where EssentialsX provides a monolithic feature set, Bookshelf takes a modular approach with five submodules that can be used independently. Commands are designed to feel native to vanilla Minecraft rather than introducing unfamiliar syntax. --- ## Features ### Moderation - **Infraction system** with ban, mute, warn, and kick support - **Temporary infractions** with duration-based bans and mutes - **IP banning** for network-level enforcement - **Ban list, mute list, and warn list** for reviewing active infractions - **Infraction history** per player - **Player alt tracking** via IP and UUID correlation - **Vanish system** with full player hiding - **Social spy** for monitoring private messages - **Global chat mute** to silence the server - **Announce/broadcast** system with configurable prefix - **PvP toggle** for server-wide combat control - **Kick all** for maintenance situations ### Teleportation - **Teleport to player** (`/teleportto`, `/tpto`) - **Teleport here** (`/teleporthere`, `/tphere`) - **Teleport all** (`/teleportall`, `/tpall`) - **Teleport offline** players to locations or to you - **Back command** to return to previous location - **Top command** to teleport to the highest block - **Spawn command** for world spawn teleportation - **Warp system** for saved locations - **World command** for cross-world teleportation ### Utility - **Gamemode shortcuts** (`/gms`, `/gmc`, `/gma`, `/gmsp`, `/gm`) - **Heal, feed, and saturate** commands - **Fly toggle** with configurable fly speed and walk speed - **God mode** with configurable hit-through option - **Night vision** toggle - **Fix/repair** items - **Rename and lore** editing for items - **Hat command** to wear any item - **Skull command** to get player heads - **Workbench** to open a portable crafting table - **Ender chest** viewing (`/endersee`) - **Clone** items - **Bundle** management - **Center** players to block center - **Armor trim** command - **Disenchant** items - **Durability** and max durability control - **Item model** and item cooldown management - **Kill** and **kill all** (entity clearing / clearlag) - **Summon** entities - **Smite** players with lightning - **Extinguish** fire on players - **Time commands** (`/day`, `/night`, `/midnight`) - **Toggle downfall** for weather control - **Sudo** to execute commands as another player - **PowerTool** to bind commands to items - **Velocity** to launch players ### Player Attributes - **Scale** player size - **Health** and **max health** modification - **Gravity** toggle - **Reach** (block reach and entity reach) - **Knockback resistance** adjustment - **Reset attributes** to defaults ### Chat System - **Chat links** — URLs in chat are clickable, underlined, and colored aqua (`lodestone.bookshelf.chat.links`) - **Player mentions** — `@PlayerName` highlights in yellow with notification sound (`lodestone.bookshelf.chat.mentions`) - **@item display** — `@item` shows held item name with hover tooltip using rarity color (`lodestone.bookshelf.chat.item`) - **@everyone ping** — `@everyone` highlights for all online players with notification sound - **Banned word filtering** with staff alerts - **Character spam detection** with staff alerts - **Chat cooldown** with per-group configuration via LuckPerms - **Duplicate message prevention** - **Chat channel** system with configurable channels - **Chat moderation event** — plugins can listen for and override moderation decisions ### Social and Privacy - **Whisper/PM system** (`/whisper`, `/msg`, `/w`, `/tell`, `/pm`) - **Reply** to last message (`/reply`, `/r`) - **Block and unblock** players - **Privacy** settings management ### Vanilla Enhancements - **Enhanced enchant** command with unsafe enchantment support - **Enhanced give** command (`/i`, `/item`) - **Enhanced tellraw** with MiniMessage support - **Enhanced title** command - **Time command** extensions - **Mount and dismount** commands (`/ride`, `/dismount`) ### Server Administration - **TPS monitoring** command - **Ping** command for latency checking - **Health report** for server diagnostics - **Profiler** for performance analysis - **Clear resource pack** command - **Bookshelf admin** command with reload, install integrations ### Networking - **MongoDB integration** for persistent data storage across servers - **Redis integration** for real-time cross-server synchronization - **Cross-server infractions** and notifications - **Cross-server whisper** support - **Network chat channels** --- ## Plugin Dependencies | Dependency | Type | Purpose | |---|---|---| | PacketEvents | Soft | Packet-level features | | LuckPerms | Soft | Permission group integration | | PlaceholderAPI | Soft | Placeholder expansion support | | InvSeePlusPlus | Soft | Inventory inspection integration | All-in-all, you **do not** need to install any additional plugins. --- ## Supported Platforms | Platform | Module | Description | |---|---|---| | Paper 1.21+ | Bookshelf-Paper | Full plugin with all features | | Velocity | Bookshelf-Velocity | Proxy plugin for network ban enforcement and cross-server commands | --- ## Related Pages - [[Bookshelf/Server Owners/Configuration]] - Full config.yml breakdown - [[Bookshelf/Server Owners/Commands]] - Complete command reference - [[Bookshelf/Developers/API Reference]] - Developer API documentation