Userprojekte
Du kannst TrashSim in deinem eigenen Projekt benutzen. TrashSim erlaubt ein automatisches Laden von Spielerdaten, welche dann für die Simulation des Kampfes verwendet werden.
Benutze den API-Key
Für das automatische Laden des Verteidigers kannst du die folgende URL benutzen, eingeschlossen eines notwendigen Parameters und einer optionalen Sprache:
- https://trashsim.universeview.be/?SR_KEY={KEY}
- https://trashsim.universeview.be/{LANG}?SR_KEY={KEY}
Parameter:
{KEY} (benötigt) - sollte mit dem SR-Key ersetzt werden, welcher hinter dem API-Button in den Spionageberichten zu finden ist.
{LANG} (optional) - kann mit der von TrashSim unterstützten Sprache ersetzt werden. Dies kann für deine internationalen Nutzer von Vorteil sein. (unterstützte Sprachen)
Beispiel:
https://trashsim.universeview.be/en?SR_KEY=sr-en-680-fc3b242fb73e700f3da54748844d90506a0cd705
Benutze das Prefill-Feature
Es ist ebenso möglich mehrere Spieler auf einmal zu laden, indem man einen base64 kodierten JSON String benutzt. Um dies zu tun, kannst du die folgende URL benutzen. Bitte beachte, dass wir hier einen Hash (#) benutzen und kein Fragezeichen, dies sichert unser Caching System:
- https://trashsim.universeview.be/#prefill={BASE64JSON}
- https://trashsim.universeview.be/{LANG}#prefill={BASE64JSON}
Parameter:
{BASE64JSON} (benötigt) - sollte mit dem base64 kodierten JSON String ersetzt werden. Das Format wird unten erklärt.
{LANG} (optional) - kann mit der von TrashSim unterstützten Sprache ersetzt werden. Dies kann für deine internationalen Nutzer von Vorteil sein. (unterstützte Sprachen)
JSON Format:
JSON ist ziemlich selbsterklärend, der Ursprung kann 3 Eigenschaften enthalten:
- 0 -> Beinhaltet die Angreifer, ein Array von angreifenden Spielern.
- 1 -> Beinhaltet die Verteidiger, ein Array von verteidigenden Spielern.
- settings -> Beinhaltet die Servereinstellungen.
Das Spielerelement hat die folgenden Eigenschaften, welche alle optional sind: Ressourcen, Schiffe, Verteidigung & Planet. Der Name der Forschung, Schiffs- und Verteidigungseigenschaften sind durch die Technologie ID's bestimmt.
Eine Party kann so viele Spieler beinhalten wie du möchtest, aber natürlich weißt du, dass man maximal 16 Flotten schicken kann, also ist es nicht notwendig mehr hinzuzufügen. Bei der verteidigenden Party ist das erste Spielerobjekt in dem Array der Hauptverteidiger, welcher Verteidigung und Ressourcen haben kann. Darunter wirst 2 Tabellen finden - die Erste erklärt die Eigenschafen der Spielerobjekte und die zweite Tabelle die Einstellungseigenschaften.
| Haupteigenschaft | Untereigenschaft | Wert | Beispiel |
|---|---|---|---|
| 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.
Natürlich wirst du nur die Eigenschaften hinzufügen müssen, welche dort auch Sinn machen. Zum Beispiel: Ein Angreifer wird nicht die Ressourcen- & Verteidigungseigenschaften und der Hauptverteidiger nicht die Geschwindigkeits- & Triebwerkseigenschaften benötigen. Für die Forschungen werden nur die Antriebs- und Kampftechnologien funktionieren.
Die Einstellungeseigenschaft hat die folgenden Eigenschaften, welche alle benötigt werden, außer Beute & Simulationen.
| Eigenschaft | Wert | Beispiel |
|---|---|---|
| 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 Beispiel:
{"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 Wert des obigen JSON:
eyIwIjpbeyJyZXNlYXJjaCI6eyIxMDkiOnsibGV2ZWwiOjE3fSwiMTEwIjp7ImxldmVsIjoxN30sIjExMSI6eyJsZXZlbCI6MTl9LCIxMTUiOnsibGV2ZWwiOjE3fSwiMTE3Ijp7ImxldmVsIjoxNH0sIjExOCI6eyJsZXZlbCI6MTN9fSwic2hpcHMiOnsiMjAzIjp7ImNvdW50IjoxMjR9LCIyMDQiOnsiY291bnQiOjUzNDJ9LCIyMDYiOnsiY291bnQiOjE5NDN9fSwicGxhbmV0Ijp7ImdhbGF4eSI6MSwic3lzdGVtIjoxMjQsInBvc2l0aW9uIjo4fSwic3BlZWQiOjgwfV0sIjEiOlt7InJlc291cmNlcyI6eyJtZXRhbCI6NTkzMjcxMiwiY3J5c3RhbCI6Mzc0Mjk1MywiZGV1dGVyaXVtIjoxMjg0MjMzfSwicmVzZWFyY2giOnsiMTA5Ijp7ImxldmVsIjoxNX0sIjExMCI6eyJsZXZlbCI6MTR9LCIxMTEiOnsibGV2ZWwiOjE2fSwiMTE1Ijp7ImxldmVsIjoxNn0sIjExNyI6eyJsZXZlbCI6MTN9LCIxMTgiOnsibGV2ZWwiOjExfX0sInNoaXBzIjp7IjIwMiI6eyJjb3VudCI6MjM1M30sIjIwMyI6eyJjb3VudCI6NDM4fX0sImRlZmVuY2UiOnsiNDAxIjp7ImNvdW50IjozODQyfSwiNDAyIjp7ImNvdW50IjoxNDM4fSwiNDA3Ijp7ImNvdW50IjoxfSwiNTAyIjp7ImNvdW50IjoxMH19LCJwbGFuZXQiOnsiZ2FsYXh5IjoyLCJzeXN0ZW0iOjIzNSwicG9zaXRpb24iOjExfX1dLCJzZXR0aW5ncyI6eyJzcGVlZF9mbGVldCI6IjIiLCJnYWxheGllcyI6IjciLCJzeXN0ZW1zIjoiNDk5IiwicmFwaWRfZmlyZSI6IjEiLCJkZWZfdG9fdEYiOiIwIiwiZGVicmlzX2ZhY3RvciI6IjAuNSIsImRvbnV0X2dhbGF4eSI6IjEiLCJkb251dF9zeXN0ZW0iOiIxIiwicGx1bmRlciI6NTAsInNpbXVsYXRpb25zIjoxNX19
Komplettes Beispiel:
Das Beispiel unten wird 124 Große Transporter für den ersten Angreifer hinzufügen und wird außerdem die Flottengeschwindigkeit in den Einstellungen auf 2 setzen.
https://trashsim.universeview.be/en#prefill=eyIwIjpbeyJzaGlwcyI6eyIyMDMiOnsiY291bnQiOjEyNH19fV0sInNldHRpbmdzIjp7InNwZWVkX2ZsZWV0IjoiMiJ9fQ==
JSON benutzt: {"0":[{"ships":{"203":{"count":124}}}],"settings":{"speed_fleet":"2"}}
Unten wirst du eine Liste der unterstützten Sprachen finden (Standardwert ist en)::