Merge pull request #2 from korpens1/main

Patch v0.2 & v0.3

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "editor.wordBasedSuggestions": false
+}

fivem/database.md

@@ -1,21 +1,68 @@
 ---
-label: Jak podpiąć bazę danych?
-order: 1
+label: Podpinanie bazy danych
+order: 98
 icon: database
-author:
-  name: OreQr
-  email: [email protected]
-  avatar: /static/avatars/oreqr.png
+authors:
+  - name: Korpens
+    email: [email protected]
+    avatar: /static/avatars/korpens.jpg
+  - name: OreQr
+    email: [email protected]
+    avatar: /static/avatars/oreqr.png
 ---
 
+
+
 ## Automatycznie
-Wystarczy nacisnąć przycisk otwartej książki w zakładce `Bazy danych`.
- ![](/static/fivem/database.png)
+
+!!!danger
+**Chwilowo niedostępne!**
+!!!
 
 ## Ręcznie
-1. Wejdź w zakładkę `Pliki` następnie kliknij w plik **server.cfg**.
-2. Usuń linijkę `set mysql_connection_string "...` jeżeli istnieje.
-3. W nowej karcie otwórz zakładkę `Bazy danych` a następnie naciśnij w przycisk oczka.
-   ![](/static/fivem/eye.png)
-4. Naciśnij w **CIĄG POŁĄCZENIA**, aby go skopiować.
-3. Dodaj linijkę `set mysql_connection_string "CIĄG POŁĄCZENIA"` do `server.cfg` i zamień **CIĄG POŁĄCZENIA** na skopiowaną wartość.
+1. Wchodzimy w zakładkę `Pliki`,a następnie otwieramy swój plik **server.cfg**.
+
+2.  [!badge variant="info" text="**Jeśli istnieje**"] Usuwamy linijkę:
+```cfg
+set mysql_connection_string "..."
+```
+
+==- Tworzenie bazy danych
+1. W zakładce `Bazy danych` klikamy w przycisk [!badge variant="success" text="NOWA BAZA DANYCH"].
+
+
+![](/static/fivem/baza2.png)
+
+
+2. Wybieramy nazwę dla swojej bazy danych, a następnie klikamy przycisk [!badge variant="success" text="UTWÓRZ BAZĘ DANYCH"].
+!!!primary
+**CONNECTIONS FROM** pozostawiamy puste.
+!!!
+
+
+![](/static/fivem/baza3.png)
+
+
+3. [!badge variant="success" text="**Brawo**"] Baza danych została utworzona.
+===
+3. Wchodzimy w zakładkę `Bazy danych`, a następnie naciskamy w przycisk oczka.
+
+
+![](/static/fivem/baza1.png)
+
+
+4. Kopiujemy `CIĄG POŁĄCZENIA`.
+
+![](/static/fivem/baza4.png)
+
+5. Ponownie wchodzimy do **server.cfg** i wklejamy poniższą linijkę: (Gdzie `CIĄG POŁĄCZENIA` to skopiowany wcześniej ciąg)
+```cfg
+set mysql_connection_string "CIĄG POŁĄCZENIA"
+```
+
+![](/static/fivem/baza5.png)
+!!!primary
+**Linijkę najlepiej wkleić od razu po Endpointach**
+!!!
+
+6. [!badge variant="success" text="**Brawo**"] Baza danych została podłączona pomyślnie.

fivem/domena-fivem.md

@@ -0,0 +1,52 @@
+---
+label: Podpięcie domeny
+order: 95
+icon: link
+author:
+  name: Korpens
+  email: [email protected]
+  avatar: /static/avatars/korpens.jpg
+---
+!!!primary
+Poradnik zgodny z usługami <a href="https://dash.cloudflare.com/" target="_blank">**CloudFlare**
+</a>.
+!!!
+
+## Konfiguracja domeny
+
+Do podłączenia domeny potrzebujemy mieć zarejestrowaną/dodaną domenę na Cloudflare. Jeśli nie masz domeny na Cloudflare, możesz ją dodać w zakładce [!badge variant="info" text="**Websites**"] klikając przycisk [!badge variant="primary" text="**Add a site**"]
+
+## Podpięcie domeny
+
+1. W panelu **CloudFlare** Przechodzimy do zakładki `DNS > Records`.
+
+2. Klikamy przycisk [!badge variant="primary" text="**Add record**"] i wybieramy **A**.
+
+
+![](/static/fivem/cld1.png)
+
+
+* W polu `Name` wpisujemy `@` lub ***nazwę subdomeny***,<br>
+* W polu `IPv4 address` wpisujemy **IP** serwera ***bez portu***,<br>
+* Zmieniamy opcję **Proxy** status na [!badge variant="contrast" text="**DNS Only**"],
+* Zapisujemy przyciskiem [!badge variant="primary" text="**Save**"].
+
+
+![](/static/fivem/cld2.png)
+
+
+3. Klikamy przycisk [!badge variant="primary" text="**Add record**"] i wybieramy **SRV**.
+* W polu `Name` wpisujemy `@` lub ***nazwę subdomeny***,<br>
+* W polu `Service` wpisujemy `_cfx`,<br>
+* W polu `Protocol` wybieramy `UDP`,<br>
+* W polu `Priority` wpisujemy `10`,<br>
+* W polu `Weight` wpisujemy `10`,<br>
+* W polu `Port` wpisujemy ***port serwera***,<br>
+* W polu `Target` wpisujemy `fivem.twojadomena.pl` *(gdzie `fivem` to nazwa rekordu `A`, a `twojadomena.pl` to twoja domena)*.,<br>
+* Zapisujemy przyciskiem [!badge variant="primary" text="**Save**"].
+
+
+![](/static/fivem/cld3.png)
+
+
+4. [!badge variant="success" text="**Brawo**"] Możesz teraz połączyć sie z serwerem używając domeny.

