# 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 (with auto-ban) - **Vanish system** with full player hiding, blocked container animations, and glow effect - **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 - See [[Bookshelf/Server Owners/Features/Moderation]] for full details ### Teleportation - **Teleport to player** (`/teleportto`, `/tpto`) - **Teleport here** (`/teleporthere`, `/tphere`) - **Teleport all** (`/teleportall`, `/tpall`) - **Teleport offline** players to locations or to you (pending teleport on next login) - **Back command** to return to previous location (tracked on teleport, death, and join) - **Top command** to teleport to the highest safe block - **Spawn command** for world spawn teleportation - **Warp system** with per-warp permissions and individual YAML storage - **World command** for cross-world teleportation with world creation/deletion - **Configurable delays and cooldowns** with bypass permission - See [[Bookshelf/Server Owners/Features/Teleportation]] for full details ### 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 persistent state and configurable hit-through option - **Kit system** with save/load, export/import, weighted random selection, and GUI - **Night vision** toggle - **Fix/repair** items with partial repair and type targeting - **Upgrade/downgrade** items through material tiers - **Rename and lore** editing with MiniMessage support - **Hat command** to wear any item - **Skull command** to get player heads (fetched from Mojang) - **Workbench** to open a portable crafting table - **Ender chest** viewing (`/endersee`) - **Clone** items or entire inventories to other players - **Bundle** management — pack inventory into containers - **Armor trim** command - **Enchant/disenchant** with unsafe enchantment support - **Durability** control and max durability - **Item model** and item cooldown management (1.21.4+) - **PowerTool** — bind commands to items with delays, placeholders, and multi-command support - **Sudo** to execute commands as another player - **Kill** and **kill all** (entity clearing / clearlag) - **Time commands**, weather control, lightning, extinguish, velocity - See [[Bookshelf/Server Owners/Features/Utilities]] and [[Bookshelf/Server Owners/Features/Kits]] for full details ### Player Attributes - **Scale** player size (0–16) - **Health** and **max health** modification (1–2048) - **Gravity** scale (including zero gravity) - **Reach** (block reach and entity reach, independently or together) - **Knockback resistance** adjustment - **Reset all attributes** to defaults - See [[Bookshelf/Server Owners/Features/Utilities]] for full details ### Chat System - **LuckPerms integration** — prefixes, suffixes, rank colors, chat colors, and per-group cooldowns all read from LuckPerms meta nodes - **Custom resource pack fonts** — use `<font:name>` in prefixes for custom rank icons - **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 regex support and 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 (STAFF, custom channels) - **Network chat** via Redis for cross-server messaging - **Chat moderation event** — plugins can listen for and override moderation decisions - See [[Bookshelf/Server Owners/Features/Chat System]] for full details ### 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/Features/Chat System]] - Chat formatting, LuckPerms, moderation, and channels - [[Bookshelf/Server Owners/Features/Moderation]] - Infractions, vanish, social spy, and alt detection - [[Bookshelf/Server Owners/Features/Teleportation]] - Warps, delays, cooldowns, and offline teleportation - [[Bookshelf/Server Owners/Features/Kits]] - Kit system with save, load, export, and weighted selection - [[Bookshelf/Server Owners/Features/Utilities]] - Item commands, attributes, flight, god mode, and powertool - [[Bookshelf/Server Owners/Configuration]] - Full config.yml breakdown - [[Bookshelf/Server Owners/Commands]] - Complete command reference - [[Bookshelf/Developers/API Reference]] - Developer API documentation