SGS Hub Dokumentacja

Appearance

Zarządzanie plikami ​

System plików SGS Hub umożliwia przeglądanie, edycję, upload i download plików serwera.

Przeglądanie plików ​

Dostęp do file browsera ​

  1. Panel serwera → zakładka Files
  2. Zobaczysz hierarchię folderów serwera

Widok drzewa folderów:

/
├── ShooterGame/
│   ├── Saved/
│   │   ├── Config/
│   │   │   └── WindowsServer/
│   │   │       ├── GameUserSettings.ini
│   │   │       └── Game.ini
│   │   ├── SavedArks/
│   │   │   └── TheIsland.ark
│   │   └── Logs/
│   │       └── ShooterGame.log
│   ├── Content/
│   │   └── Mods/
│   │       ├── 731604991/
│   │       └── 848591216/
│   └── Binaries/
└── cluster/             # Jeśli serwer jest w klastrze

Nawigacja ​

Kliknij folder aby go rozwinąć i zobaczyć zawartość.

Breadcrumb navigation na górze pokazuje aktualną ścieżkę:

/ > ShooterGame > Saved > Config > WindowsServer

Ikony folderów:

  • 📁 Folder zamknięty
  • 📂 Folder otwarty
  • 📄 Plik tekstowy
  • 🖼️ Plik graficzny
  • 🗃️ Plik archiwum (.zip, .tar.gz)
  • ⚙️ Plik konfiguracyjny (.ini, .cfg, .json)

Szczegóły pliku ​

Kliknij plik aby zobaczyć szczegóły:

  • Nazwa - Pełna nazwa pliku
  • Rozmiar - Wielkość w MB/KB
  • Ostatnia modyfikacja - Data i czas
  • Uprawnienia - Read/Write/Execute
  • Typ MIME - text/plain, application/json, etc.

Akcje:

  • Edit (✏️) - Edytuj plik (tylko text files)
  • Download (⬇️) - Pobierz plik na komputer
  • Delete (🗑️) - Usuń plik
  • Rename (✎) - Zmień nazwę
  • Copy Path (📋) - Skopiuj pełną ścieżkę do schowka

Edytor plików ​

Wspierane typy plików ​

SGS Hub ma wbudowany edytor z syntax highlighting dla:

  • .ini - Pliki konfiguracyjne ARK
  • .cfg - Server config FiveM
  • .lua - Scripty Lua (FiveM resources)
  • .json - JSON configs
  • .xml - XML configs
  • .txt - Pliki tekstowe
  • .log - Logi (read-only)

Otwieranie edytora ​

Krok 1: Wybierz plik

Przejdź do pliku (np. GameUserSettings.ini) i kliknij Edit (✏️).

Krok 2: Edytor otworzy się

Zobaczysz edytor z:

  • Numeracja linii - Po lewej stronie
  • Syntax highlighting - Kolorowanie składni
  • Search - Wyszukiwanie w pliku (Ctrl+F)
  • Find & Replace - Znajdź i zamień (Ctrl+H)
  • Undo/Redo - Cofnij/Przywróć (Ctrl+Z / Ctrl+Y)

Edycja INI files (ARK) ​

GameUserSettings.ini i Game.ini to najważniejsze pliki konfiguracyjne ARK.

Przykład edycji GameUserSettings.ini:

  1. Otwórz /ShooterGame/Saved/Config/WindowsServer/GameUserSettings.ini
  2. Znajdź sekcję [ServerSettings]
  3. Edytuj wartości:
    ini
    [ServerSettings]
ServerPassword=MojeHaslo123
ServerAdminPassword=AdminPass456
MaxPlayers=50
  4. Kliknij Save (💾)
  5. Zrestartuj serwer aby zastosować zmiany

Syntax INI

Format INI jest bardzo wrażliwy na błędy składni:

  • Sekcje: [NazwaSekcji]
  • Klucze: Klucz=Wartość
  • Bez spacji wokół =
  • Komentarze: ; To jest komentarz

Błąd składni = serwer może nie wystartować!

Edycja CFG files (FiveM) ​

server.cfg to główny plik konfiguracyjny FiveM.

Przykład edycji server.cfg:

  1. Otwórz /server.cfg
  2. Edytuj ustawienia:
    cfg
    # Server info
sv_hostname "Mój FiveM Server"
sv_maxclients 48

