Build / build (push) Has been cancelled

Details

readme: restyle to match minecraft-launcher format

Centered hero header with chunky black Download badge, small chip
badges below, em-dash tagline, single-line nav row. Sections trimmed,
license collapsed to <sub> footer line. Same visual language as
s8n-ru/minecraft-launcher README.

2026-05-05 05:09:34 +01:00

3.2 KiB

Raw Blame History

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.}

3.2 KiB Raw Blame History