# WhiteRose SMP — Admin Guide

## Server Info

| Field | Value |
|---|---|
| Version | 1.21.11 (Java Edition) · Paper |
| Seed | `694292435256417637` |
| Connection | `whiterose-smp.com` (default port 25565) |
| Whitelist | ON — admins must add new players |
| BlueMap | [Live 3D map](http://whiterose-smp.com:8100) |

→ [Technical overview](?doc=tech) — infrastructure, settings, and how everything fits together.

## Admins

| Minecraft Username | Role |
|---|---|
| FinchMoon | Operator |
| Grimr0se | Operator |
| SummerRaven07 | Operator |

---

## How to Admin This Server

Most tasks do NOT require SSH or WinSCP. Use these in order of preference:

**1. In-game** — press `/` and type commands.

**2. Discord `#console` channel** — type commands here and they run on the server. Works from your phone. This is the primary remote admin tool.

**3. [WinSCP](?doc=winscp)** — for file management: installing plugins, editing configs, browsing logs.

**4. SSH terminal** — rarely needed. Only for OS-level maintenance.

---

## Quick Reference — Console Commands

| Command | What it does |
|---|---|
| `stop` | Graceful restart (auto-restarts in ~30 seconds) |
| `op <player>` / `deop <player>` | Grant/revoke operator status |
| `ban <player>` / `pardon <player>` | Ban/unban |
| `kick <player>` | Kick |
| `whitelist add <player>` | Add to whitelist (required to join) |
| `whitelist remove <player>` | Remove from whitelist |
| `whitelist list` | Show whitelisted players |
| `say <message>` | Broadcast message |
| `tp <player> <target>` | Teleport |
| `difficulty easy/normal/hard` | Set difficulty (currently normal) |
| `tps` | Check server performance (20 = perfect) — for *why* it lags, see [Performance (spark)](?doc=spark) |

> **WARNING:** Never paste multiple commands at once. The server treats newlines as part of a single command and will crash. One command at a time.

---

## Guides

- **[WinSCP Setup & Usage](?doc=winscp)** — connecting, uploading plugins, editing configs
- **[Plugins](?doc=plugins)** — installing, removing, updating, current plugin list
- **[Discord Integration](?doc=discord)** — DiscordSRV config, bot setup, channel routing
- **[Maintenance](?doc=maintenance)** — backups, updates, daily restarts, server settings
- **[Performance (spark)](?doc=spark)** — diagnosing lag: TPS, memory, and profiling
- **[Debugging with a chat bot](?doc=debugging)** — solve most issues yourself using the live debug bundle
- **[Emergency / Troubleshooting](?doc=emergency)** — SSH fallback, crash recovery, common fixes

---

## Editing This Guide

This guide is a set of markdown files on the server. Changes go live instantly — no restart needed.

**With WinSCP:** Navigate to `/var/www/minecraft/guide/`, double-click any `.md` file, edit, save.

**With SSH:** `nano /var/www/minecraft/guide/plugins.md` (or whichever file).

Changes are automatically version-tracked, so don't worry about breaking anything — previous versions can always be restored.