s8n/auth-limbo-v2
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
auth-limbo-v2/CONTRIBUTING.md
s8n 226bebadbd bootstrap: AuthLimbo v2 0.1.0-SNAPSHOT (design phase) 
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.
2026-05-07 19:30:40 +01:00

2.3 KiB
Raw Permalink Blame History

Contributing to AuthLimbo v2

Thanks for considering a contribution. v2 is currently in design phase (0.1.0-SNAPSHOT) — most of the value right now is in architecture review, not code.

Toolchain

  • JDK: Eclipse Temurin (or any) 21+
  • Maven: 3.9+
  • Paper: 1.21.x (1.21.4 API target)
  • OS: Linux preferred; Windows/macOS fine via standard JDK

Build

mvn -B clean package

Artifact lands at target/auth-limbo-v2-0.1.0-SNAPSHOT.jar.

Test server setup

A throwaway local Paper server is the easiest way to smoke-test changes:

mkdir -p test-server && cd test-server
# fetch latest Paper 1.21.x build from https://papermc.io
java -Xms1G -Xmx2G -jar paper.jar nogui
# accept eula.txt
# stop, copy target/auth-limbo-v2-*.jar into plugins/, restart

test-server/ is in .gitignore — never commit world data or a Paper jar.

For AuthMe-integration testing, drop the AuthMe-ReReloaded fork jar in the same plugins/ folder. The v1 repo carries a vendored copy under lib/ for reference.

Branch / PR policy

  • main is protected. All work goes via feature branch + PR.
  • Branch names: feat/<thing>, fix/<thing>, docs/<thing>.
  • One logical change per PR. Squash on merge if the history is messy.
  • Every PR must update CHANGELOG.md under [Unreleased].

Commit identity

This repo uses:

Author: s8n <admin@s8n.ru>

Strip Co-Authored-By: trailers before committing. This is repo convention — see ai-lab memory user_git_identity.md for the full rationale (post-2026-05-07 Forgejo rename + identity tightening).

git -c user.name="s8n" \
    -c user.email="admin@s8n.ru" \
    -c commit.gpgsign=false \
    commit -m "scope: subject"

Code style

  • 4-space indent, no tabs.
  • Java 21 idioms (records, pattern matching, switch expressions where they help).
  • No unused imports, no wildcard imports.
  • @Nullable / @NotNull annotations on public method boundaries.
  • Logging via getLogger(), not System.out.

Reporting issues

File issues at https://git.s8n.ru/s8n/auth-limbo-v2/issues. Include:

  • Paper version (/version)
  • AuthMe version
  • Plugin version (/plugins)
  • Log excerpt — at least 50 lines around the failure
  • Repro steps

License

By contributing, you agree your contribution is licensed under AGPL-3.0-or-later.