Thursday, February 12, 2015

A look on the technical side: Telemetry SDK

Today we would like to talk about something that deviates a bit from the typical posts you see on our blog - we want to shine some light on our Telemetry SDK library and examples of its use for Euro Truck Simulator 2 (the same SDK will be available for American Truck Simulator from day one).



You're probably asking yourself what is that Telemetry thing and what does it really do? The SDK gives modders an easy to use API which grants access to a set of in-game data such as (but not limited to): truck make and model, speed, current gear, map coordinates, current job info, engine RPM, acceleration forces and many more similar stats about your game. All of this data can be used to create various modifications related to the game or even to create a more immersive experience.

The SDK available here requires programming knowledge to use, but our community has already created a number of various projects using our SDK. Let's have a look at some of them:

Telemetry Web Server and Mobile Dashboard


Forum thread
This fan-made add-on gives the player an opportunity to see in-game status via a web page in a browser on a local network. In practice, this means that your tablet or smartphone can serve you as a mobile dashboard display showing your gauges as well as essential trip info, giving you a chance to keep the main screen less cluttered.

Enhanced Force Feedback for Logitech devices


Logitech wheel users may like how this rather technical plugin gives them an ability to achieve enhanced force feedback. This plugin will make your wheel act differently from standard game by adding a compensation for various features seen in modern trucks and a wide set of different responses to when your truck is being driven under more demanding conditions. Author of this mod also offers a set of improvements for gear shifting and transmission - check out the thread above for more information.

Enhanced Truck Sounds


Enthusiasts of roaring engines will appreciate this add-on delivering a louder set of engine and truck noises right into your game, as the aim of this modification is to provide a different take on realistic driving experience by enhancing the game with additional sounds based off truck performance and behavior derived from the telemetry data.

G19 LCD display


This add-on, just like you may have guessed from its name, allows display of various gameplay information using LCD display of your G19 keyboard working similarly as the mobile dashboard mentioned above.

To get started


If you want to get started be sure to check our modding section to download the latest TELEMETRY SDK.

Also you may want to check fan-created GitHub repository containing a live implementation of the API that will help you in getting started creating your own add-ons and plugins for Euro Truck Simulator 2.

Let us know in the comments if you know and like any other telemetry-based projects we have failed to discover ourselves!

