Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -3,39 +3,39 @@ id: admin_configuration
---
# System konfiguracji

HyperFactions używa modularnego systemu konfiguracji JSON z 11 plikami konfiguracyjnymi.
HyperFactions uzywa modularnego systemu konfiguracji JSON z 11 plikami konfiguracyjnymi.

## Komendy konfiguracji administracyjnej

| Komenda | Opis |
|---------|-------------|
| `/f admin config` | Otwórz wizualny edytor konfiguracji GUI |
| `/f admin reload` | Przeładuj wszystkie pliki konfiguracyjne z dysku |
| `/f admin config` | Otworz wizualny edytor konfiguracji GUI |
| `/f admin reload` | Przeladuj wszystkie pliki konfiguracyjne z dysku |
| `/f admin sync` | Synchronizuj dane frakcji do magazynu |

## Pliki konfiguracyjne

| Plik | Zawartość |
| Plik | Zawartosc |
|------|----------|
| `factions.json` | Role, moc, zajęcia, walka, relacje |
| `server.json` | Teleportacja, auto-zapis, wiadomości, GUI, uprawnienia |
| `factions.json` | Role, moc, zajecia, walka, relacje |
| `server.json` | Teleportacja, auto-zapis, wiadomosci, GUI, uprawnienia |
| `economy.json` | Skarbiec, utrzymanie, ustawienia transakcji |
| `backup.json` | Rotacja i retencja kopii zapasowych |
| `chat.json` | Formatowanie czatu frakcyjnego i sojuszniczego |
| `debug.json` | Kategorie logowania debugowego |
| `faction-permissions.json` | Domyślne uprawnienia dla ról |
| `announcements.json` | Transmisja wydarzeń i powiadomienia terytorialne |
| `gravestones.json` | Ustawienia integracji nagrobków |
| `worldmap.json` | Tryby odświeżania mapy świata |
| `worlds.json` | Nadpisania zachowań dla poszczególnych światów |
| `faction-permissions.json` | Domyslne uprawnienia dla rol |
| `announcements.json` | Transmisja wydarzen i powiadomienia terytorialne |
| `gravestones.json` | Ustawienia integracji nagrobkow |
| `worldmap.json` | Tryby odswiezania mapy swiata |
| `worlds.json` | Nadpisania zachowan dla poszczegolnych swiatow |

>[!TIP] GUI konfiguracji zapewnia wizualny edytor z opisami dla każdego ustawienia. Zmiany zapisywane natychmiast, ale niektóre wymagają `/f admin reload`, aby w pełni zadziałać.
>[!TIP] GUI konfiguracji zapewnia wizualny edytor z opisami dla kazdego ustawienia. Zmiany sa zapisywane natychmiast, ale niektore wymagaja `/f admin reload`, aby w pelni zadzialac.

## Lokalizacja konfiguracji

Wszystkie pliki przechowywane w:
Wszystkie pliki sa przechowywane w:
`mods/com.hyperfactions_HyperFactions/config/`

>[!WARNING] Ręczne edycje JSON wymagają `/f admin reload`, aby zostały zastosowane. Niepoprawny JSON spowoduje pominięcie pliku z ostrzeżeniem w logu serwera.
>[!WARNING] Reczne edycje JSON wymagaja `/f admin reload`, aby zostaly zastosowane. Niepoprawny JSON spowoduje pominiecie pliku z ostrzezeniem w logu serwera.

>[!NOTE] Wersja konfiguracji jest śledzona w `server.json`. Plugin automatycznie migruje starsze konfiguracje przy uruchomieniu.
>[!NOTE] Wersja konfiguracji jest sledzona w `server.json`. Plugin automatycznie migruje starsze konfiguracje przy uruchomieniu.
Original file line number Diff line number Diff line change
@@ -1,45 +1,45 @@
---
id: admin_world_settings
---
# Ustawienia per-świat
# Ustawienia per-swiat

HyperFactions obsługuje konfigurację per-świat dla zajmowania, PvP i zachowania ochrony.
HyperFactions obsluguje konfiguracje per-swiat dla zajmowania, PvP i zachowania ochrony.

## Komendy światów
## Komendy swiatow

