Projets Utilisateurs
Vous pouvez utiliser TrashSim pour votre propre projet. ThrashSim permet le chargement automatique des données du joueur, qui seront utilisées pour simuler un combat.
Utiliser la clé API
Pour charger automatiquement le défenseur, vous pouvez utiliser l'URL suivante, qui inclut 1 paramètre nécessaire et une langue (optionnel):
- https://trashsim.universeview.be/?SR_KEY={KEY}
- https://trashsim.universeview.be/{LANG}?SR_KEY={KEY}
Paramètres:
{KEY} (requis) - doit être replacée par la clé du RE, qui se trouve sous le bouton API dans les messages de rapport d'espionnage.
{LANG} (optionnel) - peut être remplacé par une langue supportée par TrashSim, cela peut être un avantage pour vos utilisateurs internationaux. (langues supportées)
Exemple:
https://trashsim.universeview.be/en?SR_KEY=sr-en-680-fc3b242fb73e700f3da54748844d90506a0cd705
Utiliser la fonction préremplissage
Vous pouvez également charger automatiquement plusieurs joueurs via une chaîne JSON. Pour cela, utilisez l'URL suivante (notez l'utilisation d'un hashtag (#) ici et non un point d'interrogation : cette méthode rend le système de cache plus sécurisé):
- https://trashsim.universeview.be/#prefill={BASE64JSON}
- https://trashsim.universeview.be/{LANG}#prefill={BASE64JSON}
Paramètres:
{BASE64JSON} (requis) - doit être remplacé par une chaîne JSON, le format sera expliqué plus bas.
{LANG} (optionnel) - peut être remplacé par une langue supportée par TrashSim, cela peut être un avantage pour vos utilisateurs internationaux. (langues supportées)
format JSON:
Le format JSON est assez simple a expliquer, la racine peut contenir 3 propriétés:
- 0 -> Contient la partie attaquante, un tableau des joueurs attaquants.
- 1 -> Contient la partie défensive, un tableau des défenseurs.
- settings -> Contient les caractéristiques de l'univers.
L'élément joueur a les propriétés suivantes (optionnelles) : ressources, recherche, vaisseaux, défense et planète. Le nom de la recherche, des vaisseaux et des défenses sont réglés dans l'ID.
Une groupée peut contenir autant de joueurs que vous voulez. Vous ne pouvez envoyer qu'un maximum de 16 flottes, en ajouter davantage est donc inutile. Pour la défense groupée, le premier objet joueur dans le tableau des défenseurs est le défenseur principal, qui peut avoir des défenses et des ressources. En-dessous, vous trouverez deux tableaux : le premier explique les propriétés des objets joueurs et le second est réservé au paramétrage des propriétés.
| Propriété principale | Sous propriété | Valeur | Exemple |
|---|---|---|---|
| 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.
Bien évidemment, vous n'avez besoin d'ajouter que les propriétés aux endroits nécessaires. Par exemple : un attaquant n'aura pas besoin d'avoir des ressources et des défenses et le défenseur principal n'aura pas besoin des propriétés vitesse et combustion. Comme pour les recherches, seules les technologies de vitesse et combat seront nécessaires.
Le tableau des propriétés a les propriétés suivantes qui sont toutes nécessaires sauf chargement & simulations.
| Propriété | Valeur | Exemple |
|---|---|---|
| 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 |
Exemple 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}}
La valeur en base 64 du précédent JSON:
eyIwIjpbeyJyZXNlYXJjaCI6eyIxMDkiOnsibGV2ZWwiOjE3fSwiMTEwIjp7ImxldmVsIjoxN30sIjExMSI6eyJsZXZlbCI6MTl9LCIxMTUiOnsibGV2ZWwiOjE3fSwiMTE3Ijp7ImxldmVsIjoxNH0sIjExOCI6eyJsZXZlbCI6MTN9fSwic2hpcHMiOnsiMjAzIjp7ImNvdW50IjoxMjR9LCIyMDQiOnsiY291bnQiOjUzNDJ9LCIyMDYiOnsiY291bnQiOjE5NDN9fSwicGxhbmV0Ijp7ImdhbGF4eSI6MSwic3lzdGVtIjoxMjQsInBvc2l0aW9uIjo4fSwic3BlZWQiOjgwfV0sIjEiOlt7InJlc291cmNlcyI6eyJtZXRhbCI6NTkzMjcxMiwiY3J5c3RhbCI6Mzc0Mjk1MywiZGV1dGVyaXVtIjoxMjg0MjMzfSwicmVzZWFyY2giOnsiMTA5Ijp7ImxldmVsIjoxNX0sIjExMCI6eyJsZXZlbCI6MTR9LCIxMTEiOnsibGV2ZWwiOjE2fSwiMTE1Ijp7ImxldmVsIjoxNn0sIjExNyI6eyJsZXZlbCI6MTN9LCIxMTgiOnsibGV2ZWwiOjExfX0sInNoaXBzIjp7IjIwMiI6eyJjb3VudCI6MjM1M30sIjIwMyI6eyJjb3VudCI6NDM4fX0sImRlZmVuY2UiOnsiNDAxIjp7ImNvdW50IjozODQyfSwiNDAyIjp7ImNvdW50IjoxNDM4fSwiNDA3Ijp7ImNvdW50IjoxfSwiNTAyIjp7ImNvdW50IjoxMH19LCJwbGFuZXQiOnsiZ2FsYXh5IjoyLCJzeXN0ZW0iOjIzNSwicG9zaXRpb24iOjExfX1dLCJzZXR0aW5ncyI6eyJzcGVlZF9mbGVldCI6IjIiLCJnYWxheGllcyI6IjciLCJzeXN0ZW1zIjoiNDk5IiwicmFwaWRfZmlyZSI6IjEiLCJkZWZfdG9fdEYiOiIwIiwiZGVicmlzX2ZhY3RvciI6IjAuNSIsImRvbnV0X2dhbGF4eSI6IjEiLCJkb251dF9zeXN0ZW0iOiIxIiwicGx1bmRlciI6NTAsInNpbXVsYXRpb25zIjoxNX19
Exemple complet:
L'exemple ci-dessous ajoutera 124 Grands Transporteurs à la flotte du premier attaquant et ajustera la vitesse dans les paramètres à 2.
https://trashsim.universeview.be/en#prefill=eyIwIjpbeyJzaGlwcyI6eyIyMDMiOnsiY291bnQiOjEyNH19fV0sInNldHRpbmdzIjp7InNwZWVkX2ZsZWV0IjoiMiJ9fQ==
JSON utilisé: {"0":[{"ships":{"203":{"count":124}}}],"settings":{"speed_fleet":"2"}}
Vous trouverez ci-dessous une liste des langues supportées (la valeur par défaut est en)::