66 comments:

  1. This is really amazing! Thank you guys for creating such a great game and for opening it for modders. Great work!

    ReplyDelete
  2. Replies
    1. Grab the latest release from the Github Release page: https://github.com/nlhans/ets2-sdk-plugin/releases

      Installation is easy inside Euro Truck Simulator 2. Place the acquired DLL inside bin/win_x86/plugins/ of your ETS2 installation. It is possible the plugins directory doesn't exists yet (as with every default installation). In that case you need to create the plugins folder. Place the DLL inside the plugins folder.

      You will now notice that each time ETS2 now starts it prompts the SDK has been activated. Unfortunately you have to press OK to this message every time, but it's a small price to pay for the added features that are possible via the SDK.

      Delete
    2. i've done all that i've pressed okay now what do i do?

      Delete
  3. Replies
    1. Bonjour , est ce qu'il faut télécharger une application sur android ? merci

      Delete
  4. I like it.. I hope to see it in a android app

    And the g19 wow.. But is there a way to make it for logitech g510s?

    ReplyDelete
  5. I like it.. I hope to see it in a android app

    And the g19 wow.. But is there a way to make it for logitech g510s?

    ReplyDelete
  6. Background should be 100% black. It'll be amazing on AMOLED screens. :)

    ReplyDelete
  7. Nice work , needed for andriod t2!

    ReplyDelete
  8. dont need it ... we need it better game ,better current work. with not so big lagging

    ReplyDelete
  9. Awsome ! how to install SDK ? Please Tutorial

    ReplyDelete
    Replies
    1. Tutorial is here
      https://github.com/Funbit/ets2-telemetry-server

      Delete
  10. This comment has been removed by the author.

    ReplyDelete
  11. Very very thanks SCS!


    Türkçe konu için buraya bekleniyorsunuz
    http://www.eurotruck2.com/euro-truck-simulator-2-teknik-taraftan-bir-bakis-telemetri-sdk/

    :)

    ReplyDelete
  12. Wow, can't wait to implement these in game! Looking forward to lots of mods based on this.

    ReplyDelete
  13. Instead of making the game better, solving the bugs etc you are losign time getting this ...thing with no use for common user ? Are you out of your minds SCS ?

    ReplyDelete
    Replies
    1. Clearly I was mistaken in thinking that SCS comprised of more than one team which worked on different parts of the game.

      Delete
  14. I would've been nice if you guys mentioned Fanaleds. That's where the telemetry started I believe. This software enables LED displays on currently 15 wheels and/or displays.

    ReplyDelete
  15. THIS WOULD ALSO BE GOOD FOR AND UPDATE TO PUT IN THE TRUCKS.

    ReplyDelete
  16. who can help me with the installation

    ReplyDelete
  17. who needs this telemetry..I NEED more TIGHT roads and parking slots...MORE no need this telemetry

    ReplyDelete
    Replies
    1. Yes, because YOU are the only user and everyone plays the game like YOU do. I find this quite nice, being able to have info on another screen and keeping the game itself UI free.

      Delete
    2. This game have big future , but some things have to be included ... like - chance to see my other trucks on the road and when i past them to see colours of my company and also more statistics - my tickets for red signal for hi speed , too many things still to be done to make this game more realistic , when we can find police car or ambulance on the road ?

      Delete
  18. This comment has been removed by the author.

    ReplyDelete
  19. and download it but where added please

    ReplyDelete
  20. jak zainstalować to na tableta i kompa proszę i pomoc

    ReplyDelete
  21. how can i download this plz help me

    ReplyDelete
  22. I would love to see ability to stream mirror views to tablets

    ReplyDelete
  23. Hola todo muy bueno , una pregunta alguien pudo usar el pluging de sonido en la versión 1.16 y lo del volante es solo para el logitech

    ReplyDelete
  24. The download link and instructions are goes below the second screenshot. Or just click here:
    http://forum.scssoft.com/viewtopic.php?f=41&t=171000

    ReplyDelete
  25. Sounds like the coming of a golden age for sound modders... awesome!

    ReplyDelete
  26. Replies
    1. No need to install, just connect from Safari to the telemetry server:
      https://github.com/Funbit/ets2-telemetry-server

      Delete
  27. czy moglibyście wrzucić tą aplikacje na Sklep gogle Play ?

    ReplyDelete
  28. Jak i gdzie to zainstalować ???
    How to install this ???

    ReplyDelete
  29. Awsome!
    How to install SDK?
    Please Tutorial...

    ReplyDelete
  30. Now of someone can make a GPS mod like the Dashboard we would be all set

    ReplyDelete
  31. What telemetry Fucking, when what you will release the fucking DLC Scandinavia?

    ReplyDelete
    Replies
    1. Seriously?!? If that's the only type of language your limited thinking can come up with, then I suggest you take it elsewhere... be civil, or be quiet!

      Delete
  32. *facepalm*

    anyone can explain to me what the hell is this telemetry lool

    ReplyDelete
  33. Como instalar no telemovel android?

    ReplyDelete
  34. Hello SCS Team, First i have to say, congratulations for Euro Truck Simulator 2 incredible game and all your hard work with other games too, Congratulations! Second, Telemetry SDK will be synchronized with tablets and smartphones? This will be nice, spectacular, wonderful! Imagine where ours and yours, computers stay and assembly a cockpit and a wheel drive, like as Logitech G27, with a tablet 9'pol pull in the, adapted in the "console" as the same in a truck cabin console, Perfect! Excellent Job SCS Team! Sorry about my English and Greetings for Brazil!

    ReplyDelete
  35. i instaled the dsk on my pc but how it work's i dont now i don't see it after i instaled the sdk telemetry --' did sombuddy now what is the problem ?
    greetings

    ReplyDelete
  36. i want this telemetry on my second pc screen how do i do that?

    ReplyDelete
    Replies
    1. I was just thinking the very same thing whilst scrolling through these comments. I have a second screen that sits redundant while playing 99.9% of games, all that screen estate could be used to brilliant effect in a game like this. Imagine if they had implemented proper AI company drivers, and you could monitor them on a live GPS tracking system... that would be immense.

      Delete
    2. Please read the installation guide here
      https://github.com/Funbit/ets2-telemetry-server

      Delete
  37. Here you go guys ets2 telemetry installer http://links.seahavencommunity.com/6744294/ets2-telemetry

    ReplyDelete
  38. With the Mobile Dashboard, I have these error:
    00:00:09.794 : [sdk] prism::sdk::lookup_channel: SCS_U32_NIL is not valid parameter for array channel 'truck.hshifter.select'
    00:00:09.794 : [sdk] prism::sdk::telemetry_register_for_channel: type 1 is not supported by channel 'truck.cruise_control' index 4294967295
    00:00:09.794 : [sdk] prism::sdk::telemetry_register_for_channel: channel 'truck.electric.enabled' index 4294967295 has already callback for type 1
    00:00:09.794 : [sdk] prism::sdk::telemetry_register_for_channel: type 1 is not supported by channel 'truck.light.aux.front' index 4294967295
    00:00:09.794 : [sdk] prism::sdk::telemetry_register_for_channel: type 1 is not supported by channel 'truck.light.aux.roof' index 4294967295
    00:00:09.794 : [sdk] prism::sdk::lookup_channel: channel 'truck.adblue.warning' not found
    00:00:09.794 : [sdk] prism::sdk::telemetry_register_for_channel: type 5 is not supported by channel 'truck.fuel.warning' index 4294967295
    00:00:09.794 : [sdk] prism::sdk::lookup_channel: channel 'truck.adblue' not found
    00:00:09.794 : [sdk] prism::sdk::lookup_channel: channel 'truck.adblue.consumption.average' not found

    The Cruise control doesn't light up

    Does some of you have that issues?

    ReplyDelete
    Replies
    1. Most probably you have incompatible ETS2. It should be 1.15 and later.

      Delete
  39. Can I use this SDK while playing the game on OSX or is it usable with Windows?

    ReplyDelete
  40. hi can someone help me install this on my ipad mini many thanks craig

    ReplyDelete

Spam, offensive, hateful and other inappropriate comments will be removed and authors may be permanently restricted from commenting.

Note: Only a member of this blog may post a comment.