About • Getting Started • Usage • Scripting API Documentation • Change Logs • Libraries • License • Todo

Branch	Status	Commit Count	Last Commit
master

Provides a scripting framework and API for the game Genshin Impact.

• GSF is not a cheat/hack. GSF does not contain any "advantage" enchancement features built in. GSF only provides a framework and API to its users.
• The contributors of this repository/project/software bear no responsibility on whatever purpose the user does with this.

• Windows
• DirectX 11 SDK
• Visual Studio 2019 or greater
• Git

This requires Git. If you don't have Git yet you can download it here.

• If you are planning on contributing or want access to the repo's history locally:

  git clone https://github.com/u16rogue/genshin-scripting-framework.git

• If you only want to compile and use GSF:

  git clone --depth 1 https://github.com/u16rogue/genshin-scripting-framework.git

• gsf-client - The client that's loaded into the game, this provides the scripting API and ability to load LUA scripts.
• gsf-launcher - (optional) Used for launching the game and loading gsf-client into it. Requires gsf-client to be built (This is already set up in the project as a dependency).

The project is ready to compile immediately, you can proceed by opening the solution file, set up the configuration (Release x64), and start building.

If you get an error regarding a missing macro (GIT_HASH and GIT_BRANCH) and a header file (git_info.h), simply build the project once and it should fix the problem. The macro and header file is automatically generated pre-build.

The built binaries are located at build\Release_x64 for release builds and build\Debug_x64 for debug builds.

• Microsoft Visual C++ Redistributable for Visual Studio 2019
• (optional) Bypass for mhyprot2

General usage of GSF is by injecting gsf-client.dll to GenshinImpact.exe. Upon successful injection a top menu bar should appear ingame where you can access GSF's features.

You can also use gsf-launcher to load GSF to Genshin Impact. if you are using this method make sure that the game is currently not running and to execute the launcher with administrator privilege.

Note: gsf-launcher does NOT disable the anti-cheat mhyprot2. GSF might load in-game but the anti-cheat is still active in the background, do also take note that both the launcher and client do not provide evasion against detection (if any is in place anyway).

Lua Scripts can be loaded through the Script Manager window which can be accessed by opening the Genshin Scripting Framework dropdown on the top menu bar. Inside the Script Manager window you can import Lua scripts through the Import dropdown, upon a successful import the script should appear in the window's list where a button is provided for loading the script.

You can either use the DELETE key or the Shutdown option under GSF's dropdown on the top menu bar.

• MinHook 1.3.3 - TsudaKageyu
• Dear ImGui 1.80 - ocornut
• Lua 5.4.3 - Lua org, PUC-Rio
• sol2 3.2.2 - Rapptz, ThePhD, and contributors

GNU General Public License 3.0

• xlua interfacing from GSF
• imported script list persistence
• autoexec lua