# AuthLimbo v2

> 🚧 **Status: 0.1.0-SNAPSHOT — design phase. Not for production.**

Production-grade Minecraft auth/login gatekeeper. Successor to
[`s8n/auth-limbo`](https://git.s8n.ru/s8n/auth-limbo) (v1).

## Why this exists

V1 (`auth-limbo` 0.1.0–1.1.0) was a pragmatic rescue plugin written to
patch the AuthMe post-login void-death bug observed on the racked.ru
server. The 2026-05-07 incident exposed deeper failure modes that the v1
codebase wasn't structured to address cleanly. F1 + F2 + F4 hot-fixes
landed in v1 — v2 is the proper redesign as a successor.

## Goals

- **Production-grade.** Tight failure modes, observable, no silent drops.
- **2b2t-tight queue robustness.** Survives storms, slow logins,
  bad clients, and AuthMe quirks without losing players.
- **Privacy-first.** No telemetry. Local data stays local.
- **No drama.** See [`docs/DRAMA-AVOIDANCE.md`](docs/DRAMA-AVOIDANCE.md).

## Non-goals

- ❌ Paid priority queue. Ever.
- ❌ Opaque "veteran tier" systems.
- ❌ Vanity feature creep. The plugin gates auth — that's the whole job.

## Architecture

See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) once written
(currently a placeholder pointing at v1's `V2-ARCHITECTURE.md` research).

## Roadmap

See [`docs/ROADMAP.md`](docs/ROADMAP.md) (placeholder pointing at v1's
`V2-ROADMAP.md`). Living doc — items move as research agents land work.

## License

[AGPL-3.0-or-later](LICENSE). All forks must remain copyleft.

## Dev quickstart

```sh
git clone ssh://git@git.s8n.ru:222/s8n/auth-limbo-v2.git
cd auth-limbo-v2
mvn -B clean package
# artifact: target/auth-limbo-v2-0.1.0-SNAPSHOT.jar
```

Java 21, Maven 3.9+, Paper 1.21.x. See [`CONTRIBUTING.md`](CONTRIBUTING.md).

## Links

- Repo: <https://git.s8n.ru/s8n/auth-limbo-v2>
- v1 (predecessor): <https://git.s8n.ru/s8n/auth-limbo>
- Mission: [`docs/MISSION.md`](docs/MISSION.md)
- Drama avoidance: [`docs/DRAMA-AVOIDANCE.md`](docs/DRAMA-AVOIDANCE.md)
- Changelog: [`CHANGELOG.md`](CHANGELOG.md)