| Komenda | Opis |
|---------|-------------|
| `/f admin world list` | Lista wszystkich nadpisań światów |
| `/f admin world info <world>` | Pokaż ustawienia dla świata |
| `/f admin world list` | Lista wszystkich nadpisan swiatow |
| `/f admin world info <world>` | Pokaz ustawienia dla swiata |
| `/f admin world set <world> <key> <value>` | Ustaw ustawienie |
| `/f admin world reset <world>` | Resetuj świat do domyślnych |
| `/f admin world reset <world>` | Resetuj swiat do domyslnych |

## Dostępne ustawienia
## Dostepne ustawienia

| Ustawienie | Typ | Opis |
|---------|------|-------------|
| claiming_enabled | boolean | Zezwól na zajęcia frakcji w tym świecie |
| pvp_enabled | boolean | Zezwól na walkę PvP w tym świecie |
| power_loss | boolean | Zastosuj utratę mocy przy śmierci |
| build_protection | boolean | Wymuś ochronę budowania na zajęciach |
| explosion_protection | boolean | Chroń zajęcia przed eksplozjami |
| claiming_enabled | boolean | Zezwol na zajecia frakcji w tym swiecie |
| pvp_enabled | boolean | Zezwol na walke PvP w tym swiecie |
| power_loss | boolean | Zastosuj utrate mocy przy smierci |
| build_protection | boolean | Wymus ochrone budowania na zajeciach |
| explosion_protection | boolean | Chron zajecia przed eksplozjami |

## Biała lista / czarna lista światów
## Biala lista / czarna lista swiatow

Kontroluj, które światy pozwalają na funkcje frakcji przez plik konfiguracyjny `worlds.json`:
Kontroluj, ktore swiaty pozwalaja na funkcje frakcji przez plik konfiguracyjny `worlds.json`:

- **Tryb białej listy**: Tylko wymienione światy pozwalają na zajmowanie
- **Tryb czarnej listy**: Wszystkie światy pozwalają na zajmowanie oprócz wymienionych
- **Tryb bialej listy**: Tylko wymienione swiaty pozwalaja na zajmowanie
- **Tryb czarnej listy**: Wszystkie swiaty pozwalaja na zajmowanie oprocz wymienionych

>[!INFO] Ustawienia światów są przechowywane w `worlds.json` i nadpisują globalne domyślne z `factions.json`.
>[!INFO] Ustawienia swiatow sa przechowywane w `worlds.json` i nadpisuja globalne domyslne z `factions.json`.

## Przykłady
## Przyklady

- `/f admin world set survival claiming_enabled true`
- `/f admin world set creative claiming_enabled false`
- `/f admin world set pvp_arena pvp_enabled true`
- `/f admin world reset lobby` -- przywróć wszystkie domyślne
- `/f admin world reset lobby` -- przywroc wszystkie domyslne

>[!TIP] Wyłącz zajmowanie w światach kreatywnych lub lobby, aby skupić system frakcji na rozgrywce survivalowej.
>[!TIP] Wylacz zajmowanie w swiatach kreatywnych lub lobby, aby skupic system frakcji na rozgrywce survivalowej.

>[!NOTE] Ustawienia per-świat mają priorytet nad globalną konfiguracją, ale nadpisywane przez flagi stref w danym świecie.
>[!NOTE] Ustawienia per-swiat maja priorytet nad globalna konfiguracja, ale sa nadpisywane przez flagi stref w danym swiecie.
Original file line number Diff line number Diff line change
@@ -1,39 +1,39 @@
---
id: admin_treasury_management
---
# Zarządzanie skarbcem
# Zarzadzanie skarbcem

Komendy administracyjne do zarządzania skarbcami frakcji. Wymaga uprawnienia `hyperfactions.admin.economy`.
Komendy administracyjne do zarzadzania skarbcami frakcji. Wymaga uprawnienia `hyperfactions.admin.economy`.

## Komendy skarbca

| Komenda | Opis |
|---------|-------------|
| `/f admin economy balance <faction>` | Wyświetl saldo skarbca frakcji |
| `/f admin economy set <faction> <amount>` | Ustaw dokładne saldo |
| `/f admin economy balance <faction>` | Wyswietl saldo skarbca frakcji |
| `/f admin economy set <faction> <amount>` | Ustaw dokladne saldo |
| `/f admin economy add <faction> <amount>` | Dodaj fundusze do skarbca |
| `/f admin economy take <faction> <amount>` | Usuń fundusze ze skarbca |
| `/f admin economy take <faction> <amount>` | Usun fundusze ze skarbca |
| `/f admin economy reset <faction>` | Resetuj skarbiec do zera |