# License key (WYMAGANE!)
sv_licenseKey "cfxk_xxxxxxxxxxxxx"

# Resources
ensure qb-core
ensure qb-policejob
ensure qb-ambulancejob
  3. Zapisz
  4. txAdmin → Restart server

Find & Replace ​

Użyteczne przy bulk changes.

Przykład: Zmiana wszystkich mnożników z 1.0 na 5.0

  1. Otwórz GameUserSettings.ini
  2. Naciśnij Ctrl+H (Find & Replace)
  3. Find: Multiplier=1.0
  4. Replace: Multiplier=5.0
  5. Kliknij Replace All
  6. Zapisz plik

Regex support

Zaawansowani użytkownicy mogą używać regex w Find & Replace. Włącz checkbox "Use Regex" i użyj wzorców:

Find: Multiplier=(\d+\.\d+)
Replace: Multiplier=$1.5

To pomnoży wszystkie multipliery przez 1.5.

Upload plików ​

Upload pojedynczego pliku ​

Krok 1: Przygotuj plik

Przygotuj plik na swoim komputerze (np. custom GameUserSettings.ini).

Krok 2: Upload

  1. W file browserze przejdź do docelowego folderu
  2. Kliknij Upload (⬆️)
  3. Wybierz plik z dysku
  4. Poczekaj na zakończenie uploadu
  5. Plik pojawi się na liście

Limit rozmiaru: 500 MB per plik

Supported formats: Wszystkie (text, binary, archives)

Upload folderu (zip) ​

Jeśli chcesz uploadować wiele plików:

  1. Spakuj folder do .zip na swoim komputerze
  2. Upload ZIP file do SGS Hub
  3. Kliknij ZIP → Extract Here (📦)
  4. ZIP zostanie rozpakowany w obecnej lokalizacji
  5. Możesz usunąć ZIP po ekstrakcji

Przykład use case: Upload custom moda FiveM:

  1. Spakuj folder my-custom-resource/ do my-custom-resource.zip
  2. Upload do /resources/[local]/
  3. Extract
  4. Dodaj ensure my-custom-resource do server.cfg

Upload backupu ​

Przywracanie plików z lokalnego backupu:

  1. Pobierz backup na komputer (np. server-backup-2025-10-26.tar.gz)
  2. Rozpakuj na swoim komputerze
  3. Upload poszczególne pliki/foldery do SGS Hub
  4. Alternatywnie: Upload archive i extract na serwerze

Upload overwrite

Upload pliku o tej samej nazwie nadpisze istniejący plik bez pytania! Zrób backup przed uploadem jeśli nie jesteś pewny.

Download plików ​

Download pojedynczego pliku ​

  1. Znajdź plik w file browserze
  2. Kliknij Download (⬇️)
  3. Plik zostanie pobrany do folderu Downloads na Twoim komputerze

Kiedy używać:

  • Backup plików konfiguracyjnych przed edycją
  • Download logów do analizy
  • Eksport save'ów dla graczy

Download całego folderu ​

SGS Hub nie obsługuje jeszcze direct folder download. Ale możesz:

Opcja 1: Przez Backup

  1. Utwórz Full Backup serwera
  2. Download backup (zawiera wszystkie pliki)
  3. Rozpakuj na swoim komputerze

Opcja 2: Ręcznie po kolei

  1. Download każdy plik z folderu pojedynczo
  2. Recreate strukturę folderów na swoim komputerze

Opcja 3: Przez SFTP (zaawansowane) Jeśli masz dostęp SFTP do Pterodactyl, możesz użyć FileZilla do bulk download.

Usuwanie plików ​

Usuń pojedynczy plik ​

  1. Kliknij plik
  2. Kliknij Delete (🗑️)
  3. Potwierdź usunięcie

Usunięcie jest permanentne!

Usunięte pliki NIE trafiają do kosza. Są natychmiast usuwane. Nie ma undo!

Zawsze zrób backup przed usunięciem ważnych plików.

Usuń folder ​

  1. Kliknij folder
  2. Kliknij Delete Folder (🗑️📁)
  3. Potwierdź
  4. Cała zawartość folderu zostanie usunięta rekurencyjnie

Use case: Usuwanie starego moda:

/ShooterGame/Content/Mods/731604991/  [Delete]

Masowe usuwanie ​

Select multiple:

  1. Zaznacz checkboxy obok plików/folderów
  2. Kliknij Delete Selected
  3. Potwierdź bulk delete

