docs: własny modpack spoza listy (tydzień 2)

[iipanda]

Co to jest

Nowy poradnik docs (tydzień 2): Własny modpack spoza listy (docs/modpacki/wlasny-modpack.md, slug /modpacki/wlasny-modpack). Uczy, jak postawić na serwerze voxelhost modpack, którego nie ma w wbudowanym instalatorze, na podstawie jego server packa: pobranie server packa (nie client packa), wybór silnika i wersji w panelu, wgranie plików przez FTP, wymagania RAM i pierwszy (dłuższy) start. Zawiera sekcję częstych problemów (zły loader/wersja, mody client-only wywalające serwer, za mało RAM).

Utworzono tylko ten jeden plik. Sidebar zostaje nietknięty (kategoria modpacki powstaje w PR tygodnia 1 / w restrukturyzacji sidebaru z Phase 0); plik ma sidebar_position: 2.

Źródła (tylko realne, zweryfikowane)

Fakty o panelu pochodzą z kodu dashboardu (~/Desktop/voxelhost-dashboard) oraz z konwencji repo infrastruktury:

• Nawigacja serwera (Konsola / Pliki / Modpacki / Ustawienia / Backupy): app/routes/server.tsx:231-241.
• Zmiana silnika i wersji po zakupie (Forge/Fabric/NeoForge/Paper/Purpur/Vanilla + wybór wersji; brak wgrywania dowolnego .jar): app/modules/settings/components/change-version-modal.tsx (typy: linie 114-144; ostrzeżenie "wyłączenie serwera": 89-91; wariant modpack-managed: 95-109) oraz sekcja "Silnik" w app/routes/server/$serverId/settings.tsx:794-826.
• FTP (sftp://ftp.voxelhost.pl, port 22, "Wygeneruj nowe dane", dane pokazane tylko raz): app/modules/settings/components/ftp-settings-section.tsx:9-38 i app/modules/settings/components/ftp-details-modal.tsx:25-69.
• Menedżer plików (route /server/:id/files, limit 50 MB/plik z komunikatem kierującym na FTP, "Wypakuj .zip", "Prześlij pliki/folder", "Formatuj serwer"): app/routes/server/$serverId/files/$.tsx, app/modules/file-manager/views/directory-view.tsx (limit + komunikat FTP; kontekstowe menu 672-694; formatowanie 115-138) i app/modules/file-manager/components/entry.tsx (unzip).
• RAM zależny od planu ("Zmień plan"): app/routes/server/$serverId/settings.tsx:628-654.
• Wbudowany instalator modpacków (route /server/:id/modpacks, "Instalacja wymaże wszystkie pliki serwera"): app/routes/server/$serverId/settings.tsx:840-856 (temat PR tygodnia 1).
• Ton i konwencje: istniejące docs/tutorial/start.md i docs/tutorial/fastlogin.md; konwencje marki/em-dash z repo infrastruktury.

Placeholdery na screenshoty (<!-- [screenshot: ...] -->)

Do dorobienia na panelu voxelhost przed publikacją:

1. Strona modpacka na CurseForge z zaznaczonym plikiem Server Pack.
2. Ustawienia > Konfiguracja serwera: karta Silnik + okno "Zmień silnik" (wybór Forge/Fabric/NeoForge).
3. Ustawienia > FTP: host sftp://ftp.voxelhost.pl, port 22, przycisk "Wygeneruj nowe dane".
4. WinSCP/FileZilla z wgranym folderem mods/ w głównym katalogu serwera.
5. Zakładka Konsola podczas pierwszego startu modpacka.

TODO(karol) do zweryfikowania

1. Czy przy wybranej wersji Minecraft panel instaluje konkretny build loadera automatycznie, czy można wybrać dokładny build (np. Forge 47.3.0). Ważne, gdy modpack wymaga ściśle określonego builda; jeśli listy buildów nie ma, dopisać, żeby napisać do supportu.
2. Orientacyjne minimum RAM per rozmiar modpacka (widełki, np. lekki ~4 GB, duży ~8 GB+).

Weryfikacja

• yarn build przechodzi (Node 24 + NODE_OPTIONS=--openssl-legacy-provider), bez błędów broken-links (onBrokenLinks: throw).
• Route obecny w outputcie: build/modpacki/wlasny-modpack/index.html (tytuł i H1 renderują się).
• Linki: ../tutorial/start.md rozwiązuje się (walidowany przy buildzie). Linki krzyżowe do artykułu tygodnia 1 (/modpacki/jak-zainstalowac-modpacka) i do bloga (curseforge-vs-modrinth-porownanie) podane jako pełne URL-e, żeby nie wywalić buildu; będą zwracać 404 do czasu merge odpowiednich PR-ów (tydzień 1 docs + blog brief 11).
• Body ~749 słów (cel 500-900), description 150 znaków (cel 140-160).
• Bez em dashy, marka pisana małymi literami "voxelhost", bez zmian w yarn.lock.

Harmonogram merge

Merge schedule: week 2, together with website blog PR (brief 11: CurseForge vs Modrinth) oraz PR docs tygodnia 1 (instalator modpacków). Linki krzyżowe zaczną działać po ich zmergowaniu.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0781c8c092

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Add the guide to the manual sidebar

Because the current sidebars.js enumerates docs manually (intro plus the existing tutorial/... pages) rather than using an autogenerated sidebar, this sidebar_position value is ignored. If this commit is deployed as-is, /modpacki/wlasny-modpack can render at its direct URL but will not be reachable from the docs navigation, so users browsing the knowledge base cannot discover the new guide; add a sidebar entry/category or switch the relevant section to autogenerated before publishing it.

Useful? React with 👍 / 👎.

[iipanda]

Added panel screenshots for 3 of the 5 placeholders: engine picker modal ("Zmień silnik"), FTP settings section, and Konsola during first start. Two remain unfilled and need the article owner: the CurseForge server-pack-file screenshot (Cloudflare's bot challenge blocks automated browser access to curseforge.com) and the WinSCP/FileZilla screenshot (desktop app, not capturable in-browser). Build verified locally (docusaurus build exit 0, images present in output).