https://github.com/hary309/hry-core
Small framework for creating plugins for Euro Truck Simulator 2 and American Truck Simulator
https://github.com/hary309/hry-core
ats ets2
Last synced: about 2 months ago
JSON representation
Small framework for creating plugins for Euro Truck Simulator 2 and American Truck Simulator
- Host: GitHub
- URL: https://github.com/hary309/hry-core
- Owner: Hary309
- License: mit
- Created: 2020-06-05T21:54:18.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-09-12T17:58:58.000Z (9 months ago)
- Last Synced: 2025-03-24T08:12:53.673Z (2 months ago)
- Topics: ats, ets2
- Language: C++
- Homepage:
- Size: 3.2 MB
- Stars: 19
- Watchers: 2
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# hry-core
hry-core is a small framework that provides many useful tools for creating plugins for **Euro Truck Simulator 2** and **American Truck Simulator**
## Features
- UI and custom rendering based on Dear ImGui (supports DirectX 11 and OpenGL renderer)
- Easy API for creating settings and keybinds
- SCS telemetry wrapped with modern C++
- Access to channels for truck, multiple trailer and job
- Gameplay events
- Configuration callback for truck, multiple trailers and more
- Logger
- Easy access to mouse, keyboard and joystick (but I suggest using keybinds instead)
- API for creating detour and hooks
- And much more!
## Motivation
The idea was to create a simple tool (only for me) which provides simple API for rendering and inputs. In the process of developing it, I was feeling that I can do better so I keep adding more and more features. Now I am in a point where I'm almost satisfied with the API, and I'm ready to publish first alpha.
## SDK
SDK you can download [here](https://github.com/Hary309/hry-core/releases).
## Documentation
Basic documentation is in hpp files, HTML version is [here](docs/html/index.html)
Usage of API you can find here: [example](example) and [hry-sic](https://github.com/Hary309/hry-sic)
Tutorials are in progress
## This isn't binding of game
This mod isn't like FiveM or MTA:SA, you still have to reverse engineer and hook the game on your own, to help you with that, **hry-core** provides some useful tools (Detour, Pattern scanning, vtable hooks)
## How to use it
(This section isn't complete)
hry-core publicly available is compiled with clang-cl (Clang 11 rc5 and MSVC 19.27), so you can link with it
## TODO List
- Refactor the API and code
- Documentation and tutorials
- support for loading images
- Support for XInput (figure out how to identify devices)
- API for controller's axis (easy binding and usage like keybinds)