docs: reset świata, Netheru i Endu (tydzień 4)

[iipanda]

Co to jest

Poradnik krok po kroku (tydzień 4): Jak zresetować świat (oraz Nether i End).

• Plik: docs/swiat/reset-swiata.md
• Slug/route: /swiat/reset-swiata
• Frontmatter: title, description (150 znaków), keywords, slug, sidebar_position: 1
• Język: polski, marka lowercase voxelhost, bez em dashy, ~810 słów.
• 5 zrzutów ekranu z panelu (paleta + oba kroki dialogu + Pliki + Ustawienia FTP).

Ścieżka główna to wbudowana akcja panelu Zresetuj świat (paleta poleceń, dwa kroki), z ręcznym resetem przez menedżer plików i FTP jako uzupełnieniem.

Zweryfikowane na żywym panelu (aktualizacja)

Po sesji zrzutów na prawdziwym serwerze (Paper, aktualny MC) poprawiłem dwie rzeczy:

1. Układ świata. Serwer NIE ma osobnych folderów world_nether/world_the_end. W głównym katalogu jest tylko world, a wymiary są zagnieżdżone w środku (na aktualnym MC: world/dimensions/minecraft/the_nether i .../the_end; na starszych world/DIM-1 i world/DIM1). Potwierdzają to: zrzut pliki-world.png (jeden folder world, brak nether/end na górnym poziomie) oraz zrzut planu akcji reset-dialog-krok2.png (world = "Istnieje • 7 elementów", world_nether/world_the_end = "Nie istnieje"). Artykuł prowadzi teraz układem zagnieżdżonym, a osobne foldery zostawia jako wariant dla starszych wersji/wgranych światów, i każe czytelnikowi sprawdzić zakładkę Pliki.
2. Dialog w dwóch krokach. Reset to dwa ekrany: (1) checkbox "Utwórz backup przed resetem" + "Pokaż plan", (2) podsumowanie operacji + pole "Wpisz RESET ŚWIATA, aby potwierdzić" + "Wykonaj akcję". Kroki w tekście i zrzuty (reset-dialog-krok1.png, reset-dialog-krok2.png) to odzwierciedlają.

Dlaczego układ zagnieżdżony na serwerze Paper: mc-image/scripts/start-setupWorld reorganizuje wymiary do osobnych folderów Spigota tylko przy WGRYWANYM świecie (gałąź FAMILY = SPIGOT, linie ~118-123). Świeżo wygenerowany świat zachowuje więc natywny, zagnieżdżony układ silnika - stąd pojedynczy world na żywym serwerze.

Źródła (weryfikacja dokładności, nie zmyślona UI)

• Backend voxelhost-backend/src/server-actions/server-actions.registry.ts: akcja server.resetWorld zaimplementowana i zarejestrowana (SERVER_ACTION_IDS), bez feature flagi; title: "Zresetuj świat", potwierdzenie typed_phrase frazą RESET ŚWIATA, opcja createBackupFirst domyślnie true; plan: (backup) -> stop -> usunięcie folderów -> start.
• Backend .../server-action-files.service.ts: RESET_WORLD_PATHS = ["world","world_nether","world_the_end"] (hardcoded, pomija nieistniejące); nie czyta level-name -> stąd sekcja o serwerach z nietypową nazwą świata.
• Panel (zrzuty): paleta-reset.png (paleta "Akcje serwera" > "Zresetuj świat"), reset-dialog-krok1/2.png (dwa kroki), pliki-world.png (zakładka Pliki, jeden world), ustawienia-ftp.png (host sftp://ftp.voxelhost.pl, port 22, "Wygeneruj nowe dane").
• mc-image scripts/start-setupWorld (mechanizm układu wymiarów, opis wyżej).
• Fakty ogólne Minecraft: układy wymiarów (zagnieżdżony vs osobne foldery).

Zrzuty ekranu

Wszystkie 5 zrzutów jest już w repo (commit "docs: add panel screenshots") i wstawionych w treści - nie zostały żadne placeholdery na screeny.

TODO do potwierdzenia (<!-- TODO(karol): ... -->)

1. Dokładna nazwa i lokalizacja akcji "Formatuj serwer" w panelu (artykuł ostrzega, że to NIE jest reset świata - kasuje wszystko). To jedyny pozostały TODO; skrót palety, dialog i dane FTP są już potwierdzone zrzutami.

Weryfikacja

• yarn install --frozen-lockfile - bez zmian w yarn.lock.
• yarn build - przechodzi (onBrokenLinks: throw; wewnętrzny link do ../tutorial/start.md się rozwiązuje; linki voxelhost.pl są zewnętrzne).
• Route /swiat/reset-swiata obecny w buildzie; wszystkie 5 obrazów obecnych w build/img/swiat/.
• Bez em dashy, marka lowercase.

Uwagi

• FTP host potwierdzony: panel pokazuje sftp://ftp.voxelhost.pl, port 22 (Ustawienia > FTP) - to rozstrzyga wcześniejszą wątpliwość ftp vs sftp.voxelhost.pl na korzyść ftp.voxelhost.pl.
• Link do sparowanego bloga voxelhost.pl/blog/backup-serwera-minecraft będzie 404 do czasu mergu briefu 16; zaznaczone w treści.

Harmonogram mergu

Tydzień 4, razem z PR bloga na stronie (brief 16). Cross-link publikujemy w dniu publikacji obu artykułów.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e9e0830dae

ℹ️ 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 new article to the manual sidebar

This frontmatter does not make the page discoverable in the site navigation because this repo uses an explicit sidebars.js (docs contains only intro and the tutorial/... items), so sidebar_position is ignored here. The route can still be built, but users browsing the docs sidebar will not find this new /swiat/reset-swiata guide unless the doc is added to the manual sidebar config.

Useful? React with 👍 / 👎.

[iipanda]

Added panel screenshots for all 4 placeholders (action palette, the two-step reset confirmation dialog, the Pliki root listing, and FTP settings).

Important content mismatch found, not fixed here (needs the article owner's decision): on the current voxelhost test server (Paper 26.1.2), the file manager does NOT show separate world_nether / world_the_end top-level folders as this article assumes throughout (lines ~37, 57-60, 81). Nether/End data is nested inside world/dimensions/minecraft/the_nether and world/dimensions/minecraft/the_end instead - a third folder layout beyond the two the article already documents (Paper's world_nether/world_the_end vs vanilla's world/DIM-1/world/DIM1). The in-panel "Zresetuj świat" confirmation dialog itself reflects this: its file-deletion plan lists world_nether and world_the_end as "Nie istnieje" (does not exist) and only world as existing. The full-server reset likely still works correctly (deleting world removes the nested dimension folders too), but the "Reset tylko Netheru lub tylko Endu" instructions (manually deleting world_nether/world_the_end) would not find those folders on this engine/version, and the "Który układ masz?" detection guidance doesn't mention this third layout. Screenshot for the file-manager placeholder shows what's actually there (world only) rather than the three folders the placeholder text described.

Also: the reset confirmation is a two-step dialog (checkbox screen, then a "Pokaż plan" screen with the phrase field), not a single dialog as the original placeholder assumed - I split it into two screenshots to match.

Build verified locally (docusaurus build exit 0, images present in output).

[iipanda]

Resolving the last TODO: "Formatuj serwer" location was verified in the same live-panel session (and corrected in PR #25): it lives in the Pliki tab's "Więcej opcji" dropdown menu, not a right-click context menu. The article's danger warning can reference that location; the TODO comment can be dropped on next touch.