# Panel Patchkit - dodawanie nowej gry (Launcher)

## Wymagania

1. Dane do Panelu logowania [Patchkit](https://panel.patchkit.net/). (1password)
2. Plik `*.zip` gry
3. Wypełniony formularz z danymi gry <https://docs.google.com/forms/d/e/1FAIpQLSdLAz3jsHkX61NRtt4Z1xvLoSib-OGWDmY4VeGqvStAYMiIEw/viewform> .
4. Dane logowania konta Admin do [API GS\_ID](https://id.gameswift.io/swagger/#/). (1password)
5. Dane z [API ](https://id.gameswift.io/swagger/#/oauth/OauthController_postClient)
   * Redirect Uri
   * Clien ID
   * Game ID

## Instrukcja Upload'u gry  <a href="#instrukcja-upload" id="instrukcja-upload"></a>

1. Logujemy się do panelu patchkita poprzez stronę  <https://panel.patchkit.net/> (dane 1password, vault GameOps)
2. Wchodzimy w `App Catalog` a następnie w `Main` i dodajemy `New Application.`

<figure><img src="https://2015612490-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ5JmocaGzvVEBUeoeB9f%2Fuploads%2Fi5Ved7Lkun1zkdtCD16y%2F1.png?alt=media&#x26;token=c67937f0-8a30-49c2-b3ec-6f4476228f82" alt=""><figcaption></figcaption></figure>

3\. Opcjonalnie możemy stworzyć nowy katalog klikając  `New App Catalog` ale <mark style="color:red;">**UWAGA!!!**</mark> stworzenie nowego katalogu będziemy wymagało wprowadzenia wszystkich `Custom Fields` i podpięcia nowego Launchera do obsługi katalogu.

<figure><img src="https://2015612490-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ5JmocaGzvVEBUeoeB9f%2Fuploads%2FEjowMsTJPzJqRwEtf4Gl%2Fappcatalog.png?alt=media&#x26;token=7f86d7fd-2b5c-4d4c-80d0-fdfd622409e0" alt=""><figcaption></figcaption></figure>

4\. Po kliknięciu `New Application` uzupełniamy poniższe dane i wciskamy `Create`

![](https://2015612490-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ5JmocaGzvVEBUeoeB9f%2Fuploads%2FAPT5tWGhn87A5pm1d57H%2Fimage.png?alt=media\&token=a5e305a7-19d6-430b-a1dd-b921e8a3b657)

5\. Możemy na tym etapie uzupełnić podstawowe dane gry a następnie wybrać platformę na jaką chcemy udostępnić grę.

<figure><img src="https://2015612490-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ5JmocaGzvVEBUeoeB9f%2Fuploads%2F64i3kLYfMXszeklnooEY%2F5.png?alt=media&#x26;token=03a0f817-4af1-4674-a3ca-38a165361bc1" alt=""><figcaption></figcaption></figure>

6\. Po kliknięciu `Set Up` wybieramy `Create New Application`

![](https://2015612490-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ5JmocaGzvVEBUeoeB9f%2Fuploads%2FdKxHaj789novepBPUMPH%2Fimage.png?alt=media\&token=f592e8dd-98e9-4528-925b-eacf2837478e)

7\. Klikamy `New Version` (<mark style="color:red;">**UWAGA!!!**</mark> jeśli dodajemy kolejną wersję gry wykonujemy tylko pkt 7-9). Dodawanie gry tą metodą zawsze umieszcza wersje w głównym Branchu. Dodawanie gier do konkretnych Branchy opisuje ta [Instrukcja](https://addgame.gameswift.io/dodawanie-gier-do-wybranych-branchy-launcher).

<figure><img src="https://2015612490-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ5JmocaGzvVEBUeoeB9f%2Fuploads%2FVkheoCgS0dKYzmCTXTCU%2FVersion.png?alt=media&#x26;token=3b10d9cd-3442-478f-a777-a7f94ae6fc05" alt=""><figcaption></figcaption></figure>

8\. W następnym kroku wskazujem plik `*.zip` z naszego komputera. Jeśli chcemy opublikować od razu grę zaznaczamy `Automatically publish when done`.

<figure><img src="https://2015612490-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ5JmocaGzvVEBUeoeB9f%2Fuploads%2F3RwkYn6nDanMvSeoUw1z%2Fzip.png?alt=media&#x26;token=8358e129-b8bc-4d5a-a439-1b3c2c716fda" alt=""><figcaption></figcaption></figure>

9\. Jeśli gra zostanie już opublikowana, uzupełniamy poniższe pole i sprawdzamy czy mamy wybrany prawidłowy plik wykonywalny `*.exe.`

<figure><img src="https://2015612490-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ5JmocaGzvVEBUeoeB9f%2Fuploads%2Fl7JvPYjM2KDCLbnwCDpz%2Fuloaded.png?alt=media&#x26;token=21f88cba-eef6-4109-ad90-066940297d06" alt=""><figcaption></figcaption></figure>

9\. Teraz zostały nam do uzupełnienia informacje o grze (część mogliśmy już uzupełnić w [pkt5](#5.-mozemy-na-tym-etapie-uzupelnic-podstawowe-dane-gry-a-nastepnie-wybrac-platforme-na-jaka-chcemy-ud)). Plik z formularzem ułatwiającym zbieranie danych znajdziesz pod tym [linkiem](https://docs.google.com/forms/d/e/1FAIpQLSdLAz3jsHkX61NRtt4Z1xvLoSib-OGWDmY4VeGqvStAYMiIEw/viewform?usp=sf_link).

10\. W `App Catalog` powiniśmy już widzieć naszą nowo dodaną gre.

## Uzupełnianie danych gry

1\. Wybieramy grę i wypełniamy zakładkę `General settings`. (Pomijamy ten krok jeśli zrobiliśmy to w pkt.5)

<figure><img src="https://2015612490-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ5JmocaGzvVEBUeoeB9f%2Fuploads%2F64i3kLYfMXszeklnooEY%2F5.png?alt=media&#x26;token=03a0f817-4af1-4674-a3ca-38a165361bc1" alt=""><figcaption></figcaption></figure>

2\. Następna zakładka do uzupełnienia to `Screenshoots and Videos`, dodajemy pliki jpg i png oraz linki do video z youtube.

<figure><img src="https://2015612490-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ5JmocaGzvVEBUeoeB9f%2Fuploads%2F8xL5YzRWw2P9YCOmui8i%2F12.png?alt=media&#x26;token=0bd05e0e-6923-4f5f-b1d2-741f6f16ecd6" alt=""><figcaption></figcaption></figure>

3\. Kolejna zakładka `News and Articles` wypełniamy zgodnie z danymi z [formularza](https://docs.google.com/forms/d/e/1FAIpQLSfEVACKhtJabmBxWhY-zzDxklaZBE6MULdfBbBXilVok4ZydQ/viewform?usp=sf_link).

<figure><img src="https://2015612490-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ5JmocaGzvVEBUeoeB9f%2Fuploads%2FxsHvoPsYNLWHoJ8Axw8a%2F13.png?alt=media&#x26;token=598fcbac-025c-49d6-8476-81d648fe0057" alt=""><figcaption></figcaption></figure>

4\. Ostatnia zakłądka nas interesująca to `Custom Fields.` W zakładce tej wypełniamy wymagania sprzętowe dla danej gry. Adres strony i baner.

<figure><img src="https://2015612490-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ5JmocaGzvVEBUeoeB9f%2Fuploads%2FZaecb8jzxB0OJxcipP3r%2F14.png?alt=media&#x26;token=e3e232d1-8bc4-4767-af05-1e811a7dc4f1" alt=""><figcaption></figcaption></figure>

5\. W `Custom Fields` zaznaczamy także bardzo ważne pola dla integracji Launchera z daną grą.

<figure><img src="https://2015612490-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ5JmocaGzvVEBUeoeB9f%2Fuploads%2FvKogy8VnodVWshwuSbiB%2F15.png?alt=media&#x26;token=b07243ea-6b4b-40bf-9c81-3d498487b80b" alt=""><figcaption></figcaption></figure>

* app\_subtitle - opis pod nazwą gry w menu Launchera
* visible\_for - ustawienia roli dla kogo ma być widoczna gra (ustawianie ról będzie w oddzielnym dokumencie)
* redirect\_Ur i cliend\_id - pobierane poprzez <https://id.gameswift.io/swagger/#/oauth/OauthController_postClient>

<figure><img src="https://2015612490-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ5JmocaGzvVEBUeoeB9f%2Fuploads%2FLU19IlRlllfCMXl45Lf7%2FBez%C2%A0tytu%C5%82u.png?alt=media&#x26;token=69ef63d0-c79e-46e1-a758-497604c356c9" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2015612490-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ5JmocaGzvVEBUeoeB9f%2Fuploads%2FNJIkcp7ezUOe3LLAkBtD%2FPrzechwytywanie.PNG?alt=media&#x26;token=8bc59be3-bd27-461e-b769-efa08a4eeaf4" alt=""><figcaption></figcaption></figure>

* ID\_game - lista gier dostępna pod [https://platform.gameswift.io/swagger#/default/GamesController\_findAll](https://dev-platform.gameswift.io/swagger#/default/GamesController_findAll). <mark style="color:red;">**UWAGA!!!**</mark> (jeśli nie mamy stworzonej gry przechodzimy do rozdziału [Dodawanie danych gry do API](https://addgame.gameswift.io/dodawanie-danych-gry-przez-api-platformy-platforma).

<figure><img src="https://2015612490-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ5JmocaGzvVEBUeoeB9f%2Fuploads%2FtAq4txdvTasGa6v814QD%2F17.png?alt=media&#x26;token=44961a27-cdb4-4ab9-a8da-a5b51e27f8e8" alt=""><figcaption></figcaption></figure>

6\. Pozostaje nam na koniec [przypisanie ról](https://addgame.gameswift.io/zarzadzanie-rolami-gra-branch-user) (gra->branch->user), aby dać dostęp do gier użytkownikom poprzez aplikację launcher.&#x20;