{"id":13642840,"url":"https://github.com/brunodmt/ets_ros2","last_synced_at":"2025-04-20T21:31:40.326Z","repository":{"id":113841811,"uuid":"185619646","full_name":"brunodmt/ets_ros2","owner":"brunodmt","description":"ETS2 (Euro Truck Simulator 2) \u0026 ATS (American Truck Simulator) SDK plug-in to publish telemetry data using ROS2","archived":false,"fork":false,"pushed_at":"2019-06-09T19:23:19.000Z","size":2082,"stargazers_count":23,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-09T14:39:16.550Z","etag":null,"topics":["american-truck-simulator","euro-truck-simulator","euro-truck-simulator-2","eurotruck","eurotrucksimulator","robot-operating-system","ros","ros2"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/brunodmt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2019-05-08T14:13:03.000Z","updated_at":"2024-10-31T05:28:13.000Z","dependencies_parsed_at":"2023-05-28T06:45:47.613Z","dependency_job_id":null,"html_url":"https://github.com/brunodmt/ets_ros2","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brunodmt%2Fets_ros2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brunodmt%2Fets_ros2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brunodmt%2Fets_ros2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brunodmt%2Fets_ros2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brunodmt","download_url":"https://codeload.github.com/brunodmt/ets_ros2/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249965522,"owners_count":21352921,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["american-truck-simulator","euro-truck-simulator","euro-truck-simulator-2","eurotruck","eurotrucksimulator","robot-operating-system","ros","ros2"],"created_at":"2024-08-02T01:01:37.075Z","updated_at":"2025-04-20T21:31:39.480Z","avatar_url":"https://github.com/brunodmt.png","language":"C++","funding_links":[],"categories":["C++"],"sub_categories":[],"readme":"# Euro Truck Simulator 2 ROS2 Plugin\n[ETS2 (Euro Truck Simulator 2)](https://eurotrucksimulator2.com/) \u0026 [ATS (American Truck Simulator)](https://americantrucksimulator.com/) SDK plug-in to publish telemetry data using [ROS2](https://index.ros.org/doc/ros2/).\n\n## Project Structure\n\n* **ets_msgs**: Messages definitions\n* **ets_plugin**: ETS/ATS plugin library\n* **ets_cpp_client**: Sample C++ client\n\n## Supported Environment\nThis plugin has been developed in Ubuntu 18.04 using ROS2 Crystal and Euro Truck Simulator 2 (v1.34.0.34s). Instructions may vary when using different versions, but with some luck it should work anyway.\n\nWindows is not currently supported.\n\n## Prerequisites\n* Install **ROS2** following [Installing ROS2 via Debian Packages](https://index.ros.org/doc/ros2/Installation/Linux-Install-Debians/)\n* Install **colcon** following [Colcon Tutorial](https://index.ros.org/doc/ros2/Tutorials/Colcon-Tutorial/)\n* Install **ETS** or **ATS** using **Steam**\n\n## Building instructions\n1. Create a ROS2 worskpace in a location of your choice: `mkdir -p ros2_ws/src`\n2. Clone the repository inside `ros2_ws/src`: `git clone https://github.com/brunodmt/ets_ros2.git`\n3. Source the ROS2 environment setup script, selecting the extension based on your shell: `source /opt/ros/crystal/setup.\u003cshell\u003e`.\n4. From ros2_ws, build the project: `colcon build --symlink-install`.\n   In case you get an error like:\n   ```\n   --- stderr: ets_msgs                         \n   CMake Error at /usr/share/cmake-3.10/Modules/FindPackageHandleStandardArgs.cmake:137 (message):\n     Could NOT find FastRTPS (missing: FastRTPS_INCLUDE_DIR FastRTPS_LIBRARIES)\n   ```\n   run `export CMAKE_PREFIX_PATH=$AMENT_PREFIX_PATH:$CMAKE_PREFIX_PATH` and try again.\n5. Copy the generated plugin library to the ETS folder:\n   ```\n   mkdir  ~/.local/share/Steam/steamapps/common/Euro\\ Truck\\ Simulator\\ 2/bin/linux_x64/plugins\n   cp install/ets_plugin/lib/ets_plugin/libetsros2.so ~/.local/share/Steam/steamapps/common/Euro\\ Truck\\ Simulator\\ 2/bin/linux_x64/plugins/\n   ```\n   or the ATS folder:\n   ```\n   mkdir ~/.local/share/Steam/steamapps/common/American\\ Truck\\ Simulator/bin/linux_x64/plugins\n   cp install/ets_plugin/lib/ets_plugin/libetsros2.so ~/.local/share/Steam/steamapps/common/American\\ Truck\\ Simulator/bin/linux_x64/plugins/\n   ```\n6. Source the generated environment setup script, selecting the extension based on your shell: `source install/setup.\u003cshell\u003e`\n7. Run the client with `./install/ets_cpp_client/bin/ets_cpp_client/ets_cpp_client`\n8. Before running the game for the first time, the **Launch Options** in **Steam** need to be updated:\n   1. Right click the game in your Steam library\n   2. Select properties\n   3. Select `SET LAUNCH OPTIONS...`\n   4. Set it to:\n      ```\n      LD_LIBRARY_PATH=/opt/ros/crystal/opt/yaml_cpp_vendor/lib:/opt/ros/crystal/opt/rviz_ogre_vendor/lib:/opt/ros/crystal/lib:\u003cros2-workspace\u003e/install/ets_msgs/lib:$LD_LIBRARY_PATH %command%\n      ```\n      (making sure to replace `\u003cros2-workspace\u003e` with your ROS2 workspace path.\n9. Run the game\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrunodmt%2Fets_ros2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrunodmt%2Fets_ros2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrunodmt%2Fets_ros2/lists"}