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
17modułów HUD
31permisji do LuckPerms
8skrótów klawiszowych
🛠️
Klient w grze
Nowoczesne albo klasyczne menu główne i menu pauzy (do wyboru), własny wybór świata, lista serwerów i ustawienia z wyszukiwarką, 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 — 17 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)
- Redstone — siła sygnału, moc pyłu nad kablem, opóźnienie przekaźników, tryb komparatora
- Tłok — co przesunie (limit 12), co zniszczy i który blok go blokuje, z podglądem 3D
- TNT — podpalone TNT w promieniu 96 m, odliczanie nad każdym i zasięg wybuchu
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 - Rangi LuckPerms — nadawanie i zabieranie jednym kliknięciem, na czas (
30d) i na wybrany świat - Essentials i CMI — kary trafiają do ich systemów; nick, AFK, więzienie, god, fly, saldo, kasa i domy gracza z teleportem
lumina.admin.luckperms
Panel LuckPerms w grze
Zarządzanie rangami bez wpisywania komend /lp. Otwierasz go z menu pauzy albo z panelu graczy.
- Lista rang z prefiksami i wagami, liczba graczy w każdej randze
- Waga, prefiks, sufiks i dziedziczenie — zmiana jednym „Zapisz”
- Permisje z wyszukiwarką: dodawanie (także czasowe, np. na 7 dni) i usuwanie
- Także w launcherze (Admin → Panel LuckPerms): zarządzanie rangami bez wchodzenia do gry — serwer łączy się z Lumina Network sam, bez otwierania portów; kod serwera z
/lumina kod - Tworzenie i usuwanie rang; bezpiecznik: kto ma tylko
lumina.admin.ranks, nada wyłącznie rangi niższe niż własna
Launcher · lumina.admin.map
Mapa serwera w launcherze
Podgląd serwera bez wchodzenia do gry: teren narysowany jak mapa w Minecrafcie i gracze na żywo. Działa przez Lumina Network — ten sam kod serwera co panel LuckPerms, bez otwierania portów.
- Gracze z głową i nickiem, kierunek patrzenia, współrzędne, HP i tryb gry — odświeżane co 2 s
- Śledzenie gracza jednym kliknięciem, przełączanie światów (Świat, Nether, End), spawn
- Przesuwanie myszką, przybliżanie kółkiem, współrzędne pod kursorem, TPS serwera
- Teren tylko z załadowanych chunków — mapa niczego nie wczytuje ani nie generuje, więc nie obciąża serwera
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.lag · CoreProtect
Wyszukiwarka lagów i CoreProtect
Gdy TPS spada, od razu widzisz, gdzie jest problem — i możesz się tam przenieść jednym kliknięciem.
- Najcięższe chunki: liczba bytów, bloków z danymi i lejów, najczęstsze byty w chunku
- Najczęstsze byty na całym serwerze i stan każdego świata
- TP do chunka i Usuń itemy — leżące itemy, kulki XP i strzały (mobów nie rusza)
- Z CoreProtect: w karcie celownika „Postawił / Zniszczył: Nick · 2 h temu”, a w panelu graczy cofanie zmian gracza (czas i promień)
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 WGMiarkaRedstoneTłokTNTX-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.
Skórki 3D
Podgląd postaci w 3D, zmiana skina z pliku (model Steve/Alex), powrót do domyślnego i wybór peleryny — dla kont premium.
Modpacki .mrpack
Import modpacków z Modrinth jednym kliknięciem — wersja gry, Fabric, mody (z kontrolą sum) i konfiguracja.
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.chat | nikt | Czat serwera w launcherze — podgląd i wysyłanie wiadomości |
lumina.skin | wszyscy | /skorka <nick> — skórka z konta premium na serwerze offline (też z launchera) |
lumina.admin.map | nikt | Mapa serwera w launcherze — teren i gracze na żywo (bez LuckPerms: operatorzy) |
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 |
| Lagi i CoreProtect | ||
lumina.admin.lag | nikt | Wyszukiwarka lagów: najcięższe chunki, najczęstsze byty, teleport i czyszczenie leżących itemów |
lumina.admin.coreprotect | nikt | Kto postawił / zniszczył blok (w karcie celownika) i cofanie zmian gracza (wymaga CoreProtect) |
| Essentials / CMI | ||
lumina.admin.extras | nikt | Ulecz, nakarm, fly, god i nick gracza |
lumina.admin.jail | nikt | Więzienie: wsadź (także na czas) i uwolnij |
lumina.admin.economy | nikt | Saldo gracza, daj / zabierz / ustaw kasę |
lumina.admin.homes | nikt | Domy gracza z teleportem jednym kliknięciem |
| LuckPerms | ||
lumina.admin.ranks | nikt | Nadawanie i zabieranie rang w panelu graczy — także czasowo i na świat. Tylko rangi o niższej wadze niż własna. |
lumina.admin.luckperms | nikt | Pełny panel LuckPerms: rangi, permisje, prefiksy, sufiksy, wagi, dziedziczenie; dowolne rangi w panelu graczy |
| 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, EssentialsX albo CMI, CoreProtect.
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ć.
Nowoczesne menu
Nowoczesna pauza
Wybór świata
Ustawienia
Menu klasyczne
Menu pauzy
Moduły HUD
Edytor HUD
Szybkie akcje
Give item
Itemy specjalne
Karta celownika
WorldEdit
Miarka i X-ray
Freecam
Panel graczy
Podgląd ekwipunku
Rangi gracza
Panel LuckPerms
Wyszukiwarka lagów
Zgłoszenia
Powiadomienie o zgłoszeniu
Regiony WorldGuard
TAB z ikonkami
Ustawienia w stylu Lumina
Ustawienia grafiki
Launcher — mody
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.
Serwery z Lumina
Serwery z pluginem LuminaServer, które same zgłosiły się na listę. Liczba graczy odświeża się co minutę.
Wczytuję listę…
Masz serwer z pluginem? W plugins/LuminaServer/config.yml ustaw
network.public-listing.enabled: true i address, a potem zrestartuj serwer.
Co dalej
✔ Gotowe
Launcher, klient, nowy HUD i ekwipunek, nowoczesne menu, ustawienia i lista serwerów, zoom, panel graczy i kary, zgłoszenia, regiony WorldGuard 3D, rangi i panel LuckPerms, Essentials i CMI, wyszukiwarka lagów, CoreProtect, mapa serwera, czat i zgłoszenia w launcherze, skórki na serwerach offline, harmonogram restartów, synchronizacja ustawień, zrzuty dla znajomych, tryb widza admina, lista serwerów.
W budowie
Edycja zrzutów ekranu, skórki z pliku, kolejne integracje z pluginami — pełna lista w launcherze (Pomysły).
Pomysły
Masz pomysł? W launcherze kliknij żarówkę → „Zgłoś pomysł” i głosuj na pomysły innych graczy.