Przejdź do treści
alekajiya
Otwórz menu
Wszystkie projekty

mycave.pl: serwery Minecraft i ich portal

5 min czytaniaStrona Internetowa

Trzy światy Minecrafta w domowym homelabie i strona, która pokazuje ich status na żywo, mapy, zasady i podpowiada, jak dołączyć. Do tego jeden czat dla gry i Discorda oraz własny szablon PufferPanel dla paczek z CurseForge.

Technologie

  • Astro
  • TypeScript
  • Tailwind v4
  • DaisyUI
  • BlueMap
  • PufferPanel
  • NeoForge / Paper / Forge
  • Discord
  • Docker

mycave.pl to moje serwery gier, które działają od 2012 roku. Dziś są to trzy światy Minecrafta dla rodziny i znajomych, każdy z innym charakterem. Do kompletu brakowało jednego miejsca, w którym widać, co działa, jak dołączyć i jakie panują zasady.

Tak powstał portal mycave.pl. Serwery stoją w moim domowym homelabie, a strona jest ich wizytówką i tablicą ogłoszeń. Skąd w ogóle wziął się pomysł na własne serwery, opisałem we wpisie na blogu Własny serwer Minecraft dla dzieci: wspomnienie po latach.

Strona główna mycave.pl w ciemnym motywie: hasło Wiele światów. Jedna jaskinia. na tle krajobrazu z Minecrafta i trzy karty serwerów Create+, Tom20Plus i ATM Gravitas² ze statusem online i liczbą graczy(powiększ)
Strona główna mycave.pl

Trzy światy, trzy silniki

Każdy serwer jest dla innego typu gracza i każdy działa na innym oprogramowaniu:

  • Create+ to modpack na NeoForge (Minecraft 1.21.1, ponad 100 modów) zbudowany wokół moda Create: przekładnie, tory i maszyny budowane własnymi rękami. Teren generują Terralith i Tectonic, więc góry i doliny wyglądają dużo ciekawiej niż w zwykłej grze,
  • Tom20Plus to spokojny świat na Paper (Minecraft 1.21.10), do którego wchodzi się zwykłym klientem. Pluginy pilnują porządku: CoreProtect zapisuje każdą zmianę i pozwala cofnąć zniszczenia, LuckPerms trzyma role, a WorldEdit i Axiom pomagają budowniczym,
  • ATM Gravitas² to ekspercki modpack na Forge (Minecraft 1.20.1, ponad 230 modów). Zaczyna się od łupania krzemienia w świecie TerraFirmaCraft, a kończy rakietą i lotem na inną planetę.

Wszystkie trzy działają na jednym serwerze w domu i są zarządzane przez PufferPanel. Panel daje konsolę, kopie zapasowe i restart z przeglądarki, bez logowania się na serwer.

Kamienna wieża oplątana pnączami wśród sawanny z płaskimi koronami drzew, świat serwera Create+ z generatorem Terralith(powiększ)
Świat Create+ z generatorem terenu Terralith

Co potrafi strona

Portal ma być prosty dla dziecka, które pierwszy raz dołącza do serwera, i przydatny dla stałego gracza:

  • status każdego serwera na żywo: online albo offline, liczba graczy, wersja gry i silnik,
  • sekcja „Jak dołączyć”: adres do skopiowania jednym przyciskiem i informacja, jakiego klienta potrzebuje dany świat,
  • osobna podstrona dla każdego serwera z opisem świata, listą najważniejszych modów i galerią zrzutów ekranu,
  • mapa świata na żywo w przeglądarce, z pozycjami graczy,
  • aktualności pisane w zwykłych plikach Markdown,
  • regulamin i kontakt do administratora w jednym miejscu.
Dwie podstrony serwerów obok siebie: Create+ z pomarańczowym akcentem i wieżą wśród drzew oraz ATM Gravitas² z fioletowym akcentem i deszczowym lasem, pod każdą pasek ze statusem, liczbą graczy, wersją gry, silnikiem i adresem(powiększ)
Podstrony serwerów Create+ i ATM Gravitas²

Status bez dodatkowych portów

Dane o serwerze strona pobiera tym samym zapytaniem, którego używa gra na liście serwerów (Server List Ping). Nie trzeba włączać na serwerach ani RCON, ani protokołu query, więc nie otwieram niczego więcej niż sam port gry.

Zapytanie wykonuje serwer strony, a przeglądarka odpytuje tylko jego własny adres. Dzięki temu karta odświeża się co chwilę, a odwiedzający nie łączy się bezpośrednio z serwerem gry.

Mapa, która rozumie mody

Mapy na żywo rysuje BlueMap. Wybrałem go zamiast popularnego Dynmapa, bo Dynmap nie rozpoznaje bloków z modów i w modowanym świecie pokazuje czarne dziury. BlueMap czyta modele bloków prosto z plików modów, więc na mapie Create+ widać maszyny i budowle tak, jak w grze.

Sekcja Jak dołączyć: adresy trzech serwerów z przyciskami kopiowania, wymagania klienta dla każdego świata i odnośniki do map na żywo(powiększ)
Sekcja Jak dołączyć

Jeden czat dla gry i Discorda

Gracze rozmawiają na wspólnym kanale Discorda. Wiadomości z gry trafiają na Discord i odwrotnie, więc da się umówić na wspólne granie bez uruchamiania Minecrafta. Każdy silnik wymagał innego mostu: na Create+ działa Viscord, a na Tom20Plus EssentialsXDiscord.