fivem/endpoints.md

@@ -0,0 +1,38 @@
+---
+label: Ustawienie endpointów
+order: 99
+icon: broadcast
+author:
+  name: Korpens
+  email: [email protected]
+  avatar: /static/avatars/korpens.jpg
+---
+!!!primary
+Domyślnie endpointy serwera są ustawiane na poprawne. Jeżeli korzystasz z panelu [txAdmin](/fivem/txadmin) oraz ustawiłeś lokalizacje pliku `server.cfg` gdzieś indziej niż `/home/container/`, musisz je ustawić samodzielnie.
+</a>
+!!!
+
+1. Wchodzimy w zakładkę `Pliki`,a następnie otwieramy swój plik **server.cfg**.
+
+
+2. Na samej górze pliku dodajemy 2 linijki:<br>
+```cfg
+endpoint_add_tcp "0.0.0.0:PORT"
+```
+
+```cfg
+endpoint_add_tcp "0.0.0.0:PORT"
+```
+
+
+![](/static/fivem/end1.png)
+
+
+3. W miejscu `PORT` wpisujemy nasz port serwera.
+
+![](/static/fivem/end2.png)
+
+
+!!!danger UWAGA
+W endpoint nie podawaj IP swojego serwera! Jedynie port. `0.0.0.0:PORT`
+!!!

fivem/ikona.md

@@ -0,0 +1,33 @@
+---
+label: Ustawienie ikony serwera
+order: 93
+icon: image
+author:
+  name: Korpens
+  email: [email protected]
+  avatar: /static/avatars/korpens.jpg
+---
+!!!primary Wymagania ikony:
+ :icon-issue-opened: Format obrazu: `PNG`<br>
+ :icon-issue-opened: Rozmiar: `96px` **x** `96px`
+</a>
+!!!
+
+1. Wgrywamy ikonę do folderu, w którym znajduje się plik **server.cfg**.
+
+
+![](/static/fivem/ico1.png)
+
+
+2. Otwieramy plik **server.cfg**
+
+3. Do pliku dopisujemy linijkę: (Gdzie `slogo.png` to twoja nazwa pliku)<br>
+```cfg
+load_server_icon slogo.png"
+```
+
+
+![](/static/fivem/ico2.png)
+
+
+4. [!badge variant="success" text="**Brawo**"] Ikona serwera powinna być teraz widoczna w liście serwerów.

fivem/key-steam.md

@@ -0,0 +1,31 @@
+---
+label: Klucz Steam WebApiKey
+order: 100
+icon: key
+author:
+  name: Korpens
+  email: [email protected]
+  avatar: /static/avatars/korpens.jpg
+---
+!!!warning
+Wymaga zalogowania się na konto **Steam**.
+!!!
+
+1. Aby wygenerować klucz **Steam WebApiKey** należy udać się na officialną stronę <a href="https://steamcommunity.com/dev/apikey" target="_blank">Steam Developers</a>.<br>
+
+2. W polu `Nazwa domeny` podajemy **IP** naszego serwera ***bez portu***, akceptujemy **TOS** i klikamy [!badge variant="success" text="**Zarejestruj się**"].
+
+
+![](/static/fivem/steam1.png)
+
+
+3. Wyświetlony klucz kopiujemy.
+
+
+![](/static/fivem/steam2.png)
+
+
+4. W zakładce `Uruchamianie` wklejamy klucz w polu `STEAM WEB API KEY`.
+
+
+![](/static/fivem/steam3.png)

fivem/key.md

@@ -1,14 +1,44 @@
 ---
-label: Licencja FiveM
-order: 1
+label: Klucz licencyjny FiveM
+order: 100
 icon: key
-author:
-  name: OreQr
-  email: [email protected]
-  avatar: /static/avatars/oreqr.png
+authors:
+  - name: Korpens
+    email: [email protected]
+    avatar: /static/avatars/korpens.jpg
+  - name: OreQr
+    email: [email protected]
+    avatar: /static/avatars/oreqr.png
 ---