## Przykłady
## Przyklady

- `/f admin economy balance Vikings` -- sprawdź saldo
- `/f admin economy balance Vikings` -- sprawdz saldo
- `/f admin economy set Vikings 5000` -- ustaw na 5000
- `/f admin economy add Vikings 1000` -- wpłać 1000
- `/f admin economy take Vikings 500` -- wypłać 500
- `/f admin economy add Vikings 1000` -- wplac 1000
- `/f admin economy take Vikings 500` -- wyplac 500
- `/f admin economy reset Vikings` -- wyzeruj saldo

>[!TIP] Użyj `/f admin info <faction>`, aby zobaczyć pełny przegląd ekonomii, w tym historię transakcji obok salda skarbca.
>[!TIP] Uzyj `/f admin info <faction>`, aby zobaczyc pelny przeglad ekonomii, w tym historie transakcji obok salda skarbca.

## Przypadki użycia
## Przypadki uzycia

| Scenariusz | Komenda |
|----------|---------|
| Dystrybucja nagród za wydarzenie | `economy add <faction> <prize>` |
| Kara za złamanie regulaminu | `economy take <faction> <fine>` |
| Dystrybucja nagrod za wydarzenie | `economy add <faction> <prize>` |
| Kara za zlamanie regulaminu | `economy take <faction> <fine>` |
| Reset ekonomii po wipe | `economy reset <faction>` |
| Kompensacja za błędy | `economy add <faction> <amount>` |
| Kompensacja za bledy | `economy add <faction> <amount>` |

>[!WARNING] Zmiany w skarbcu rejestrowane w historii transakcji frakcji. Modyfikacje administracyjne zapisywane z nazwą administratora dla odpowiedzialności.
>[!WARNING] Zmiany w skarbcu sa rejestrowane w historii transakcji frakcji. Modyfikacje administracyjne sa zapisywane z nazwa administratora dla odpowiedzialnosci.

>[!NOTE] Wszystkie komendy ekonomii administracyjnej działają nawet gdy moduł ekonomii jest wyłączony w konfiguracji. Dane przechowywane niezależnie od statusu modułu.
>[!NOTE] Wszystkie komendy ekonomii administracyjnej dzialaja nawet gdy modul ekonomii jest wylaczony w konfiguracji. Dane sa przechowywane niezaleznie od statusu modulu.
Original file line number Diff line number Diff line change
@@ -1,42 +1,42 @@
---
id: admin_upkeep_management
---
# Zarządzanie utrzymaniem
# Zarzadzanie utrzymaniem

Utrzymanie frakcji obciąża frakcje okresowo na podstawie ich terytorium i liczby członków.
Utrzymanie frakcji obciaza frakcje okresowo na podstawie ich terytorium i liczby czlonkow.

## Kontrole administracyjne

Ustawienia utrzymania są zarządzane przez plik konfiguracji ekonomii lub GUI konfiguracji administracyjnej.
Ustawienia utrzymania sa zarzadzane przez plik konfiguracji ekonomii lub GUI konfiguracji administracyjnej.

`/f admin config`
Otwórz edytor konfiguracji i przejdź do ustawień ekonomii, aby dostosować wartości utrzymania.
Otworz edytor konfiguracji i przejdz do ustawien ekonomii, aby dostosowac wartosci utrzymania.

## Domyślne ustawienia utrzymania
## Domyslne ustawienia utrzymania

| Ustawienie | Domyślnie | Opis |
| Ustawienie | Domyslnie | Opis |
|---------|---------|-------------|
| Utrzymanie włączone | false | Główny przełącznik systemu |
| Interwał utrzymania | 24h | Jak często pobierane jest utrzymanie |
| Koszt za zajęcie | 5.0 | Koszt za zajęty chunk na cykl |
| Koszt za członka | 0.0 | Koszt za członka na cykl |
| Okres karencji | 72h | Nowe frakcje zwolnione |
| Rozwiązanie przy bankructwie | false | Automatyczne rozwiązanie jeśli nie może zapłacić |
| Utrzymanie wlaczone | false | Glowny przelacznik systemu |
| Interwal utrzymania | 24h | Jak czesto pobierane jest utrzymanie |
| Koszt za zajecie | 5.0 | Koszt za zajety chunk na cykl |
| Koszt za czlonka | 0.0 | Koszt za czlonka na cykl |
| Okres karencji | 72h | Nowe frakcje sa zwolnione |
| Rozwiazanie przy bankructwie | false | Automatyczne rozwiazanie jesli nie moze zaplacic |

