s8n
226bebadbd
Successor to s8n/auth-limbo following 2026-05-07 void-death incident. Production-grade auth/login gatekeeper aspiring to 2b2t queue robustness while explicitly avoiding pay-to-play / opaque-tier drama. AGPL-3.0. Java 21. Paper 1.21.x. Status: 0.1.0-SNAPSHOT, design phase. Architecture + roadmap docs land from parallel research agents in subsequent commits.
61 lines
2 KiB
Markdown
61 lines
2 KiB
Markdown
# 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)
|