Projekty użytkownika
Możesz używać TrashSim we własnym projekcie. TrashSim pozwala na automatyczne wczytywanie danych gracza, które będą użyte do symulacji walk.
Użyj klucza API
Aby automatycznie wczytać dane obrońcy, użyj podanego adresu URL, zawierającego 1 wymagany parametr i opcjonalnie język.:
- https://trashsim.universeview.be/?SR_KEY={KEY}
- https://trashsim.universeview.be/{LANG}?SR_KEY={KEY}
Parametry:
{KEY} (wymagany) - powinien zostać zastąpiony przez klucz SR, który znajduje się za przyciskiem API we wiadomościach raportów szpiegowskich.
{LANG} (opcjonalne) - może zostać zastąpione językiem wspieranym przez TrashSim. Jest to korzystne dla międzynarodowych użytkowników. (wspierane języki)
Przykład:
https://trashsim.universeview.be/en?SR_KEY=sr-en-680-fc3b242fb73e700f3da54748844d90506a0cd705
Użyj funkcji wstępnego wypełniania
Możliwe jest również automatyczne wczytywanie większej ilości graczy poprzez "base64" zakodowane za pomocą ciągu JSON. Aby to zrobić, możesz użyć adresu URL. Zwróć uwagę na użycie znaku "hash" (#) a nie znaku zapytania (?). Ta metoda zabezpiecza nasz system buforowania:
- https://trashsim.universeview.be/#prefill={BASE64JSON}
- https://trashsim.universeview.be/{LANG}#prefill={BASE64JSON}
Parametry:
{BASE64JSON} (wymagane) - powinien zostać zastąpiony poprzez "base64" zakodowany za pomocą ciągu JSON. Format zostanie przedstawiony poniżej.
{LANG} (opcjonalne) - może zostać zastąpione językiem wspieranym przez TrashSim. Jest to korzystne dla międzynarodowych użytkowników. (wspierane języki)
Format JSON:
JSON jest praktycznie samo-wytłumaczalny. Może zawierać 3 właściwości:
- 0 -> Zawiera drużynę atakujących, tablicę atakujących graczy.
- 1 -> Zawiera drużynę obrońców, tablicę graczy obrońców.
- settings -> Zawiera ustawienia serwera.
Elementy gracza zawierają następujące właściwości, które są opcjonalne, surowce, badania, statki, obronę i planetę. Nazwy badań, statków i obrony są ustawiane przez ich identyfikator (ID).
Drużyna może zawierać tylu graczy, ilu chcesz. Oczywiście możesz wysłać maksymalnie 16 flot, więc dodawanie większej ilości nie jest potrzebne. W drużynie obrońców, pierwszym graczem w tabeli będzie główny obrońca, który może posiadać obronę i surowce. Poniżej znajdziesz 2 tabele. Pierwsza tabela wyjaśnia właściwości obiektów gracza, natomiast druga tabela posiada ustawienia.
| Główna właściwość | Nadrzędna właściwość | Wartość | Przykład |
|---|---|---|---|
| class * | 0 ... 3 | 0 | |
| resources | metal | integer | 100 |
| crystal | integer | 50 | |
| deuterium | integer | 10 | |
| research | 106 | {"level": integer} | {"level": 10} |
| ... | |||
| 199 | {"level": integer} | {"level": 4} | |
| ships | 202 | {"count": integer} | {"count": 1347} |
| ... | |||
| 219 | {"count": integer} | {"count": 453} | |
| defence | 401 | {"count": integer} | {"count": 2794} |
| ... | |||
| 503 | {"count": integer} | {"count": 20} | |
| planet | galaxy | integer | 3 |
| system | integer | 287 | |
| position | integer | 11 | |
| speed | integer | 80 | |
* The class property supports 4 values: 0, 1, 2, 3. Being: 0: no class, 1: Collector, 2: General, 3: Discoverer.
Oczywiście musisz dodać właściwości, które potrzebujesz. Na przykład: gracz atakujący nie potrzebuje surowców i obrony a główny obrońca nie potrzebuje prędkości i technologii napędów. Dla badań, działać będą tylko napędy jak i technologie bojowe (+ ochronna) oraz opancerzenie.
Ustawienia mają następujące właściwości, które są wymagane z wyjątkiem grabierzy i symulacji.
| Właściwość | Wartość | Przykład |
|---|---|---|
| speed_fleet | integer | 2 |
| galaxies | integer | 7 |
| systems | integer | 499 |
| rapid_fire | integer | 1 |
| def_to_tF | 0 or 1 | 0 |
| debris_factor | 0.0 to 1.0 | 0.3 |
| repair_factor | 0.0 to 1.0 | 0.7 |
| donut_galaxy | 0 or 1 | 1 |
| donut_system | 0 or 1 | 1 |
| plunder | 50, 75 or 100 | 75 |
| simulations | 1 to ... | 15 |
| characterClassesEnabled | 0 or 1 | 1 |
| minerBonusFasterTradingShips | integer (%) | 100 |
| minerBonusIncreasedCargoCapacityForTradingShips | integer (%) | 25 |
| warriorBonusFasterCombatShips | integer (%) | 100 |
| warriorBonusFasterRecyclers | integer (%) | 100 |
| warriorBonusRecyclerFuelConsumption | integer (%) | 25 |
| combatDebrisFieldLimit | integer (%) | 25 |
Przykład JSON:
{"0":[{"research":{"109":{"level":17},"110":{"level":17},"111":{"level":19},"115":{"level":17},"117":{"level":14},"118":{"level":13}},"ships":{"203":{"count":124},"204":{"count":5342},"206":{"count":1943}},"planet":{"galaxy":1,"system":124,"position":8},"speed":80}],"1":[{"resources":{"metal":5932712,"crystal":3742953,"deuterium":1284233},"research":{"109":{"level":15},"110":{"level":14},"111":{"level":16},"115":{"level":16},"117":{"level":13},"118":{"level":11}},"ships":{"202":{"count":2353},"203":{"count":438}},"defence":{"401":{"count":3842},"402":{"count":1438},"407":{"count":1},"502":{"count":10}},"planet":{"galaxy":2,"system":235,"position":11}}],"settings":{"speed_fleet":"2","galaxies":"7","systems":"499","rapid_fire":"1","def_to_tF":"0","debris_factor":"0.5","donut_galaxy":"1","donut_system":"1","plunder":50,"simulations":15}}
Wartość "base64" powyższego JSON:
eyIwIjpbeyJyZXNlYXJjaCI6eyIxMDkiOnsibGV2ZWwiOjE3fSwiMTEwIjp7ImxldmVsIjoxN30sIjExMSI6eyJsZXZlbCI6MTl9LCIxMTUiOnsibGV2ZWwiOjE3fSwiMTE3Ijp7ImxldmVsIjoxNH0sIjExOCI6eyJsZXZlbCI6MTN9fSwic2hpcHMiOnsiMjAzIjp7ImNvdW50IjoxMjR9LCIyMDQiOnsiY291bnQiOjUzNDJ9LCIyMDYiOnsiY291bnQiOjE5NDN9fSwicGxhbmV0Ijp7ImdhbGF4eSI6MSwic3lzdGVtIjoxMjQsInBvc2l0aW9uIjo4fSwic3BlZWQiOjgwfV0sIjEiOlt7InJlc291cmNlcyI6eyJtZXRhbCI6NTkzMjcxMiwiY3J5c3RhbCI6Mzc0Mjk1MywiZGV1dGVyaXVtIjoxMjg0MjMzfSwicmVzZWFyY2giOnsiMTA5Ijp7ImxldmVsIjoxNX0sIjExMCI6eyJsZXZlbCI6MTR9LCIxMTEiOnsibGV2ZWwiOjE2fSwiMTE1Ijp7ImxldmVsIjoxNn0sIjExNyI6eyJsZXZlbCI6MTN9LCIxMTgiOnsibGV2ZWwiOjExfX0sInNoaXBzIjp7IjIwMiI6eyJjb3VudCI6MjM1M30sIjIwMyI6eyJjb3VudCI6NDM4fX0sImRlZmVuY2UiOnsiNDAxIjp7ImNvdW50IjozODQyfSwiNDAyIjp7ImNvdW50IjoxNDM4fSwiNDA3Ijp7ImNvdW50IjoxfSwiNTAyIjp7ImNvdW50IjoxMH19LCJwbGFuZXQiOnsiZ2FsYXh5IjoyLCJzeXN0ZW0iOjIzNSwicG9zaXRpb24iOjExfX1dLCJzZXR0aW5ncyI6eyJzcGVlZF9mbGVldCI6IjIiLCJnYWxheGllcyI6IjciLCJzeXN0ZW1zIjoiNDk5IiwicmFwaWRfZmlyZSI6IjEiLCJkZWZfdG9fdEYiOiIwIiwiZGVicmlzX2ZhY3RvciI6IjAuNSIsImRvbnV0X2dhbGF4eSI6IjEiLCJkb251dF9zeXN0ZW0iOiIxIiwicGx1bmRlciI6NTAsInNpbXVsYXRpb25zIjoxNX19
Pełny przykład:
Poniższy przykład doda 124 Duże transportery do floty pierwszego agresora oraz ustawi prędkość floty do 2.
https://trashsim.universeview.be/en#prefill=eyIwIjpbeyJzaGlwcyI6eyIyMDMiOnsiY291bnQiOjEyNH19fV0sInNldHRpbmdzIjp7InNwZWVkX2ZsZWV0IjoiMiJ9fQ==
Użyty JSON: {"0":[{"ships":{"203":{"count":124}}}],"settings":{"speed_fleet":"2"}}
Poniżej znajdziesz listę wspieranych języków (domyślnie EN)::