Lobby Systems v1.8.1 — Fabric 26.2

Server-side lobby framework untuk Minecraft Fabric 26.2. Lobby Systems menangani lobby placement, portal antar-dimensi, gamemode/gamerule per dimensi, Starter Kit, penyimpanan posisi player, dan hybrid authentication untuk premium + local/cracked player.

Target

• Minecraft: 26.2
• Java: 25
• Fabric Loader: 0.19.3
• Fabric API: 0.156.0+26.2
• Fabric Loom: 1.17
• Mod ID: dartokloning
• Namespace: id.dartokloning.lobbysystems
• License: All Rights Reserved

Lobby Systems adalah mod server-side. WorldEdit Fabric diperlukan untuk workflow pembuatan portal dari selection.

Build

Windows:

.\compile.bat

Linux:

./compile.sh

Script membaca versi dari gradle.properties, menggunakan Java 25, dan menyediakan integrasi Git setelah build. release.bat / release.sh digunakan untuk build release, push branch/tag, membuat Gitea release, dan mengunggah JAR.

Struktur konfigurasi

config/lobby/
├── config.json
├── player-positions.json
├── portals.json
├── dimension-gamemodes.json
├── dimension-gamerules.json
├── starterkits.json
├── starterkit-recipients.json
└── auth/
    ├── config.json
    └── accounts.json

/ls reload me-reload seluruh konfigurasi Lobby Systems, termasuk config utama, Auth, portal, dimension gamemode, dimension gamerule, dan Starter Kit. Perubahan Auth juga diterapkan ke session player yang sedang online. Perubahan rulesVersion, rulesEnabled, requireLoginEveryJoin, dan enabled tidak memerlukan restart server.

Lobby dan login placement

Player ditempatkan ke Lobby pada fase awal login agar world gameplay sebelumnya tidak sempat menjadi world awal yang dikirim ke client. Lobby sebaiknya merupakan dimensi yang safe dan secure karena player yang belum selesai authentication ditahan di posisi login sampai proses selesai.

/lobby hanya tersedia dari luar Lobby dan mengikuti minimum gameplay time yang dikonfigurasi. Posisi terakhir per gameplay dimension disimpan terpisah; Lobby dikecualikan dari penyimpanan posisi gameplay.

Authentication System

Server tetap menggunakan:

online-mode=true

Lobby Systems kemudian menyediakan hybrid authentication:

• Premium: tetap melalui official Mojang/vanilla authentication.
• Local/cracked: menggunakan deterministic offline UUID dan password Lobby Systems.
• Username premium tidak boleh diregistrasikan sebagai local account.
• Password disimpan sebagai PBKDF2-HMAC-SHA256 dengan random salt; plaintext password tidak disimpan.

Dialog flow

Authentication v1.8 menggunakan vanilla Minecraft Dialog UI sehingga normal player tidak perlu mengetik /register atau /login.

First join dapat mengikuti:

Connect
  -> Server Rules (jika aktif/belum accepted)
  -> Create Account (jika local password diperlukan)
  -> Authenticated

Returning local player:

Connect -> Rules jika versi berubah -> Sign In -> Authenticated

/register dan /login tetap tersedia sebagai fallback compatibility.

requireLoginEveryJoin

Default:

"requireLoginEveryJoin": false

Semantik:

• false: premium player cukup dengan Mojang authentication dan auto-login; local/cracked player tetap wajib password Lobby Systems pada setiap connection.
• true: premium player tetap diverifikasi Mojang, tetapi juga wajib mempunyai dan memasukkan password Lobby Systems setiap connection. Local/cracked player tetap wajib password seperti biasa.

Jadi true merupakan lapisan password tambahan untuk premium account, bukan pengganti Mojang authentication.

Server Rules

Auth config menyediakan rulesEnabled dan rulesVersion. Acceptance disimpan per account. Naikkan rulesVersion jika semua account perlu menerima versi rules yang baru. /ls reload langsung menerapkan perubahan versi rules kepada player yang sedang online.

Auth account data

