Skip to content

docs: OP, whitelista i bany (tydzień 7)#27

Open
iipanda wants to merge 2 commits into
masterfrom
codex/docs-op-whitelista-bany
Open

docs: OP, whitelista i bany (tydzień 7)#27
iipanda wants to merge 2 commits into
masterfrom
codex/docs-op-whitelista-bany

Conversation

@iipanda

@iipanda iipanda commented Jul 6, 2026

Copy link
Copy Markdown
Member

Cel

Nowy artykuł bazy wiedzy (docs.voxelhost.pl) na tydzień 7: OP, whitelista i bany (podstawy uprawnień administracyjnych i kontroli dostępu). Jeden plik docs/administracja/op-whitelista-bany.md, kategoria administracja pochodzi z phase-0 (PR #26).

Zawartość

  • Uprawnienia operatora: op / deop z konsoli (bez wchodzenia do gry), poziomy 1-4, op-permission-level (domyślnie 4), OP vs systemy uprawnień pluginów (LuckPerms, przyszły artykuł).
  • Whitelista: on / off / add / remove / list / reload + zachowanie enforce-whitelist.
  • Bany: ban, ban-ip, banlist, pardon, pardon-ip, kick; ban vs whitelista (serwer zamknięty vs otwarty).
  • Zarządzanie z zakładki Konsola przed pierwszym dołączeniem gracza.
  • Najczęstsze problemy (whitelista wyłączona, ban po nicku na non-premium, whitelista po nicku na non-premium, za niski poziom OP).

Źródła (zweryfikowane na minecraft.wiki)

Fakty o panelu (bez wymyślania UI)

  • Komendy wykonywane w zakładce Konsola: pole „Wpisz komendę" + przycisk „Wykonaj".
  • Konsola działa tylko przy włączonym serwerze („Włącz serwer aby uzyskać dostęp do konsoli.").
  • Pliki ops.json, whitelist.json, banned-players.json, banned-ips.json widoczne w zakładce Pliki, opisane jako podgląd (do zmian zalecane komendy).

Placeholdery / TODO (do uzupełnienia zrzutami ekranu przed publikacją)

Wstawione jako komentarze MDX ({/* SCREENSHOT: ... */}), niewidoczne na stronie, nie psują builda:

  • /img/administracja/konsola.png - zakładka Konsola (pole „Wpisz komendę" + „Wykonaj").
  • /img/administracja/whitelist-add.png - przykładowe whitelist add w konsoli.
  • /img/administracja/ban.png - przykładowe ban w konsoli.

Linki wewnętrzne / zależności

  • /administracja/server-properties (ta sama kategoria, artykuł z tygodnia 6) - będzie zwracać 404 do czasu zmergowania tygodnia 6. Użyto pełnego URL, żeby build z onBrokenLinks: throw nie wywalał się na brakującej trasie.
  • ../tutorial/fastlogin.md - istnieje, link względny, build przechodzi.
  • Wpis na blogu https://voxelhost.pl/blog/whitelist-serwera-minecraft (ten sam tydzień) - 404 do czasu zmergowania PR bloga.

Weryfikacja

  • yarn install --frozen-lockfile OK, brak zmian w yarn.lock.
  • yarn build zakończony kodem wyjścia 0, brak ostrzeżeń o zepsutych linkach.
  • Trasa wygenerowana: build/administracja/op-whitelista-bany/index.html.
  • <title>, meta description (145 znaków) i keywords obecne w HTML.
  • Długość treści ~871 słów, brak myślników em (—), pisownia voxelhost małą literą.

Release

release: 2026-08-17 (tydzień 7), razem z PR bloga na stronie (whitelist).

@iipanda iipanda added the release-2026-08-17 Merge/publish on 2026-08-17 label Jul 6, 2026

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b39b3253ac

ℹ️ 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".

- **poziom 3 (admin)** – komendy do zarządzania graczami: `ban`, `kick`, `whitelist`, `op`,
- **poziom 4 (owner)** – wszystkie komendy, w tym zarządzanie serwerem (np. `stop`, `save-all`).

Poziom przyznawany komendą `op` ustala opcja `op-permission-level` w pliku `server.properties` (domyślnie **4**, czyli pełne uprawnienia). Jeśli chcesz, aby operatorzy mieli węższy zakres, obniż tę wartość, zanim nadasz OP. Opis tego pliku znajdziesz w poradniku [server.properties](https://docs.voxelhost.pl/administracja/server-properties).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Avoid shipping a 404 self-link

This links to https://docs.voxelhost.pl/administracja/server-properties, but I searched the repo for server-properties and there is no corresponding doc/route in this commit; because the link is absolute, Docusaurus will not catch it with onBrokenLinks: 'throw'. If this article is published before the server-properties page lands, readers following either this inline link or the same link in “Zobacz też” will hit a production 404, so the dependency should be merged first or the link should be removed/changed until the page exists.

Useful? React with 👍 / 👎.

description: "Nadawanie uprawnień operatora, prowadzenie whitelisty i banowanie graczy na serwerze Minecraft prosto z panelu voxelhost, bez wchodzenia do gry."
keywords: [op, deop, whitelist, whitelista, ban, banowanie, kick, uprawnienia operatora, ban-ip, pardon, konsola, serwer minecraft, voxelhost]
slug: /administracja/op-whitelista-bany
sidebar_position: 3

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Add the article to the manual sidebar

sidebar_position does not make this page visible because sidebars.js in this repo defines a manual docs sidebar with only intro and the tutorial/* items, and there is no administracja category. The route will exist, but the new knowledge-base article is orphaned from the site navigation unless readers have a direct URL, so add it to the manual sidebar or switch that category to autogenerated before publishing.

Useful? React with 👍 / 👎.

@iipanda

iipanda commented Jul 6, 2026

Copy link
Copy Markdown
Member Author

Added panel screenshots for all 3 placeholders at their specified paths: Konsola with the command field, an example whitelist add Steve run, and an example ban Steve run (with pardon Steve executed afterward to clean up the test server). Build verified locally (docusaurus build exit 0, images present in output).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

release-2026-08-17 Merge/publish on 2026-08-17

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant