LUMINA
🚀
Launcher
Konta Microsoft i offline, wiele instancji, kilka gier naraz, mody i shadery z Modrinth, Sodium + Iris domyślnie, automatyczne aktualizacje klienta.
Klient Minecraft
dla administracji serwerów
Lumina to launcher, klient w grze i plugin serwera, które działają razem. Panel graczy z karami, zgłoszenia, regiony WorldGuard w 3D, podgląd WorldEdit, X-ray i freecam na permisjach, rangi z LuckPerms, znajomi i czat. Bez liczników CPS i keystrokes — tylko narzędzia do prowadzenia serwera i budowania.
Darmowe · Windows 10/11 · Minecraft: Java Edition (konto Microsoft) · Java pobiera się sama
3 w 1launcher · klient · plugin
14modułów HUD
20permisji do LuckPerms
8skrótów klawiszowych
🛠️
Klient w grze
Własne menu główne i menu pauzy, HUD admina, szybkie akcje, give item, podgląd WorldEdit, miarka, X-ray, freecam, panel graczy i zgłoszenia.
🧩
Plugin LuminaServer
Dla serwerów Paper. Daje klientowi dokładne TPS, rangi z LuckPerms, kary, vanish, invsee, zgłoszenia i regiony WorldGuard — wszystko na permisjach.
Co jest w środku
Każda funkcja poniżej jest już zrobiona i przetestowana na serwerze Paper 26.3 z LuckPerms, WorldEdit i WorldGuard.
Klawisz Prawy Shift
HUD admina — 14 modułów
Każdy moduł włączasz osobno i przeciągasz myszką w edytorze HUD. Pozycje zapisują się procentowo, więc działają w każdej rozdzielczości.
- TPS i MSPT prosto z serwera (z pluginem) albo szacowane bez niego
- Celownik — blok lub byt: ID, stan bloku, światło, HP, a dla graczy ranga i IP (z permisją)
- Chunk — współrzędne chunka, plik regionu
r.x.z.mca, biom - Region WG, Zaznaczenie WE, Miarka, Zgłoszenia, Lumina (kto ma klienta)
Klawisz H
Szybkie akcje
Tryb gry, dzień/noc, pogoda, czyszczenie itemów z ziemi, zapis świata i stan ticków — jednym kliknięciem, bez wpisywania komend.
- Wizualizacje F3: hitboxy, granice chunków, światło (gdzie mogą spawnić się moby), kolizje
- X-ray, Freecam, Regiony WG i podgląd WE jako przełączniki
- Narzędzia po boku: kompas (teleport LPM/PPM), drewniana siekierka WorldEdit, skóra WorldGuard, debug stick
Klawisz B · lumina.admin.panel
Panel graczy i kary
Lista graczy online z wyszukiwarką. Po kliknięciu: UUID, IP (z permisją), ping, świat, tryb gry, HP, czas gry, liczba ostrzeżeń, ranga i wersja Lumina.
- Kick, warn, mute, ban, unmute — z własnym powodem i czasem (
30m,7d,perm) - Szablony kar z
config.yml— np. „Reklama · 3d” jednym kliknięciem - Automatyczny mute po X ostrzeżeniach
- Teleport, podgląd ekwipunku i enderchesta (z edycją), vanish
- Każda kara zapisywana w
punishments.log
Klawisz N · lumina.admin.reports
Zgłoszenia graczy
Gracze zgłaszają komendą /report <gracz> <powód> (albo /zglos). Administracja dostaje powiadomienie w grze i licznik w HUD.
- Kolejka zgłoszeń: kto, kogo, za co, gdzie (świat i współrzędne)
- Przejmij, zamknij, teleport na miejsce, przejście do gracza w panelu
- Ochrona przed spamem — odstęp między zgłoszeniami ustawiasz w configu
lumina.admin.regions · WorldGuard
Regiony WorldGuard w 3D
Granice regionów w promieniu 128 bloków rysowane w świecie — także przez teren, więc widzisz je zza góry. Każdy region ma stały kolor.
- Prostopadłościany i wielokąty (
poly2d) - Nazwa i priorytet nad regionem
- Karta HUD: region, w którym stoisz — priorytet, właściciele, członkowie, rodzic i flagi (DENY na czerwono, ALLOW na zielono)
WorldEdit CUI · klawisz J
Podgląd WorldEdit i miarka
Zaznaczenie WorldEdit widoczne w 3D przez oficjalny protokół WorldEdit CUI — działa też razem z modem WorldEdit w instancji.
- Ramka zaznaczenia, Pos 1 / Pos 2, środek, wymiary i liczba bloków
- Miarka (J): zaznacz dwa bloki — odległość, wymiary i liczba bloków między nimi
- Karta celownika: ID bloku, stan, światło bloku i nieba
Klawisze K i V · lumina.xray / lumina.freecam
X-ray i freecam — tylko dla administracji
Do sprawdzania graczy podejrzanych o X-ray i do obserwacji. Działają tylko w singleplayerze albo gdy serwer nada permisję — zwykły gracz z Luminą ich nie włączy.
- X-ray pokazuje cenne rudy przez ściany (najbliższe najpierw) z licznikiem w HUD
- Freecam: wolna kamera, ciało gracza zostaje na miejscu
Z menu szybkich akcji
Give item i itemy specjalne
Wszystkie itemy z zakładkami jak w trybie kreatywnym, z wyszukiwarką i wyborem ilości. Do tego itemy operatorskie (command block, barrier, light, structure block…).
- Zakładka Specjalne: przedmioty „nielegalne” do testów — przesadzone enchanty, wieczne elytry, stack totemów, mikstury z dawnych bugów
- Przydatne do sprawdzania pluginów anty-cheat i zabezpieczeń serwera
Esc
Menu pauzy Lumina
Nowe menu pauzy w stylu klienta: wszystkie zwykłe opcje plus skróty do narzędzi Lumina i karta sesji.
- Karta sesji: serwer, liczba graczy, ping, TPS, Twoja ranga, czas sesji, znajomi online, wersja pluginu
- Skróty: Klient Lumina, szybkie akcje, znajomi, panel graczy i zgłoszenia (z licznikiem)
- Linki serwera (server links) działają jak w zwykłym menu
Klawisz U · Lumina Network
Znajomi, czat i ikonki przy nicku
Znajomi i prywatne wiadomości działają w launcherze i w grze. Widzisz, na jakim serwerze gra znajomy i jaką ma tam rangę.
- Logowanie przez konto Minecraft — bez osobnego hasła
- Ikonka Lumina przy nicku w TAB i nad głową, w kolorze rangi; administracja ma osobną ikonkę
- Ranga i kolor z LuckPerms albo z permisji
lumina.rank.<nazwa>.<kolor>
Wszystkie moduły HUD
TPS + MSPTPingFPSSerwerCelownikChunkWorldEdit
Region WGMiarkaX-rayFreecamZgłoszeniaLuminaZegar
Wszystkie można wyłączyć, przesunąć i schować (PPM w edytorze). Tło pod modułami też jest opcjonalne.
Skróty klawiszowe
| Prawy Shift | Menu Lumina (moduły, edytor HUD) |
| H | Szybkie akcje i narzędzia |
| B | Panel graczy (gracz w celowniku od razu zaznaczony) |
| N | Zgłoszenia |
| U | Znajomi i czat |
| K | X-ray |
| V | Freecam |
| J | Miarka — zaznacz blok |
Każdy klawisz zmienisz w Ustawienia → Sterowanie → kategoria Lumina.
Launcher
Szybki, ciemny, w stylu klienta. Wszystko, czego trzeba, żeby odpalić Minecrafta — i nic więcej.
Konta
Logowanie kontem Microsoft (hasło zostaje u Microsoftu) oraz konta offline do testów. Tokeny zaszyfrowane systemowo.
Instancje
Każda instancja ma własne mody, światy, ustawienia i pamięć RAM. Vanilla albo Fabric, dowolna wersja Minecrafta.
Kilka gier naraz
Przycisk „Kolejne okno” uruchamia następną kopię gry — na tym samym albo innym koncie. Idealne do testów z drugim graczem.
Java sama
Launcher pobiera właściwą wersję Javy od Mojang (dla 26.3 — Java 25). Nic nie trzeba instalować ręcznie.
Mody i shadery
Wyszukiwarka Modrinth wbudowana w launcher. Shadery instalujesz jednym kliknięciem.
Wydajność
Domyślnie Sodium + Iris (shadery). Do wyboru OptiFabric, jeśli jest dostępny dla danej wersji.
Aktualizacje
Klient Lumina aktualizuje się sam przed startem gry — z kontrolą sumy SHA-1 pobranego pliku.
Konsola
Podgląd logów gry na żywo — przydatne, gdy coś się wysypie.
Dla właścicieli serwerów
Plugin LuminaServer łączy serwer z klientem. Bez pluginu klient też działa (HUD, WorldEdit, budowanie), ale funkcje administracji wymagają pluginu i permisji.
1
Pobierz lumina-server.jar i wrzuć do plugins/ serwera Paper 26.3.
2
Uruchom serwer. Powstanie plik plugins/LuminaServer/config.yml z szablonami kar i wiadomościami.
3
Nadaj permisje przez LuckPerms (przykład niżej). Opcjonalnie dodaj WorldGuard, żeby działały regiony w 3D.
# Administracja — wszystko /lp group admin permission set lumina.staff true /lp group admin permission set lumina.rank.admin.red true /lp group admin permission set lumina.admin.* true /lp group admin permission set lumina.xray true /lp group admin permission set lumina.freecam true # Moderator — tylko panel, mute, warn, kick i zgłoszenia /lp group moderator permission set lumina.rank.moderator.aqua true /lp group moderator permission set lumina.admin.panel true /lp group moderator permission set lumina.admin.mute true /lp group moderator permission set lumina.admin.warn true /lp group moderator permission set lumina.admin.kick true /lp group moderator permission set lumina.admin.reports true # VIP — tylko kolor i nazwa rangi przy nicku /lp group vip permission set lumina.rank.vip.ffaa00 true
Wszystkie permisje
| Permisja | Domyślnie | Co daje |
|---|---|---|
| Rangi i oznaczenia | ||
lumina.rank.<nazwa>.<kolor> | — | Nazwa i kolor rangi przy nicku, np. lumina.rank.admin.red, lumina.rank.vip.ffaa00. Z LuckPerms ranga jest też brana z grupy i prefiksu. |
lumina.staff | nikt | Oznaczenie administracji (osobna ikonka przy nicku) |
| Informacje | ||
lumina.tps | wszyscy | Dokładne TPS i MSPT serwera w HUD |
lumina.admin.playerinfo | nikt | Karta gracza w celowniku: ranga, świat, czas gry |
lumina.admin.ip | nikt | Adres IP gracza w karcie i w panelu |
lumina.admin.regions | nikt | Regiony WorldGuard w 3D i karta regionu (wymaga WorldGuard) |
| Narzędzia | ||
lumina.xray | nikt | X-ray (K) |
lumina.freecam | nikt | Freecam (V) |
| Panel graczy i kary | ||
lumina.admin.panel | nikt | Panel graczy (B): lista i karta gracza |
lumina.admin.kick | nikt | Wyrzucanie |
lumina.admin.ban | nikt | Bany czasowe i permanentne |
lumina.admin.mute | nikt | Wyciszanie i odciszanie |
lumina.admin.warn | nikt | Ostrzeżenia (z automatycznym mute po limicie) |
lumina.admin.tp | nikt | Teleport do gracza |
lumina.admin.invsee | nikt | Podgląd i edycja ekwipunku oraz enderchesta |
lumina.admin.vanish | nikt | Vanish — niewidzialność dla graczy |
lumina.vanish.see | nikt | Widzi graczy w vanishu |
| Zgłoszenia i komendy | ||
lumina.report | wszyscy | /report <gracz> <powód> (alias /zglos) |
lumina.admin.reports | nikt | Powiadomienia o zgłoszeniach i ekran zgłoszeń (N) |
lumina.command | OP | /lumina — kto ma klienta i stan pluginu |
Ważne: gdy na serwerze jest LuckPerms, o dostępie decydują wyłącznie nadane permisje — samo OP nic nie daje. Bez LuckPerms uprawnienia administracyjne mają operatorzy (OP).
Konfiguracja — config.yml
# Szablony kar w panelu graczy (type: kick / mute / ban / warn) reasons: - { label: "Spam", type: mute, duration: 30m } - { label: "Reklama", type: ban, duration: 3d } - { label: "Cheaty", type: ban, duration: 30d } - { label: "Multikonto do omijania bana", type: ban, duration: perm } - { label: "AFK", type: kick } # 3 ostrzeżenia = automatyczny mute na 1 h warns-to-mute: 3 warns-mute-duration: 1h # Minimalny odstęp między zgłoszeniami jednego gracza report-cooldown-seconds: 60
Wymagania
Paper 26.3 (Java 25). Opcjonalnie: LuckPerms 5.5+, WorldGuard 7 + WorldEdit.
Gracze bez Luminy
Nic się dla nich nie zmienia. Plugin działa w tle, a /report działa dla wszystkich.
Bezpieczeństwo
Każda akcja z panelu jest sprawdzana na serwerze. Klient nie może sam nadać sobie uprawnień.
Galeria
Prawdziwe zrzuty z gry i launchera. Kliknij, żeby powiększyć.
Instalacja — gracz / administrator
- Pobierz Lumina-Setup.exe i uruchom instalator.
- W zakładce Konta zaloguj się kontem Microsoft.
- Na Start kliknij GRAJ — launcher sam pobierze Minecrafta, Javę, Fabric i klienta Lumina.
- W grze: Prawy Shift otwiera menu Lumina, H szybkie akcje.
Windows może pokazać ostrzeżenie SmartScreen przy pierwszym uruchomieniu — kliknij „Więcej informacji” → „Uruchom mimo to”.
Instalacja — serwer
- Pobierz lumina-server.jar.
- Wrzuć do
plugins/serwera Paper 26.3 i zrestartuj serwer. - Nadaj permisje przez LuckPerms (przykłady wyżej).
- Sprawdź komendą
/lumina, kto ma klienta.
Plugin nie wymaga bazy danych. Kary i zgłoszenia zapisuje w folderze pluginu.
Najczęstsze pytania
Czy X-ray i freecam to nie są cheaty?
W Luminie działają tylko w singleplayerze albo gdy serwer sam nada permisję lumina.xray / lumina.freecam. Bez pluginu i permisji na serwerze nie da się ich włączyć. To narzędzia dla administracji do sprawdzania graczy.
Czy potrzebuję kupionego Minecrafta?
Tak, do gry online potrzebne jest konto Microsoft z Minecraft: Java Edition. Konta offline służą do testów na własnych serwerach.
Które wersje Minecrafta są obsługiwane?
Klient Lumina jest zrobiony pod Minecraft 26.3 (Fabric). Sam launcher uruchamia też inne wersje (vanilla i Fabric) — wtedy bez funkcji klienta.
Czy plugin działa na Spigot albo Bukkit?
Plugin jest pisany i testowany pod Paper 26.3. Na forkach Papera (np. Purpur) powinien działać, na czystym Spigocie — nie jest wspierany.
Czy muszę mieć LuckPerms?
Nie. Bez LuckPerms funkcje administracji dostają operatorzy (OP). Z LuckPerms decydujesz dokładnie, kto co może — i wtedy samo OP nic nie daje.
Czy mogę używać Sodium, Iris albo OptiFabric?
Tak. Nowe instancje mają domyślnie Sodium + Iris. W ustawieniach instancji możesz wybrać OptiFabric, jeśli jest dostępny dla danej wersji.
Czy mogę odpalić dwie gry naraz?
Tak — przycisk „Kolejne okno” obok GRAJ uruchamia kolejną kopię gry, na tym samym albo innym koncie.
Co z moimi danymi?
Hasło do konta Microsoft wpisujesz tylko na stronie Microsoftu. Szczegóły w polityce prywatności.
Co dalej
✔ Gotowe
Launcher, klient, HUD, szybkie akcje, give item, WorldEdit CUI, miarka, X-ray, freecam, znajomi i czat, ikonki, panel graczy, kary, vanish, invsee, zgłoszenia, regiony WorldGuard 3D, menu pauzy, aktualizacje, API dla pluginów (własne okna i karty HUD), pakiet tekstur Lumina UI.
W budowie
Oficjalne wsparcie Essentials i CMI w panelu graczy, nadawanie rang LuckPerms z panelu i osobny panel LuckPerms (rangi, permisje, prefiksy, ścieżki awansów).
Pomysły
Masz pomysł na narzędzie dla administracji albo budowniczych? Napisz na 0707.pl.