Zasady w jednym miejscu

Regulamin jest krótki i obowiązuje na wszystkich serwerach i na Discordzie. Zakazuje oszukiwania, wyzwisk i niszczenia cudzych budowli. Przypomina też, że każda zmiana w świecie jest zapisywana, więc niszczenie zawsze wyjdzie na jaw.

Tom20Plus ma ograniczenie wieku 16+. Młodsi gracze mają swoje miejsce na pozostałych serwerach.

Strona Administracja z siedmioma punktami regulaminu wspólnymi dla wszystkich serwerów, kontaktem do administratora i informacją, że Tom20Plus jest dla graczy 16+(powiększ)
Regulamin i kontakt do administratora

Wygląd: piksel, ale czytelnie

Strona nawiązuje do gry, ale nie udaje jej interfejsu. Krawędzie sekcji są „schodkowe” jak bloki, adresy i wersje są pisane krojem pikselowym, a każdy serwer ma swój kolor: pomarańczowy, zielony i fioletowy.

  • motyw jasny, ciemny albo systemowy, wybierany jednym kliknięciem,
  • wersja polska i angielska od pierwszego dnia, a nie dopisywana później,
  • układ działa na telefonie, a menu da się obsłużyć klawiaturą,
  • link „Przejdź do treści” i opisy alternatywne zrzutów ekranu,
  • mapa witryny, adresy kanoniczne i dane strukturalne, żeby wyszukiwarki dobrze pokazywały podstrony.
Strona główna mycave.pl w jasnym motywie na komputerze oraz wersja na telefon z menu w postaci przycisku i kartami serwerów pod hasłem(powiększ)
Jasny motyw i wersja na telefon

Za kulisami serwerów

Najwięcej pracy nie było przy stronie, tylko przy samych serwerach. Kilka rzeczy, które warto zapamiętać:

  • panel po instalacji NeoForge uruchamiał zwykły plik serwera Mojanga zamiast właściwego startu NeoForge. Serwer się włączał, ale gra odrzucała połączenie. Pomogło usunięcie tego pliku z drogi, żeby panel wybrał poprawną ścieżkę startu,
  • jeden mod w paczce był błędnie oznaczony jako serwerowy i wywracał serwer przy starcie. Wystarczyło przenieść go do osobnego katalogu,
  • paczki z CurseForge, takie jak ATM Gravitas², nie zawierają Forge’a i panel nie umiał go doinstalować. Napisałem własny szablon PufferPanel, który sam rozpoznaje loader (Forge, NeoForge albo Fabric), instaluje go i ustawia poprawną komendę startu,
  • na Macu klient ATM Gravitas² wywracał się na ekranie ładowania. Winny był czysto wizualny mod z zorzą polarną, którego shadery nie działają na macOS. Po jego wyłączeniu gra działa, a serwer nie wymagał żadnych zmian.

Strona i mapy są wystawione przez reverse proxy z certyfikatami Let’s Encrypt. Więcej o samym serwerze w domu piszę we wpisie Homelab: własna chmura w domu.

Co dalej

  • lista graczy online prosto z map i statystyk serwerów, a nie tylko z odpowiedzi serwera,
  • mapa webowa dla ATM Gravitas², który na razie ma tylko mapę w grze,
  • więcej zrzutów ekranu i wpisów o tym, co powstaje w naszych światach.

Stack

  • Astro (SSR na Node) z TypeScriptem, Tailwind v4, DaisyUI, Lucide,
  • i18n PL/EN, treści aktualności w Markdown (content collections),
  • Server List Ping jako źródło statusu, BlueMap jako mapy na żywo,
  • PufferPanel z własnym szablonem dla paczek CurseForge,
  • NeoForge, Paper i Forge, Viscord i EssentialsXDiscord jako most do Discorda,
  • Docker w domowym homelabie, Nginx Proxy Manager i Let’s Encrypt.

Nowe teksty na maila

Raz na jakiś czas, gdy pojawi się nowy wpis albo projekt. Bez reklam.

Komentarze

Jeszcze nikt nie skomentował. Możesz być pierwszy.

Kliknij albo przewiń, żeby przybliżyć. Przeciągnij, żeby przesunąć.Stuknij dwa razy albo rozsuń palce, żeby przybliżyć.

Inne projekty

Rejestr prawa lokalnego: pięć tysięcy aktów w jednej wyszukiwarce

Zarządzenia i uchwały były rozrzucone po BIP, paczkach z EZD, dysku sieciowym i archiwum. Zbudowałem rejestr, który łączy te źródła, pokazuje status aktu, podpis elektroniczny i publikację w Dzienniku Urzędowym, a do tego wskazuje luki w numeracji.

Panel SMS: powiadomienia wysyłane z przeglądarki

Nakładka WWW na moją bramkę SMS: wysyłka do numerów, kontaktów i grup, wysyłka zaplanowana, rozmowy, wspólna skrzynka i zapisy na powiadomienia z potwierdzeniem kodem SMS. Jeden kod działa w dwóch instancjach, każda z własną kartą SIM i wyglądem.

Własna bramka SMS: modem GSM, dwie karty i API dla wielu systemów

Moje systemy wysyłają SMS-y o przerwanych transmisjach, awariach tablic i zmianach w kopiach zapasowych. Zamiast płacić za komercyjną bramkę, zbudowałem własną: modem Quectel M95, dwie karty SIM, API w Pythonie, podpisane webhooki, raporty doręczenia i panel z logowaniem dwuetapowym.