Przykład: Czyszczenie starych logów:

☑ ShooterGame.log.1
☑ ShooterGame.log.2
☑ ShooterGame.log.3
[Delete Selected]

Zarządzanie przestrzenią dyskową ​

Sprawdzanie użycia dysku ​

Panel serwera → Overview → Disk Usage

Zobaczysz:

  • Used: 45.2 GB
  • Total: 100 GB
  • Free: 54.8 GB
  • Percentage: 45.2%

Breakdown (gdzie zajmuje miejsce):

  • Game files: 35 GB (ARK base game)
  • Mods: 5 GB (zainstalowane mody)
  • Saves: 3 GB (save files)
  • Logs: 1 GB (pliki logów)
  • Backups: 1.2 GB (thin backups)

Czyszczenie miejsca ​

Jeśli zbliżasz się do limitu:

1. Usuń stare logi

/ShooterGame/Saved/Logs/

Zachowaj ostatnie 2-3 dni, resztę usuń.

2. Usuń nieużywane mody Każdy mod = 10-1000 MB. Usuń mody które nie używasz.

3. Usuń stare backupy Thin backups zajmują 100-500 MB każdy. Zachowaj ostatnie 5-7, resztę usuń.

4. Wyczyść cache

/ShooterGame/Saved/Cache/

Bezpiecznie usunąć - zregeneruje się.

5. Compress logi (zaawansowane)

bash
# W Console (jako custom command):
find /ShooterGame/Saved/Logs -name "*.log" -mtime +7 -exec gzip {} \;

Kompresuje logi starsze niż 7 dni.

Auto-cleanup schedule

Ustaw harmonogram automatycznego czyszczenia logów. Zobacz Schedules dla szczegółów.

Uprawnienia plików ​

Sprawdzanie uprawnień ​

Niektóre pliki mają restricted permissions (tylko read).

Ikony uprawnień:

  • 🔒 Read-only - Możesz tylko czytać
  • 🔓 Read/Write - Możesz edytować
  • ⚠️ Execute - Plik wykonywalny (binary)

Przykłady:

  • GameUserSettings.ini - 🔓 Read/Write
  • ShooterGameServer - ⚠️ Execute (nie edytuj!)
  • ShooterGame.log - 🔒 Read-only

Zmiana uprawnień (zaawansowane) ​

SGS Hub nie oferuje jeszcze GUI do zmiany permissions. Jeśli potrzebujesz zmienić uprawnienia:

  1. Skontaktuj się z supportem SGS Hub
  2. Podaj ścieżkę pliku i wymagane uprawnienia
  3. Support zmieni permissions w Pterodactyl

Typowe use case: Nadawanie execute permission dla custom scriptu.

Troubleshooting ​

Nie mogę edytować pliku ​

Problem: Przycisk "Edit" jest nieaktywny

Przyczyny:

  1. Plik jest read-only - Sprawdź ikony uprawnień
  2. Plik jest binary - Edytor obsługuje tylko text files
  3. Plik jest za duży - Limit 10 MB dla edytora (użyj download → edit locally → upload)

Zmiany w INI nie działają ​

Problem: Edytowałem GameUserSettings.ini, ale zmiany nie weszły w życie

Rozwiązanie:

  1. Zrestartuj serwer! - Zmiany w INI wymagają restartu
  2. Sprawdź syntax - Błędy składni mogą powodować że sekcja jest ignorowana
  3. Sprawdź czy edytowałeś właściwy plik - WindowsServer nie LinuxServer

Upload się nie powiódł ​

Problem: Upload timeout lub failed

Rozwiązania:

  • Plik za duży - Maksimum 500 MB per plik. Podziel na części lub skompresuj
  • Brak miejsca - Sprawdź Disk Usage, usuń niepotrzebne pliki
  • Połączenie zerwane - Spróbuj ponownie z lepszym internetem

Nie widzę pliku po upload ​

Problem: Uploadowałem plik, ale nie widzę go na liście

Rozwiązania:

  1. Odśwież stronę - Kliknij F5
  2. Sprawdź folder - Upewnij się że uploadowałeś do właściwego folderu
  3. Sprawdź nazwę - Może został przesłany z inną nazwą (conflict resolution)

Następne kroki ​

Dokumentacja SGS Hub

Copyright © 2025 SGS Hub