No description

Find a file

s8n ab1f607df6 docs: AuthLimbo v2 research + architecture + roadmap 4 parallel research agents output (2026-05-07): - RESEARCH-2B2T-QUEUE.md — 2b2t queue tech deep-dive: architecture, drama timeline, 5 patterns to copy + 5 to avoid - RESEARCH-LIMBO-PLUGIN-SURVEY.md — open-source plugin survey: STEAL list (Elytrium LimboAPI/LimboAuth + PistonQueue), PATTERN list, SKIP list - V2-ARCHITECTURE.md — Paper-only stack with Velocity-ready seam, 7-state login flow, snapshot-on-pre-login, transparent FIFO trust tiers - V2-ROADMAP.md — M0-M5 milestones with acceptance criteria + dep graph Stack decision: Paper-only for now (no proxy required), but architecture split into Gatekeeper + Restore layers so future Velocity migration is mechanical. Trip-wires codified for when to reconsider. Anti-drama policy locked in code (not config): no paid priority, no hidden veteran tier, transparent ban appeals. Bootstrap repo at git.s8n.ru/s8n/auth-limbo-v2 ready for M0 work.		2026-05-07 19:31:40 +01:00
.github	Rename: LoginLimbo -> AuthLimbo	2026-04-30 19:19:26 +01:00
docs	docs: AuthLimbo v2 research + architecture + roadmap	2026-05-07 19:31:40 +01:00
lib	Initial commit: RackedLimbo 1.0.0	2026-04-30 18:23:13 +01:00
src/main	fix(login): F1+F2+F4 — void-death guard, retry recovery, AuthMe pre-empt	2026-05-07 17:50:00 +01:00
.gitignore	Initial commit: RackedLimbo 1.0.0	2026-04-30 18:23:13 +01:00
AUDIT-2026-05-07.md	docs: incident audit + roadmap for 2026-05-07 void-death	2026-05-07 17:33:07 +01:00
CHANGELOG.md	fix(login): F1+F2+F4 — void-death guard, retry recovery, AuthMe pre-empt	2026-05-07 17:50:00 +01:00
LICENSE	License: switch to AGPL-3.0-or-later	2026-04-30 19:31:34 +01:00
pom.xml	fix(login): F1+F2+F4 — void-death guard, retry recovery, AuthMe pre-empt	2026-05-07 17:50:00 +01:00
README.md	readme: restyle to match minecraft-launcher format	2026-05-05 05:09:34 +01:00
ROADMAP.md	docs: incident audit + roadmap for 2026-05-07 void-death	2026-05-07 17:33:07 +01:00

README.md

auth-limbo

a small paper plugin - fixes AuthMe's broken post-login teleport

built for my server, runs there daily.

Issues · Releases

What it does

Two things.

Void auth_limbo world. Custom ChunkGenerator, 5x5 barrier platform under spawn. AuthMe uses it as pre-auth limbo. No Multiverse-Core required.
Restore-teleport that actually works. LoginEvent listener at MONITOR priority reads quit-location from plugins/AuthMe/authme.db, pins destination chunk via addPluginChunkTicket, chains getChunkAtAsyncUrgently into teleportAsync. No spawn-snap.

Bug background: PaperMC/Paper#4085.

Install

Download AuthLimbo-1.0.0.jar from Releases.
Drop in plugins/.
Restart server. Don't /reload.

Hard dep: AuthMe-ReReloaded. Plugin refuses to load without it.

For itzg/minecraft-server Docker image, see docs/installation.md.

Config

Defaults work. plugins/AuthLimbo/config.yml on first start:

limbo:
  world: auth_limbo
  spawn-x: 0.5
  spawn-y: 128.0
  spawn-z: 0.5
  build-platform: true
  platform-y: 127
authme:
  db-path: plugins/AuthMe/authme.db
  teleport-delay-ticks: 10
  preload-chunks: true
debug: false

Full reference: docs/configuration.md.

Commands

Command	Permission	Effect
`/authlimbo reload`	`authlimbo.admin`	Reload `config.yml`.
`/authlimbo tp <player>`	`authlimbo.admin`	Teleport player to saved location.

Alias: /alimbo.

Tested

Component	Status
Paper 1.21.11	Yes
Purpur 1.21.11	Yes
Folia	Untested — login event threading may differ
AuthMe-ReReloaded (HaHaWTH b49)	Yes
AuthMe-ReReloaded other 5.x forks	Untested — schema same, should work
Multiverse-Core	Untested — possible teleport-intercept conflict, see `docs/compatibility.md`

Build from source

mvn clean package

Shaded jar lands at target/AuthLimbo-1.0.0.jar. Java 21, Maven 3.9. lib/AuthMe-5.6.0-FORK-Universal.jar is system-scope so build needs no private repo credentials.

CI builds via GitHub Actions on every tag.

_{AGPL-3.0 — modified network-deployed builds must offer source per §13. Built by s8n-ru.}