Gebruikers projecten
Je kan TrashSim ook in je eigen project gebruiken. TrashSim laat je toe automatisch speler data in te laden, deze kan dan gebruikt worden om een gevecht te simuleren.
Gebruik de API ccode
Om de verdediger automatisch in te laden kan je de volgende URL gebruiken, inclusief 1 vereiste parameter en een optionele taal:
- https://trashsim.universeview.be/?SR_KEY={KEY}
- https://trashsim.universeview.be/{LANG}?SR_KEY={KEY}
Parameters:
{KEY} (vereist) - moet vervangen worden door de spionage code die je kan vinden achter de `API` knop in het spionage rapport.
{LANG} (optioneel) - kan vervangen worden door een door TrashSim ondersteunde taal, dit kan een voordeel opleveren voor je internationale gebruikers. (ondersteunde talen)
Voorbeeld:
https://trashsim.universeview.be/en?SR_KEY=sr-en-680-fc3b242fb73e700f3da54748844d90506a0cd705
Gebruik de prefill functie
Het is ook mogelijk meerdere spelers in te laden via een base64 gecodeerde JSON string. Om dit te doen kan je de volgende URL gebruiken, let er wel op dat we hier een hash (#) gebruiken en geen vraagteken, deze methode zorgt ervoor dat ons caching systeem goed blijft werken:
- https://trashsim.universeview.be/#prefill={BASE64JSON}
- https://trashsim.universeview.be/{LANG}#prefill={BASE64JSON}
Parameters:
{BASE64JSON} (vereist) - moet vervangen worden door de base64 gecodeerde JSON string, het formaat hiervan bespreken we hieronder.
{LANG} (optioneel) - kan vervangen worden door een door TrashSim ondersteunde taal, dit kan een voordeel opleveren voor je internationale gebruikers. (ondersteunde talen)
JSON formaat:
De JSON is redelijk simpel, de basis kan 3 onderdelen bevatten:
- 0 -> Bevat het aanvallende team, een lijst van de aanvallende spelers.
- 1 -> Bevat het verdedigende team, een lijst van de verdedigende spelers.
- settings -> Bevat de universum instellingen.
Het speler onderdeel kan de volgende eigenschappen hebben en deze zijn allemaal optioneel, grondstoffen, onderzoek, schepen, verdediging & planeet. De namen van de onderzoeken, schepen en verdedigingen worden aangegeven door hun technologie ID.
Een partij kan zoveel spelers bevatten als je zelf wilt. Natuurlijk is het maar mogelijk om maximaal 16 vloten te versturen, dus meer dan 16 toevoegen is niet nodig. In de verdedigende partij is de eerste speler de verdediger met de planeet, deze kan verdediging en grondstoffen hebben. Hieronder vind je 2 tabellen, de eerste tabel geeft je een idee van de eigenschappen van het speler object, de tweede tabel gaat over de instellingen.
| Basis onderdeel | Sub onderdeel | Waarde | Voorbeeld |
|---|---|---|---|
| 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.
Natuurlijk moet je deze alleen toevoegen waar ze logisch zijn. Bijvoorbeeld: een aanvaller heeft geen grondstoffen en verdediging, de eerste verdediger heeft geen snelheid en motor eigenschappen nodig. Voor het onderzoek werken alleen de aandrijvings- en gevechtsonderzoeken.
Het instellingen onderdeel heeft de volgende eigenschappen, deze zijn allemaal verplicht behalve buit & simulaties.
| Eigenschap | Waarde | Voorbeeld |
|---|---|---|
| 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 voorbeeld:
{"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}}
Base64 waarde van de bovenstaande JSON:
eyIwIjpbeyJyZXNlYXJjaCI6eyIxMDkiOnsibGV2ZWwiOjE3fSwiMTEwIjp7ImxldmVsIjoxN30sIjExMSI6eyJsZXZlbCI6MTl9LCIxMTUiOnsibGV2ZWwiOjE3fSwiMTE3Ijp7ImxldmVsIjoxNH0sIjExOCI6eyJsZXZlbCI6MTN9fSwic2hpcHMiOnsiMjAzIjp7ImNvdW50IjoxMjR9LCIyMDQiOnsiY291bnQiOjUzNDJ9LCIyMDYiOnsiY291bnQiOjE5NDN9fSwicGxhbmV0Ijp7ImdhbGF4eSI6MSwic3lzdGVtIjoxMjQsInBvc2l0aW9uIjo4fSwic3BlZWQiOjgwfV0sIjEiOlt7InJlc291cmNlcyI6eyJtZXRhbCI6NTkzMjcxMiwiY3J5c3RhbCI6Mzc0Mjk1MywiZGV1dGVyaXVtIjoxMjg0MjMzfSwicmVzZWFyY2giOnsiMTA5Ijp7ImxldmVsIjoxNX0sIjExMCI6eyJsZXZlbCI6MTR9LCIxMTEiOnsibGV2ZWwiOjE2fSwiMTE1Ijp7ImxldmVsIjoxNn0sIjExNyI6eyJsZXZlbCI6MTN9LCIxMTgiOnsibGV2ZWwiOjExfX0sInNoaXBzIjp7IjIwMiI6eyJjb3VudCI6MjM1M30sIjIwMyI6eyJjb3VudCI6NDM4fX0sImRlZmVuY2UiOnsiNDAxIjp7ImNvdW50IjozODQyfSwiNDAyIjp7ImNvdW50IjoxNDM4fSwiNDA3Ijp7ImNvdW50IjoxfSwiNTAyIjp7ImNvdW50IjoxMH19LCJwbGFuZXQiOnsiZ2FsYXh5IjoyLCJzeXN0ZW0iOjIzNSwicG9zaXRpb24iOjExfX1dLCJzZXR0aW5ncyI6eyJzcGVlZF9mbGVldCI6IjIiLCJnYWxheGllcyI6IjciLCJzeXN0ZW1zIjoiNDk5IiwicmFwaWRfZmlyZSI6IjEiLCJkZWZfdG9fdEYiOiIwIiwiZGVicmlzX2ZhY3RvciI6IjAuNSIsImRvbnV0X2dhbGF4eSI6IjEiLCJkb251dF9zeXN0ZW0iOiIxIiwicGx1bmRlciI6NTAsInNpbXVsYXRpb25zIjoxNX19
Volledig voorbeeld:
Het onderstaande voorbeeld zal 124 grote vrachtschepen toevoegen aan de eerste aanvaller zijn vloot en zal ook de vlootsnelheid op 2 instellen.
https://trashsim.universeview.be/en#prefill=eyIwIjpbeyJzaGlwcyI6eyIyMDMiOnsiY291bnQiOjEyNH19fV0sInNldHRpbmdzIjp7InNwZWVkX2ZsZWV0IjoiMiJ9fQ==
Gebruikte JSON: {"0":[{"ships":{"203":{"count":124}}}],"settings":{"speed_fleet":"2"}}
Hieronder vind je een lijst van alle ondersteunde talen (de standaard waarde is en)::