## Monitorowanie utrzymania

Użyj `/f admin info <faction>`, aby zobaczyć:
Uzyj `/f admin info <faction>`, aby zobaczyc:
- Aktualne saldo skarbca
- Szacowany koszt utrzymania za cykl
- Czas do następnego pobrania utrzymania
- Czy frakcja stać na utrzymanie
- Czas do nastepnego pobrania utrzymania
- Czy frakcja stac na utrzymanie

>[!TIP] Przeglądaj statystyki ekonomii wszystkich frakcji z panelu administracyjnego, aby zidentyfikować frakcje zagrożone bankructwem przed uruchomieniem utrzymania.
>[!TIP] Przegladaj statystyki ekonomii wszystkich frakcji z panelu administracyjnego, aby zidentyfikowac frakcje zagrozone bankructwem przed uruchomieniem utrzymania.

>[!INFO] Konfiguracja utrzymania jest przechowywana w `economy.json`. Zmiany dokonane przez GUI konfiguracji wchodzą w życie po przeładowaniu komendą `/f admin reload`.
>[!INFO] Konfiguracja utrzymania jest przechowywana w `economy.json`. Zmiany dokonane przez GUI konfiguracji wchodza w zycie po przeladowaniu komenda `/f admin reload`.

## Formuła utrzymania
## Formula utrzymania

**Łączne utrzymanie** = (zajęte chunki x koszt za zajęcie) + (liczba członków x koszt za członka)
**Laczne utrzymanie** = (zajete chunki x koszt za zajecie) + (liczba czlonkow x koszt za czlonka)

>[!WARNING] Włączenie utrzymania na serwerze z istniejącymi frakcjami może spowodować niespodziewane bankructwa. Rozważ ustawienie okresu karencji lub wcześniejsze ogłoszenie zmiany.
>[!WARNING] Wlaczenie utrzymania na serwerze z istniejacymi frakcjami moze spowodowac niespodziewane bankructwa. Rozwaz ustawienie okresu karencji lub wczesniejsze ogloszenie zmiany.
Original file line number Diff line number Diff line change
@@ -1,37 +1,37 @@
---
id: admin_disbanding
---
# Wymuszone rozwiązanie
# Wymuszone rozwiazanie

Administratorzy mogą wymusić rozwiązanie dowolnej frakcji, niezależnie od woli lidera.
Administratorzy moga wymusic rozwiazanie dowolnej frakcji, niezaleznie od woli lidera.

## Komenda

`/f admin disband <faction>`
Wymusza rozwiązanie nazwanej frakcji. Przed wykonaniem akcji pojawi się monit o potwierdzenie.
Wymusza rozwiazanie nazwanej frakcji. Przed wykonaniem akcji pojawi sie monit o potwierdzenie.

**Uprawnienie**: `hyperfactions.admin.disband`

>[!WARNING] Rozwiązanie frakcji jest **nieodwracalne**. Wszystkie zajęcia są zwalniane, wszyscy członkowie są usuwani, a frakcja przestaje istnieć. Najpierw utwórz kopię zapasową.
>[!WARNING] Rozwiazanie frakcji jest **nieodwracalne**. Wszystkie zajecia sa zwalniane, wszyscy czlonkowie sa usuwani, a frakcja przestaje istniec. Najpierw utworz kopie zapasowa.

## Konsekwencje

Gdy frakcja zostaje rozwiązana:
Gdy frakcja zostaje rozwiazana:

| Efekt | Opis |
|--------|-------------|
| **Zajęcia** | Całe terytorium jest natychmiast zwalniane |
| **Członkowie** | Wszyscy gracze usuwani ze składu |
| **Relacje** | Wszystkie sojusze i wrogości są czyszczone |
| **Skarbiec** | Obsługiwany zgodnie z ustawieniami konfiguracji ekonomii |
| **Zajecia** | Cale terytorium jest natychmiast zwalniane |
| **Czlonkowie** | Wszyscy gracze sa usuwani ze skladu |
| **Relacje** | Wszystkie sojusze i wrogosci sa czyszczone |
| **Skarbiec** | Obslugiwany zgodnie z ustawieniami konfiguracji ekonomii |
| **Baza** | Baza frakcji jest usuwana |
| **Czat** | Historia czatu frakcji jest usuwana |

