diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5118b5f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,65 @@
+# compsigh Minecraft Server
+
+## How to Join
+
+1. **Open Minecraft Java Edition** version **1.21.11**
+2. Go to **Multiplayer** → **Add Server**
+3. Server address: `mc.compsigh.club`
+4. Connect!
+
+## Authentication
+
+You don't need to have bought Minecraft to play. The server uses its own login system called **EasyAuth**.
+
+- An admin will set up your account with a username and password
+- When you join, type your password in chat to log in: `/login <password>`
+
+## Skins
+
+Your skin is the custom appearance of your player character. Since you don't need to own the game to play here, skins don't load automatically. Use **SkinRestorer** to set your skin in-game:
+
+- `/skin set <username>` — copy the skin of any Minecraft player (e.g. `/skin set Notch`)
+- `/skin set url <url>` — set your skin from a direct image URL
+- `/skin clear` — remove your custom skin
+
+## Server Details
+
+| | |
+|---|---|
+| **Version** | 1.21.11 (Fabric) |
+| **Difficulty** | Hard |
+| **PVP** | Off |
+| **Max Players** | 10 |
+
+## Mods & Features
+
+### World Generation
+The server uses enhanced worldgen mods for a more interesting world:
+- **Terralith** & **Tectonic** — overhauled terrain and biomes
+- **Amplified Nether** & **Nullscape** — revamped Nether and End dimensions
+- **Dungeons and Taverns** suite — redesigned structures (strongholds, monuments, temples, mansions, and more)
+- **Explorify** & **Structory** — additional structures and points of interest
+
+### Quality of Life
+- **BlossomTPA** — teleport to other players with `/tpa`
+- **Better ServerSleep** — only a percentage of players need to sleep to skip the night
+- **Nether Portal Fix** — portals always bring you back where you came from
+- **Shulker Drops Two** — shulkers drop 2 shells
+
+### Optional Client Mods
+These server-side mods have client-side companions you can install for extra features:
+- **Simple Voice Chat** — proximity voice chat (install the client mod to use it)
+- **AppleSkin** — shows saturation and hunger info on your HUD
+- **JEI** — lets you look up how to craft any item in the game
+
+### Discord Bridge
+In-game chat is bridged to Discord. Join/leave messages, deaths, and achievements are announced there too.
+
+## Questions?
+
+Reach out to **jet** on Discord for help getting set up, account registration, or anything else.
+
+## Links
+- **Server status**: [status.mc.compsigh.club](https://status.mc.compsigh.club)
+- **Terms**: [mc.compsigh.club/terms](https://mc.compsigh.club/terms)
+- **Privacy**: [mc.compsigh.club/privacy](https://mc.compsigh.club/privacy)