Felhasználói projektek
Te felhasználhatod a TrashSim-et a saját projektedhez. A TrashSim lehetővé teszi az automatikus játékosadat betöltését, ami csaták szimulálására lesz használva.
Az API kulcs használata
Hogy automatikusan betöltsd a védő fél adatait, alkalmazni tudod a következő linket ami tartalmaz egy szükséges paramétert, illetve opcionálisan az oldal nyelvét:
- https://trashsim.universeview.be/?SR_KEY={KEY}
- https://trashsim.universeview.be/{LANG}?SR_KEY={KEY}
Paraméterek:
{KEY} (szükséges) - ezt helyettesítened kell a kémjelentésben található API gomb alatt található kulccsal.
{LANG} (opcionális) - helyettesíthető egy, a TrashSim által támogatott nyelvvel. Ez előnyt jelenthet a nemzetközi felhasználóknak. (támogatott nyelvek)
Példa:
https://trashsim.universeview.be/en?SR_KEY=sr-en-680-fc3b242fb73e700f3da54748844d90506a0cd705
Előtöltés használata
Szintén lehetséges több játékos automatikus betöltése base64 típusú JSON kód segítségével. Ahhoz, hogy meghívd az alábbi URL-t vedd figyelembe, hogy kettős-keresztet (#) használunk itt és nem pedig kérdőjelet biztonságossá téve a rendszerünket:
- https://trashsim.universeview.be/#prefill={BASE64JSON}
- https://trashsim.universeview.be/{LANG}#prefill={BASE64JSON}
Paraméterek:
{BASE64JSON} (szükséges) - helyettesíteni kell a base64 típusú JSON kóddal, a formátum lentebb van kifejtve.
{LANG} (opcionális) - helyettesíthető egy, a TrashSim által támogatott nyelvvel. Ez előnyt jelenthet a nemzetközi felhasználóknak. (támogatott nyelvek)
JSON formátum:
A JSON meglehetősen érthető, a gyökerének 3 dolgot kell tarlamaznia:
- 0 -> Tartalmazza a támadók csoportját, a támadó játékosok tömbje.
- 1 -> Tartalmazza a védők csoportját, a védő játékosok tömbje.
- settings -> Tartalmazza a szerver beállításait.
A játékos elemeinek az alábbi beállításai vannak, amik közül mindegyik opcionális (Nyersanyagok, kutatás, hajók, védelem, bolygó, sebesség). A kutatások, hajók és védelmi egységek nevei az ID-jük.
Egy csapat annyi játékost tartalmazhat, amennyit csak szeretnél, de mivel maximum 16 flottát küldhetsz, ezért több játékos hozzáadása felesleges. A védekező játékosoknál a tömbben szereplő első játékos lesz az elsődleges védekező, és csak neki lehet védelme, illetve nyersanyaga. Alább található két táblázat, amelyek közül az első tábla tartalmazza a játékos objektumaira vonatkozó információkat, a második pedig a beállításokat.
| Fő tulajdonság | Al-tulajdonság | Érték | Példa |
|---|---|---|---|
| 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.
Természetesen csak azokat a beállításokat kell megadnod, amik szükségese. Például a támadónak nem kell megadni a nyersanyagait illetve a védelmét, és a fő védőnek pedig nem szükséges a sebesség illetve a meghajtó technológiák értékei. Csak a meghajtás és harci fejlesztések lesznek használhatóak.
Az alábbi beállítások összes értéke szükséges, kivéve zsákmányoláshoz és szimulációhoz.
| Tulajdonság | Érték | Példa |
|---|---|---|
| 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 |
JSON Példa:
{"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}}
A fenti JSON kód Base64 értéke:
eyIwIjpbeyJyZXNlYXJjaCI6eyIxMDkiOnsibGV2ZWwiOjE3fSwiMTEwIjp7ImxldmVsIjoxN30sIjExMSI6eyJsZXZlbCI6MTl9LCIxMTUiOnsibGV2ZWwiOjE3fSwiMTE3Ijp7ImxldmVsIjoxNH0sIjExOCI6eyJsZXZlbCI6MTN9fSwic2hpcHMiOnsiMjAzIjp7ImNvdW50IjoxMjR9LCIyMDQiOnsiY291bnQiOjUzNDJ9LCIyMDYiOnsiY291bnQiOjE5NDN9fSwicGxhbmV0Ijp7ImdhbGF4eSI6MSwic3lzdGVtIjoxMjQsInBvc2l0aW9uIjo4fSwic3BlZWQiOjgwfV0sIjEiOlt7InJlc291cmNlcyI6eyJtZXRhbCI6NTkzMjcxMiwiY3J5c3RhbCI6Mzc0Mjk1MywiZGV1dGVyaXVtIjoxMjg0MjMzfSwicmVzZWFyY2giOnsiMTA5Ijp7ImxldmVsIjoxNX0sIjExMCI6eyJsZXZlbCI6MTR9LCIxMTEiOnsibGV2ZWwiOjE2fSwiMTE1Ijp7ImxldmVsIjoxNn0sIjExNyI6eyJsZXZlbCI6MTN9LCIxMTgiOnsibGV2ZWwiOjExfX0sInNoaXBzIjp7IjIwMiI6eyJjb3VudCI6MjM1M30sIjIwMyI6eyJjb3VudCI6NDM4fX0sImRlZmVuY2UiOnsiNDAxIjp7ImNvdW50IjozODQyfSwiNDAyIjp7ImNvdW50IjoxNDM4fSwiNDA3Ijp7ImNvdW50IjoxfSwiNTAyIjp7ImNvdW50IjoxMH19LCJwbGFuZXQiOnsiZ2FsYXh5IjoyLCJzeXN0ZW0iOjIzNSwicG9zaXRpb24iOjExfX1dLCJzZXR0aW5ncyI6eyJzcGVlZF9mbGVldCI6IjIiLCJnYWxheGllcyI6IjciLCJzeXN0ZW1zIjoiNDk5IiwicmFwaWRfZmlyZSI6IjEiLCJkZWZfdG9fdEYiOiIwIiwiZGVicmlzX2ZhY3RvciI6IjAuNSIsImRvbnV0X2dhbGF4eSI6IjEiLCJkb251dF9zeXN0ZW0iOiIxIiwicGx1bmRlciI6NTAsInNpbXVsYXRpb25zIjoxNX19
Teljes példa:
Az alábbi példa 124 Nagy Szállítót fog hozzáadni a támadó flottájához, illetve szintén be is állítja a flotta sebességét 2-re.
https://trashsim.universeview.be/en#prefill=eyIwIjpbeyJzaGlwcyI6eyIyMDMiOnsiY291bnQiOjEyNH19fV0sInNldHRpbmdzIjp7InNwZWVkX2ZsZWV0IjoiMiJ9fQ==
JSON használata: {"0":[{"ships":{"203":{"count":124}}}],"settings":{"speed_fleet":"2"}}
A támogatott nyelvek listája alább található (az alapértelmezett az angol)::