Skip to content
alekajiya
Open menu
All projects

mycave.pl: serwery Minecraft i ich portal

5 min readStrona 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.

Technologies

  • 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(enlarge)
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(enlarge)
Ś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(enlarge)
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(enlarge)
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+(enlarge)
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(enlarge)
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.

Was this useful?

New posts by e-mail

Every now and then, when a new post or project goes up. No ads.

Got an idea, a question or a comment? Write to me:Enable JavaScript to see the e-mail address

Comments

No comments yet. Be the first.

Click or scroll to zoom in. Drag to move around.Double tap or pinch to zoom in.

More projects

Local law register: five thousand acts in one search engine

Orders and resolutions were scattered across the BIP public information bulletin, signed packages from the document management system, a network drive and a paper archive. I built a register that joins these sources, shows each act's status, electronic signature and Official Journal publication, and points out gaps in the numbering.

SMS panel: notifications sent from the browser

A web front end for my SMS gateway: sending to numbers, contacts and groups, scheduled sending, conversations, a shared inbox and notification sign-ups confirmed with an SMS code. One codebase runs as two instances, each with its own SIM card and look.

My own SMS gateway: a GSM modem, two SIM cards and an API for many systems

My systems send text messages about interrupted streams, failing information boards and changes spotted by backups. Instead of paying for a commercial gateway, I built my own: a Quectel M95 modem, two SIM cards, a Python API, signed webhooks, delivery reports and a panel with two-factor login.