# Lectern
Lectern is a server-side Paper plugin and cinematic effects framework. It allows server-side control of client-side visual effects, camera manipulation, HUD rendering, audio, and more for players running the Lectern client.
---
## Requirements
- **Java 21** or higher
- **Paper** 1.21.4 or higher
## Features
- **Camera Control** — Modify player camera position, yaw, pitch, roll, and field of view from the server.
- **Screen Effects** — Trigger screen flashes, screenshake, letterboxing, blur, motion blur, and tint overlays on individual players.
- **HUD Rendering** — Display custom textures, player heads, buttons, progress bars, and UI components on the client HUD.
- **Packet Components** — Build composable, tickable HUD overlays that only re-send changed elements each tick.
- **Packet Menus** — Create full-screen interactive menus with buttons, textures, text, and hover/click handling.
- **Emotes** — Play emote animations on entities with targeted, local, broadcast, or collection-based viewer targeting.
- **Audio Control** — Play global sounds and audio pings on specific players.
- **Lighting & Environment** — Override fog color, sky color, moon color, enable true darkness, and dense fog on targeted players.
- **Entity Manipulation** — Apply custom capes, skins, nametags, tints, emotes, and model attachments to players client-side.
- **Keybind Control** — Disable, invert, or create custom keybinds on the client.
- **Modal Prompts** — Display modal dialog windows with markdown content and configurable buttons (close, link, or server callback).
- **Shader Effects** — Activate post-processing shaders including outline, blur, tint, flashlight, and motion blur effects.
- **Cutscenes** — Play scripted cutscene sequences with camera paths, HUD overlays, screen effects, and server-side callbacks.
- **Voice Chat Control** — Control player mute/deafen state in Simple Voice Chat with suggestive and forced modes.
- **Network Synchronization** — All effects are sent via custom payload channels and applied per-player.
## Installation
1. Download Lectern from [lode.gg](https://lode.gg/plugin/lectern).
2. Place the `Lectern.jar` file into your server's `plugins/` directory.
3. Restart the server.
---
## Related Pages
- [[Lectern/Server Owners/Configuration]] — Config file reference
- [[Lectern/Server Owners/Commands]] — Full command and permission listing
- [[Lectern/Developers/Overview]] — Developer integration guide
- [[Lectern/Developers/API Reference]] — Lectern-API class reference