62 lines
2 KiB
Markdown
62 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)
|