+!!!warning
+Wymaga zalogowania się na konto **Cfx.re**.
+!!!
 
-Aby wygenerować klucz licencyjny do serwera FiveM należy udać się na stronę <a href="https://keymaster.fivem.net/" target="_blank">keymastera</a> (wymaga konta na forum.cfx.re) a następnie nacisnąć przycisk **New server** po lewej stronie ekranu.
+1. Aby wygenerować klucz Licencyjny należy udać się na officialną stronę <a href="https://keymaster.fivem.net/" target="_blank">KeyMaster</a>
 
-Informacje podajemy według poniższego wzoru.
- ![](/static/fivem/key.png)
+2. Po zalogowaniu wybieramy [!badge variant="info" text="**:icon-plus-circle: New server**"] z listy po lewo.
+
+![](/static/fivem/key1.png)
+
+3. Teraz uzupełniamy dane, weryfikujemy Captcha i klikamy [!badge variant="primary" text="**Generate**"]
+* W polu `Display name` wpisujemy nazwę naszego serwera,<br>
+* W polu `Initial server IP address` wpisujemy IP naszego serwera bez portu,<br>
+* W polu `Server type` wybieramy `Dedicated server`,<br>
+* W polu `Which server provider are you using?` wpisujemy `OVH`.<br>
+
+
+![](/static/fivem/key2.png)
+
+
+4. Wyświetlony klucz kopiujemy.
+
+
+![](/static/fivem/key3.png)
+
+
+5. W zakładce `Uruchamianie` wklejamy klucz w polu `LICENCJA FIVEM`
+
+
+![](/static/fivem/key4.png)
+
+7. [!badge variant="success" text="**Brawo**"] Klucz ustawiony, teraz możesz odpalić swój serwer.

fivem/txadmin-konfiguracja.md

@@ -0,0 +1,75 @@
+---
+label: Konfiguracja panelu txAdmin
+order: 96
+icon: /static/fivem/txadmin.png
+author:
+  name: Korpens
+  email: [email protected]
+  avatar: /static/avatars/korpens.jpg
+---
+!!!warning
+Wymaga zalogowania się na konto **Cfx.re**.
+!!!
+
+
+1. Po uruchomieniu serwera, w konsoli powinien pojawić się link wraz z kodem dostępu do panelu **txAdmin**.<br>
+***Uwaga! Aby wejść do panelu txAdmin, należy nacisnąć przycisk [!badge variant="dark" text="**txAdmin**"] nad konsolą! Link w konsoli nie działa.***
+
+
+
+![](/static/fivem/tx2.1.png)
+
+
+
+2. Po wejściu na stronę wpisujemy wygenerowany kod w pole `0000`, a następnie klikamy [!badge variant="success" text="**Link Account**"].
+
+
+
+![](/static/fivem/tx2.2.png)
+
+
+
+3. Logujemy się, tworzymy hasło, akceptujemy **TOS** i klikamy [!badge variant="success" text="**Create Master Account**"].
+
+
+![](/static/fivem/tx2.3.png)
+
+
+4. W pierwszym punkcie konfiguracji klikamy przycisk [!badge variant="primary" text="**NEXT**"].
+
+5. Teraz należy podać nazwę swojego serwera. *Nazwa jest wyświetlana tylko w panelu* ***txAdmin***. 
+
+
+![](/static/fivem/tx2.4.png)
+
+
+6. Następnie łączymy pliki serwera. My zalecamy wybrać opcję **Existing Server Data** ***(Zalecane)*** aby użyć już istniejących danych serwera.<br>
+W przypadku wyboru opcji **Popular Recipes** ***(Niezalecane)*** będziesz miał/a możliwość instalacji gotowych paczek serwerowych.
+
+
+![](/static/fivem/tx2.5.png)
+
+
+7. W tym kroku podajemy ścieżkę głównego katalogu. Domyślnie jest to `/home/container/`.
+
+
+![](/static/fivem/tx2.6.png)
+
+
+8. Należy jeszcze ustawić ścieżkę pliku `server.cfg`. Domyślnie jest ona ustawiona na `/home/container/server.cfg`.
+
+
+![](/static/fivem/tx2.7.png)
+
+
+9. [!badge variant="success" text="**Brawo**"] txAdmin został skonfigurowany i jest gotowy do użycia. Naciśnij przycisk [!badge variant="success" text="**Save & Start Server**"] aby uruchomić serwer.
+
+
+![](/static/fivem/tx2.8.png) 
+
+
+10. [!badge variant="info" text="**Opcjonalnie**"] Do lepszego działania serwera zalecamy włączyć OneSync w ustawieniach **txAdmin'a**.<br>
+`Settings > FXServer > OneSync`
+
+
+![](/static/fivem/tx2.9.png)