# Observer Observer is a premium event management plugin that completely overhauls how you host and manage competitive events on your Minecraft server. It provides a comprehensive suite of tools for game state control, player management, elimination tracking, capsule-based spawning, lifesteal mechanics, and much more. --- ## Premium Plugin Observer is a **premium** plugin available at [https://lode.gg/plugin/observer](https://lode.gg/plugin/observer). A valid license key is required to use the plugin. Your license key is your **Discord ID**, which you can find by enabling Developer Mode in Discord settings, then right-clicking your profile and selecting "Copy ID." --- ## Features ### [[Observer/Server Owners/Systems#Event Lifecycle|Game State Management]] Observer manages the full lifecycle of an event through three states: `IN_LOBBY`, `PRE_GAME`, and `IN_GAME`. Transitions between states are controlled through commands and the in-game GUI, with full event support for external plugins to hook into state changes. ### [[Observer/Server Owners/Systems#Capsule System|Capsule System]] The capsule system handles player spawning and scattering with support for multiple modes: - **BATTLE_ROYALE** - Scatter players across the map within configurable min/max ranges - **CIVILIZATION** - Spawn players in clustered groups within a configurable radius - **WORLD_SPAWN** - Spawn players near world spawn within a configurable radius Capsules support team integration via the Lead plugin and include a whitelist system. ### [[Observer/Server Owners/Systems#Elimination System|Elimination System]] Track player eliminations with configurable behavior including death messages, gamemode on death (spectator by default), lightning strikes on kills, auto-ban functionality with bypass permissions, auto-respawn, and customizable remaining player counts. ### [[Observer/Server Owners/Systems#Lifesteal System|Lifesteal System]] A full lifesteal mechanic where players drop hearts on death. Configure heart item appearance, max/min health thresholds, whether hearts are stackable, and the lifesteal type (`DROP`, `CONSUME`, `OBTAIN`, or `ANYTIME`). Players can withdraw hearts from their own health using the `/withdraw` command. ### [[Observer/Server Owners/Systems#Pedestal System|Pedestal System]] Place item pedestals in the world that act as crafting stations. Pedestals require specific ingredient items and produce a result item. Supports three use modes: `SINGLE_USE`, `PER_PLAYER`, and `REUSABLE`. Pedestals display holographic item previews. ### [[Observer/Server Owners/Systems#Mechanics System|Mechanics System]] Toggle a wide range of gameplay mechanics including: - Apple drop rates and flint rates - Sleeping, enchanting, anvil usage, ender chests - Villager breeding and trading - Respawn anchors, bed bombing, portal trapping - Indirect PvP, potion brewing - Global block decay, unbreakable spawners - World border improvements and synchronization - Nether and End access - Combat logging with configurable duration and display type - Block trampling - Auto-grant all recipes ### [[Observer/Server Owners/Systems#World Event System|World Event System]] Create and manage custom world events that execute commands and broadcast translation messages when activated. Events are controlled through the GUI or commands and support start/end lifecycle states. ### [[Observer/Server Owners/Systems#Kit System|Kit System]] Save, load, import, and export complete player states as kits. Kits preserve inventory contents, health, food level, saturation, experience, potion effects, and optionally location. Supports weighted random kit distribution to multiple players. ### [[Observer/Server Owners/Systems#Respawn System|Respawn System]] Capture and restore full player states on respawn, including inventory, health, experience, potion effects, and location. ### [[Observer/Server Owners/Systems#Late Scatter System|Late Scatter System]] Allow players who join after the game has started to be scattered into the event world with a configurable gamemode and starting inventory. ### [[Observer/Server Owners/Systems#Custom Recipes System|Custom Recipes System]] Register custom shaped and shapeless crafting recipes that persist across server restarts. ### [[Observer/Server Owners/Systems#HelpOp System|HelpOp System]] Players can submit help requests to online staff with a configurable cooldown. Staff can view all pending requests through an in-game menu. ### Restriction System Restrict specific items and enchantments from being used during events. Manage restrictions through the in-game menu. ### [[Observer/Server Owners/Systems#Translation System|Translation System]] All player-facing messages support MiniMessage formatting with title, tellraw, and sound translations. Messages support variable placeholders and centered text rendering. ### [[Observer/Server Owners/Systems#Player Data System|Player Data System]] Track per-player state including combat status, lobby mode, death status, staff mode, team binding, late scatter status, sit-out status, and WorldGuard region assignment. --- ## Dependencies | Dependency | Type | Purpose | |---|---|---| | **Bookshelf** | Required | Core framework providing configuration, events, commands, and item management | | **Lead** | Optional | Team management integration for capsule team assignments | | **WorldGuard** | Optional | Region-based player management | All-in-all, you are required to install [Bookshelf](https://lode.gg/plugin/bookshelf) into your server in order for Observer to work. --- ## Folia Support Observer fully supports the Folia server platform for regionized multithreading. This is lightly tested, we have not tested Observer at a large scale. Purchase at your own risk, Folia **isn't FULLY** supported. --- ## Related Pages - [[Observer/Server Owners/Configuration]] - Full config.yml breakdown - [[Observer/Server Owners/Commands]] - Complete commands reference - [[Lead/Developers/API Reference]] - Developer API documentation