Example script of how to use GTAVMenuBase.
GTAVMenuBase and simpleini are added as submodule in the thirdparty directory.
Note that GTAVMenuBase depends on simpleini (but doesn't do anything to get it, so your project has to)
and expects the directory containing the simpleini/ directory to be in the include directories,
such that #include <simpleini/SimpleIni.h> works.
Similarly, it expects the ScriptHookV_SDK/ directory to be in the include directories,
such that #include <inc/natives.h> works.
The ScriptHookV SDK is in the project repository itself, in thirdparty/ScriptHookV_SDK.
The natives.h files is generated by Dot.'s Native DB,
and is newer than the one included by Alexander Blades' SDK with corrected namespaces.
Once cloned, the project should just build with
- Visual Studio 2022 (17.2 or newer)
- Visual Studio 2019 (16.11.14 or newer) (v142 build tools, /std:c++20)
v2.0.0 of the example is completely rewritten to how my newer scripts use it. A few general concepts:
- Generally, things should be more neatly divided and less of a complete mess.
CScriptMenuwraps theNativeMenu::Menuand calls boilerplate menu code to initialize and check controls.CScriptMenu::CSubmenurepresents a single "menu page".- There is a "script instance" object that can be passed for the menu page to use.
I recommend the following order to get a general grasp of how this example works:
DllMain.cpp- Dll entrypoint and some setup stuffScript.cpp/hpp- Script initializationMenuExampleScript.cpp/hpp- The 'core' logic of the 'script' part which interacts with the game world.MenuExampleMenu.cpp- The menu implementation.
Plenty of comments have been left in the source code files to figure out what the heck everything actually does.
Feel free to use this as a base project, it lends itself pretty well for most purposes and can be easily extended for multiple instances (for NPCs, etc.).
- ikt