## Najlepsze praktyki

1. Zawsze wpisz `/f admin backup create` przed rozwiązaniem
2. Powiadom członków frakcji, gdy to możliwe
3. Udokumentuj powód dla rejestrów serwera
4. Sprawdź `/f admin info <faction>`, aby przejrzeć przed podjęciem akcji
1. Zawsze wpisz `/f admin backup create` przed rozwiazaniem
2. Powiadom czlonkow frakcji, gdy to mozliwe
3. Udokumentuj powod dla rejestrow serwera
4. Sprawdz `/f admin info <faction>`, aby przejrzec przed podjeciem akcji

>[!TIP] Jeśli problem dotyczy konkretnego członka, rozważ użycie GUI administracyjnego frakcji do przekazania przywództwa zamiast rozwiązywania całej frakcji.
>[!TIP] Jesli problem dotyczy konkretnego czlonka, rozwaz uzycie GUI administracyjnego frakcji do przekazania przywodztwa zamiast rozwiazywania calej frakcji.
Original file line number Diff line number Diff line change
@@ -1,38 +1,38 @@
---
id: admin_managing_factions
---
# Zarządzanie frakcjami
# Zarzadzanie frakcjami

Administratorzy mogą przeglądać i modyfikować dowolną frakcję na serwerze przez panel administracyjny lub komendy.
Administratorzy moga przegladac i modyfikowac dowolna frakcje na serwerze przez panel administracyjny lub komendy.

## Przeglądanie frakcji
## Przegladanie frakcji

`/f admin factions`
Otwiera przeglądarkę frakcji administracyjną. Wyświetla wszystkie frakcje z liczbą członków, poziomami mocy i terytorium.
Otwiera przegladarke frakcji administracyjna. Wyswietla wszystkie frakcje z liczba czlonkow, poziomami mocy i terytorium.

`/f admin info <faction>`
Otwiera panel informacji administracyjnych dla konkretnej frakcji z pełnymi szczegółami i opcjami zarządzania.
Otwiera panel informacji administracyjnych dla konkretnej frakcji z pelnymi szczegolami i opcjami zarzadzania.

## Modyfikowanie ustawień frakcji
## Modyfikowanie ustawien frakcji

Z uprawnieniem `hyperfactions.admin.modify` możesz:
Z uprawnieniem `hyperfactions.admin.modify` mozesz:

- **Zmienić nazwę** frakcji, aby rozwiązać konflikty
- **Ustawić kolor**, aby naprawić problemy z wyświetlaniem
- **Przełączyć otwartą/zamkniętą**, aby nadpisać politykę dołączania
- **Edytować opis** w celach moderacyjnych
- **Zmienic nazwe** frakcji, aby rozwiazac konflikty
- **Ustawic kolor**, aby naprawic problemy z wyswietlaniem
- **Przelaczyc otwarta/zamknieta**, aby nadpisac polityke dolaczania
- **Edytowac opis** w celach moderacyjnych

>[!TIP] Użyj `/f admin who <player>`, aby sprawdzić, do której frakcji należy dany gracz i wyświetlić jego szczegóły.
>[!TIP] Uzyj `/f admin who <player>`, aby sprawdzic, do ktorej frakcji nalezy dany gracz i wyswietlic jego szczegoly.

## Przeglądanie członków i relacji
## Przegladanie czlonkow i relacji

Panel informacji administracyjnych pokazuje:

| Sekcja | Szczegóły |
| Sekcja | Szczegoly |
|---------|---------|
| **Członkowie** | Pełny skład z rolami i ostatnią aktywnością |
| **Relacje** | Wszystkie statusy sojuszy, wrogości i neutralności |
| **Terytorium** | Zajęte chunki i bilans mocy |
| **Czlonkowie** | Pelny sklad z rolami i ostatnia aktywnoscia |
| **Relacje** | Wszystkie statusy sojuszy, wrogosci i neutralnosci |
| **Terytorium** | Zajete chunki i bilans mocy |
| **Ekonomia** | Saldo skarbca i log transakcji |

>[!NOTE] Komendy inspekcji administracyjnej nie powiadamiają przeglądanej frakcji. Tylko modyfikacje wywołują alerty.
>[!NOTE] Komendy inspekcji administracyjnej nie powiadamiaja przegladanej frakcji. Tylko modyfikacje wywoluja alerty.
Loading