Utenti Sviluppatori
Hai la possibilità di inserire TrashSim nel tuo progetto. TrashSim permette di acquisire automaticamente i dati del giocatore che verranno usati per simulare una battaglia.
Usa il codice "API"
Per caricare automaticamente il difensore puoi selezionare i seguenti URL ed includere il parametro richiesto e facoltativamente anche la lingua:
- https://trashsim.universeview.be/?SR_KEY={KEY}
- https://trashsim.universeview.be/{LANG}?SR_KEY={KEY}
Parametri:
{KEY} (richiesto) - deve essere rimpiazzato dal codice "API" che si trova dietro al bottone omonimo contenuto nei messaggi dei rapporti di spionaggio.
{LANG} (facoltativo) - può essere rimpiazzato con una lingua supportata da TrashSim, questo può essere un vantaggio per i tuoi utenti internazionali. (lingue supportate)
Esempio:
https://trashsim.universeview.be/en?SR_KEY=sr-en-680-fc3b242fb73e700f3da54748844d90506a0cd705
Utilizzare la funzione di pre-riempimento
E' anche possibile caricare automaticamente più giocatori attraverso una stringa JSON codificata in Base64. Per fare questo puoi digitare il seguente URL, per favore prendi nota che noi usiamo un cancelleto (#) qui e non un punto interrogativo, poiché questo metodo assicura il nostro sistema di utilizzo della cache:
- https://trashsim.universeview.be/#prefill={BASE64JSON}
- https://trashsim.universeview.be/{LANG}#prefill={BASE64JSON}
Parametri:
{BASE64JSON} (richiesto) - andrebbe rimpiazzato dalla stringa JSON codificata in Base64 il cui formato sarà spiegato sotto.
{LANG} (facoltativo) - può essere rimpiazzato con una lingua supportata da TrashSim, questo può essere un vantaggio per i tuoi utenti internazionali. (lingue supportate)
Formato JSON:
Il codice JSON si spiega da solo, la root può contenere 3 proprietà:
- 0 -> Contiene la parte attaccante, un'insieme dei giocatori attaccanti.
- 1 -> Contiene la parte che difende, un'insieme dei giocatori difensori.
- settings -> Contiene le opzioni del server.
L'elemento del giocatore ha le seguenti proprietà, tutte facoltative: le risorse, le ricerche, le navi, le difese ed il pianeta. Il nome della ricerca, le navi e le proprietà delle difese sono impostati dagli ID delle tecnologie.
Un ACS può contenere tanti giocatori quanti ne desideri, ma ovviamente tu saprai benissimo che solamente un massimo di 16 flotte saranno inviabili, pertanto aggiungerne di più non serve. Negli ACS difensivi il primo giocatore del gruppo è il difensore principale, cioè colui che può possedere difese e risorse. Sotto troverai 2 tabelle, nella prima tabella sono spiegate le proprietà degli oggetti dei giocatori e nella seconda tabella le proprietà delle impostazioni.
| Proprietà principali | Proprietà Secondarie | Valori | Esempio |
|---|---|---|---|
| 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.
Certamente avrai bisogno di inserire le proprietà dei giocatori solo dove loro hanno veramente senso di esistere. Per esempio un attaccante non potrà avere risorse e difese e il difensore principale non ha bisogno di avere la velocità e le tecnologie dei motori. Come per le ricerche, solo le tecnologie dei motori e di combattimento funzioneranno.
La proprietà delle impostazioni invece sono tutte sempre richieste , tranne per il bottino e le simulazioni.
| Proprietà | Valori | Esempio |
|---|---|---|
| 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 di esempio:
{"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}}
Valori Base64 del JSON più in alto:
eyIwIjpbeyJyZXNlYXJjaCI6eyIxMDkiOnsibGV2ZWwiOjE3fSwiMTEwIjp7ImxldmVsIjoxN30sIjExMSI6eyJsZXZlbCI6MTl9LCIxMTUiOnsibGV2ZWwiOjE3fSwiMTE3Ijp7ImxldmVsIjoxNH0sIjExOCI6eyJsZXZlbCI6MTN9fSwic2hpcHMiOnsiMjAzIjp7ImNvdW50IjoxMjR9LCIyMDQiOnsiY291bnQiOjUzNDJ9LCIyMDYiOnsiY291bnQiOjE5NDN9fSwicGxhbmV0Ijp7ImdhbGF4eSI6MSwic3lzdGVtIjoxMjQsInBvc2l0aW9uIjo4fSwic3BlZWQiOjgwfV0sIjEiOlt7InJlc291cmNlcyI6eyJtZXRhbCI6NTkzMjcxMiwiY3J5c3RhbCI6Mzc0Mjk1MywiZGV1dGVyaXVtIjoxMjg0MjMzfSwicmVzZWFyY2giOnsiMTA5Ijp7ImxldmVsIjoxNX0sIjExMCI6eyJsZXZlbCI6MTR9LCIxMTEiOnsibGV2ZWwiOjE2fSwiMTE1Ijp7ImxldmVsIjoxNn0sIjExNyI6eyJsZXZlbCI6MTN9LCIxMTgiOnsibGV2ZWwiOjExfX0sInNoaXBzIjp7IjIwMiI6eyJjb3VudCI6MjM1M30sIjIwMyI6eyJjb3VudCI6NDM4fX0sImRlZmVuY2UiOnsiNDAxIjp7ImNvdW50IjozODQyfSwiNDAyIjp7ImNvdW50IjoxNDM4fSwiNDA3Ijp7ImNvdW50IjoxfSwiNTAyIjp7ImNvdW50IjoxMH19LCJwbGFuZXQiOnsiZ2FsYXh5IjoyLCJzeXN0ZW0iOjIzNSwicG9zaXRpb24iOjExfX1dLCJzZXR0aW5ncyI6eyJzcGVlZF9mbGVldCI6IjIiLCJnYWxheGllcyI6IjciLCJzeXN0ZW1zIjoiNDk5IiwicmFwaWRfZmlyZSI6IjEiLCJkZWZfdG9fdEYiOiIwIiwiZGVicmlzX2ZhY3RvciI6IjAuNSIsImRvbnV0X2dhbGF4eSI6IjEiLCJkb251dF9zeXN0ZW0iOiIxIiwicGx1bmRlciI6NTAsInNpbXVsYXRpb25zIjoxNX19
Esempio completo:
L'esempio che segue aggiungerà 124 Cargo Pesanti alla flotta del primo attaccante ed inoltre imposterà a 2 la velocità della flotta dalle impostazioni.
https://trashsim.universeview.be/en#prefill=eyIwIjpbeyJzaGlwcyI6eyIyMDMiOnsiY291bnQiOjEyNH19fV0sInNldHRpbmdzIjp7InNwZWVkX2ZsZWV0IjoiMiJ9fQ==
JSON usato: {"0":[{"ships":{"203":{"count":124}}}],"settings":{"speed_fleet":"2"}}
Sotto troverai una lista delle lingue supportate (quella impostata di default è l'inglese)::