config/lobby/auth/accounts.json menyimpan metadata account, rules acceptance, salt, password hash, dan PBKDF2 iteration count. File ini bukan tempat plaintext password.

Portal System

Portal dibuat dari WorldEdit selection dan disimpan di portals.json. Visual portal menggunakan vanilla minecraft:nether_portal blocks, tetapi registered Lobby Systems portal mencegah vanilla Nether portal routing mengambil alih.

Destination dapat mengarah ke dimensi lain dan teleport menggunakan TeleportTransition, chunk preload, serta teleport lock. Portal visual dapat diperbaiki kembali saat reload/startup.

Gunakan command /ls portal ... yang tersedia melalui command completion untuk create/delete/info dan maintenance portal.

Dimension Gamemode

Gamemode per dimension bersifat authoritative dan selalu aktif.

/ls gamemode list
/ls gamemode set <dimension> <gamemode>
/ls gamemode remove <dimension>

Mapping disimpan di dimension-gamemodes.json dan diterapkan pada join serta perpindahan dimension.

Contoh:

/ls gamemode set minecraft:lobby adventure
/ls gamemode set minecraft:creative creative
/ls gamemode set minecraft:flat_survival survival
/ls gamemode set minecraft:flat_creative creative

Dimension Gamerules

Gamerule dapat diatur per dimension dan disimpan di dimension-gamerules.json. Nilainya diterapkan ke native gamerules masing-masing ServerLevel, sehingga tidak bergantung pada global gamerule saja.

Gunakan /ls gamerule ... beserta command completion untuk melihat dan mengubah mapping.

Starter Kit

Starter Kit adalah snapshot inventory/equipment per dimension. Hanya satu kit yang dapat aktif untuk satu dimension, dan eligibility automatic delivery dicatat per player + dimension.

/ls starterkit set <name> <dimension>
/ls starterkit load <name>
/ls starterkit activate <name>
/ls starterkit deactivate <name>
/ls starterkit give <name> <player>
/ls starterkit list
/ls starterkit info <name>
/ls starterkit status <dimension> <player>
/ls starterkit reset <dimension> <player>
/ls starterkit delete <name>

Automatic delivery dijalankan setelah dimension change dengan delay agar kompatibel dengan mod inventory-per-dimension seperti Dimensional Inventories. /ls starterkit give adalah forced admin give dan tidak mengubah recipient history.

Command utama

/lobby
/ls reload
/ls tp <dimension>
/ls gamemode ...
/ls gamerule ...
/ls portal ...
/ls starterkit ...

Command /ls administratif memerlukan operator permission sesuai implementasi command.

/ls reload

Reload adalah satu pintu untuk seluruh runtime configuration. Urutannya mencakup:

1. config.json
2. Auth config.json + accounts.json
3. portals.json + portal visual repair
4. dimension-gamemodes.json + apply ke dimension/player
5. dimension-gamerules.json + apply ke loaded dimensions
6. Starter Kit data
7. Refresh runtime state yang terkait

Console menampilkan RELOAD START dan RELOAD COMPLETE. Player admin yang menjalankan command menerima ringkasan hasil reload tanpa broadcast ke player lain.

Catatan v1.8.1

• Memperbaiki compile error Fabric 26.2 pada Auth dialog command dispatch: ServerPlayer#getServer() diganti dengan server dari player.level().getServer().
• /ls reload sekarang tidak hanya membaca ulang Auth config tetapi juga menerapkan perubahan Auth ke session player yang sedang online.
• README diatur ulang berdasarkan subsistem, bukan riwayat patch versi lama.
• Dialog Rules/Register/Login tetap menjadi primary authentication UI; command login/register dipertahankan sebagai fallback.

Known compatibility note

Local/cracked identity tidak memiliki Mojang profile public key. Jika server mempertahankan enforce-secure-profile=true, vanilla secure-chat dapat menolak normal chat local player dengan pesan missing profile public key. Masalah secure-chat ini terpisah dari keberhasilan login/authentication dan perlu compatibility handling khusus.

License

All Rights Reserved. Source dan asset Lobby Systems tidak boleh didistribusikan atau digunakan ulang di luar izin pemilik project.