OPISMacabris Craft – strona i panel sterowania serwerami Minecraft
Autorska strona w PHP 8 i MySQL, bez frameworka, dla wielu serwerów Minecraft. Pokazuje status, wersję gry i obciążenie serwerów na żywo, a administratorzy i moderatorzy zarządzają serwerami z poziomu przeglądarki, przez integrację z Multicraft.
Technologie: PHP 8 (strict types), MariaDB/MySQL (PDO), Multicraft API, JavaScript, CSS, Apache (.htaccess), cron, Virtualmin.
O projekcie
Strona dla społeczności serwerów Minecraft, w pikselowym stylu gry. Publicznie pokazuje serwery, ich status i zasady. Za logowaniem ma rozbudowany panel administracyjny, który zastępuje większość codziennej pracy w panelu Multicraft.
Strona publiczna
• Wiele serwerów na jednej stronie. Każdy ma nazwę, opis, wersję gry, status online i liczbę graczy.
• Zegary CPU i RAM na żywo, pobierane z API Multicraft.
• Przycisk „Kopiuj IP“, lista graczy online, aktualności i regulamin.
• Rejestracja z potwierdzeniem e-mail i logowanie, także hasłem z Multicraft (SSO).
Edycja treści bezpośrednio na stronie
Administrator edytuje teksty, nazwy i opisy serwerów, adresy, aktualności, zasady i stopkę klikając je na stronie, bez wchodzenia w formularze. Zapis idzie przez zabezpieczony endpoint z tokenem CSRF i listą dozwolonych pól. Ustawienia (stopka, kod Matomo, linki SEO, poczta, Multicraft) mają osobny panel z menu bocznym.
Panel „Sterowanie“ (integracja z Multicraft)
• Start, stop i restart serwera, konsola na żywo i czat serwera.
• Zarządzanie graczami, własne komendy i kopie zapasowe.
• Historia graczy: kto wchodził, kiedy i z jakiego IP. Wpisy powstają z logu konsoli, z możliwością zbierania ich cronem. Strona wskazuje IP, z którego grało kilku graczy (możliwe konta alternatywne). Przy wpisach są przyciski BAN, UNBAN, BAN IP i UNBAN IP oraz własne komendy.
• Zapytania do API idą równolegle (curl_multi), a strona działa też bez skonfigurowanego API, pokazując sam status.
Strona „Komendy“ dla administratorów i moderatorów
• Szybkie akcje na graczach online: kick, ban, op/deop, tryb gry, wyczyszczenie ekwipunku, teleport i wiadomość.
• Własne szablony komend ze zmienną {gracz}: administrator zapisuje je raz, a potem uruchamia jednym kliknięciem przy graczu.
• Podgląd czatu serwera i wysyłanie wiadomości do wszystkich graczy.
• Rola moderatora z ograniczonymi uprawnieniami. Op i deop oraz zarządzanie szablonami zostają tylko dla administratora.
• Zabezpieczenia: potwierdzenie przed groźnymi komendami, walidacja nicków i parametrów (nie da się wstrzyknąć drugiej komendy do konsoli) oraz zapis każdego użycia do dziennika.
Moduł bezpieczeństwa
• Dziennik incydentów: logowania, nieudane próby, blokady, odmowy dostępu, błędy CSRF i akcje administratorów.
• Limity prób logowania na adres IP i na konto, automatyczne bany IP i alerty e-mail.
• Wylogowanie po bezczynności i opcjonalne wymuszanie HTTPS.
• Utwardzony .htaccess: biała lista typów plików i blokada katalogów wewnętrznych. Strona bezpieczeństwa ma wbudowany test, który sprawdza z zewnątrz, czy chronione pliki rzeczywiście są niedostępne.
Jakość i wdrożenie
• Baza i tabele migrują się automatycznie przy pierwszym wejściu, więc aktualizacja to samo wgranie plików.
• Instalator pierwszej konfiguracji.
• Testy z użyciem Playwright, skryptów HTTP i atrapy API Multicraft. Sprawdzały logowanie, uprawnienia, CSRF, wstrzykiwanie poleceń, zapis do dziennika i działanie .htaccess na prawdziwym Apache. Przeszły wszystkie, ale środowisko testowe było lokalne, nie produkcyjne.
Czego się nauczyłem / co było wyzwaniem
• Integracja z zewnętrznym API (podpisywanie żądań HMAC, różne formaty odpowiedzi) i równoległe zapytania, żeby panel nie wiązał się na wolnych odpowiedziach.
• Projektowanie uprawnień z kilkoma rolami i bezpieczne wysyłanie komend do konsoli serwera.
• Śledzenie incydentów: logowanie zdarzeń tak, żeby dziennik był użyteczny, a nigdy nie przewracał strony.
Macabris Craft – strona i panel sterowania serwerami Minecraft
Autorska strona w PHP 8 i MySQL, bez frameworka, dla wielu serwerów Minecraft. Pokazuje status, wersję gry i obciążenie serwerów na żywo, a administratorzy i moderatorzy zarządzają serwerami z poziomu przeglądarki, przez integrację z Multicraft.
Technologie: PHP 8 (strict types), MariaDB/MySQL (PDO), Multicraft API, JavaScript, CSS, Apache (.htaccess), cron, Virtualmin.
O projekcie
Strona dla społeczności serwerów Minecraft, w pikselowym stylu gry. Publicznie pokazuje serwery, ich status i zasady. Za logowaniem ma rozbudowany panel administracyjny, który zastępuje większość codziennej pracy w panelu Multicraft.
Strona publiczna
- Wiele serwerów na jednej stronie. Każdy ma nazwę, opis, wersję gry, status online i liczbę graczy.
- Zegary CPU i RAM na żywo, pobierane z API Multicraft.
- Przycisk „Kopiuj IP“, lista graczy online, aktualności i regulamin.
- Rejestracja z potwierdzeniem e-mail i logowanie, także hasłem z Multicraft (SSO).
Edycja treści bezpośrednio na stronie
Administrator edytuje teksty, nazwy i opisy serwerów, adresy, aktualności, zasady i stopkę klikając je na stronie, bez wchodzenia w formularze. Zapis idzie przez zabezpieczony endpoint z tokenem CSRF i listą dozwolonych pól. Ustawienia (stopka, kod Matomo, linki SEO, poczta, Multicraft) mają osobny panel z menu bocznym.
Panel „Sterowanie“ (integracja z Multicraft)
- Start, stop i restart serwera, konsola na żywo i czat serwera.
- Zarządzanie graczami, własne komendy i kopie zapasowe.
- Historia graczy: kto wchodził, kiedy i z jakiego IP. Wpisy powstają z logu konsoli, z możliwością zbierania ich cronem. Strona wskazuje IP, z którego grało kilku graczy (możliwe konta alternatywne). Przy wpisach są przyciski BAN, UNBAN, BAN IP i UNBAN IP oraz własne komendy.
- Zapytania do API idą równolegle (curl_multi), a strona działa też bez skonfigurowanego API, pokazując sam status.
Strona „Komendy“ dla administratorów i moderatorów
- Szybkie akcje na graczach online: kick, ban, op/deop, tryb gry, wyczyszczenie ekwipunku, teleport i wiadomość.
- Własne szablony komend ze zmienną {gracz}: administrator zapisuje je raz, a potem uruchamia jednym kliknięciem przy graczu.
- Podgląd czatu serwera i wysyłanie wiadomości do wszystkich graczy.
- Rola moderatora z ograniczonymi uprawnieniami. Op i deop oraz zarządzanie szablonami zostają tylko dla administratora.
- Zabezpieczenia: potwierdzenie przed groźnymi komendami, walidacja nicków i parametrów (nie da się wstrzyknąć drugiej komendy do konsoli) oraz zapis każdego użycia do dziennika.
Moduł bezpieczeństwa
- Dziennik incydentów: logowania, nieudane próby, blokady, odmowy dostępu, błędy CSRF i akcje administratorów.
- Limity prób logowania na adres IP i na konto, automatyczne bany IP i alerty e-mail.
- Wylogowanie po bezczynności i opcjonalne wymuszanie HTTPS.
- Utwardzony .htaccess: biała lista typów plików i blokada katalogów wewnętrznych. Strona bezpieczeństwa ma wbudowany test, który sprawdza z zewnątrz, czy chronione pliki rzeczywiście są niedostępne.
Jakość i wdrożenie
- Baza i tabele migrują się automatycznie przy pierwszym wejściu, więc aktualizacja to samo wgranie plików.
- Instalator pierwszej konfiguracji.
- Testy z użyciem Playwright, skryptów HTTP i atrapy API Multicraft. Sprawdzały logowanie, uprawnienia, CSRF, wstrzykiwanie poleceń, zapis do dziennika i działanie .htaccess na prawdziwym Apache. Przeszły wszystkie, ale środowisko testowe było lokalne, nie produkcyjne.
Czego się nauczyłem / co było wyzwaniem
- Integracja z zewnętrznym API (podpisywanie żądań HMAC, różne formaty odpowiedzi) i równoległe zapytania, żeby panel nie wiązał się na wolnych odpowiedziach.
- Projektowanie uprawnień z kilkoma rolami i bezpieczne wysyłanie komend do konsoli serwera.
- Śledzenie incydentów: logowanie zdarzeń tak, żeby dziennik był użyteczny, a nigdy nie przewracał strony.