NieR:Automata Hook

A C++ library to attach to the NieR:Automata process and read/write memory.

NieRHook Demo
Using NieRHook
 CMake Projects
 Dinamyc Library (.dll)
 Static Library
Build NieRHook
Memory Reference
NieRHook Reference

NieRHook Demo

#include <Windows.h>
#include <TlHelp32.h>
#include <iostream>
#include <thread>
#include "NierHook.hpp"
using namespace std;

//Function used to exit the program
void ENDPressed(NieRHook* hook) {
	while (true) {
		if (GetKeyState(VK_END) & 0x8000) //END button pressed
		{
			//Disable cheats before exiting
			hook->InfiniteDoubleJump(false);
			hook->IgnoreUpgradeMaterials(false);
			//Stop hook
			hook->stop();
			return;//exit function
		}
	}
}

/*This is a showcase program of the hook
* As NieR:Automata is a x64 program, you must compile this solution in x64.
*/
int main()
{
	_CrtSetDbgFlag(_CRTDBG_ALLOC_MEM_DF | _CRTDBG_LEAK_CHECK_DF);//Look for memory leaks

	NieRHook hook;
	cout << "Hooking..." << endl;
	//Hook to process
	while (!hook.isHooked()) {
		hook.start();
	}
	cout << "Hooked" << endl;

	//Enable some cheats
	hook.InfiniteDoubleJump(true);
	hook.IgnoreUpgradeMaterials(true);

	//Add some items
	//For ID reference please visit github.com/Asiern/NieRHook Readme
	hook.addItem(510, 80); //Beast Hide ID => 510
	hook.addItem(0, 10); //Small Recovery => ID 0
	hook.addItem(721, 1); //Data chip B => ID 721
	hook.addItem(400, 99); //E-Drug => ID 400

	//Add some weapons
	hook.addWeapon(0x4D8, 1); //Type-40 Blade => ID 0x4D8
	hook.addWeapon(0x41A, 1); //Type-40 Sword => ID 0x41A

	//Create a thread to exit when the 'END' button is pressed
	std::thread exitThread(ENDPressed, &hook);

	//Print some values
	while (hook.isHooked()) {
		hook.update();//update hook internal values (Position, Health, Level...)
		std::cout << "X: " << hook.getXPosition() << "  Y: " << hook.getYPosition() << "  Z: " << hook.getYPosition() << std::endl;
		std::cout << "Health: " << hook.getHealth() << std::endl;
		std::cout << "Press END to exit..." << std::endl;
		Sleep(500);
		system("cls");
	}

	//Join thread and exit
	exitThread.join();
	return (0);
}

---

Using NieRHook

CMake Projects

Clone NieRHook

git clone https://github.com/Asiern/NieRHook/

Edit your CMakeLists.txt

add_subdirectory(lib/NieRHook)
target_link_libraries(${PROJECT_NAME} NieRHook)
target_include_directories(${PROJECT_NAME} PUBLIC /lib/NieRHook/include)

If you make use of winsock2.h, you need to add the following definition into your CMakeLists.txt

add_definitions(-DUSING_WINSOCK2)

|--- Project/
|       include/
|       lib/
|       |--- NieRHook/
|       |    |   include/
|       |    |   src/
|       |    |   CMakeLists.txt
|       src/
|       CMakeLists.txt

---

Build NieRHook

Requirements:

• CMake
• Microsoft Desktop development with C++ toolkit

Static Library (Default)

set "cmake.configureArgs": [ "-DNIERHOOK_STATIC_LIB=ON" ], at .vscode/setting.json

Dinamyc Link Library

set "cmake.configureArgs": [ "-DNIERHOOK_STATIC_LIB=OFF" ], at .vscode/setting.json

---

Memory Reference

You can find all the used IDs and offsets here

---

NieRHook Reference

Methods

• Start - attach the hook to NieRAutomata.exe process
• Stop - detach the hook from process
• isHooked - return true if hooked
• isSaveLoaded - returns true if a savefile is loaded, otherwise false
• hookStatus - ensures the status of the hook, if processID changes stops the hook
• getProcessID - returns process ID
• update - refresh hook & attributes

Items

• addItem - Adds a specific quantity of items to the inventory (See item IDs at Memory Reference)
• removeItem -Removes item from memory (See item IDs at Memory Reference)
• readInventory - Read all items from memory and returns a vector (See item IDs at Memory Reference)
• addWeapon - Adds a weapon to the inventory (See weapon IDs at Memory Reference)
• removeWeapon - Removes a weapon from the inventory (See weapon IDs at Memory Reference)
• readWeapons - Read all weapons from memory and returns a vector (See item IDs at Memory Reference)

Cheats

• NoClip - enables or disables No Clip
• NoCooldown - enables or disables No Cooldown
• InfiniteDoubleJump - enables or disables Infinite Double Jump
• InfiniteAirDash - enables or disables Infinite Air Dash
• IgnoreUpgradeMaterials - enables or disables Ignore Upgrade Materials
• FreeCamera - enables or disables free camera movement
• SetA2Dash - Set A2 type dash
• Set2BDash - Set 2B type dash
• InfiniteBuffDuration - enables or diables Infinite Buff Duration
• SaveAnywhere - enables or disables Save Anywhere
• InfiniteConsumableItems - enables or disables Infinite Consumable Items

Getters

• isSavefileLoaded - returns true if savefile is loaded
• getVersion - retuns game version
• getLevel - returns player's level
• getHealth - returns player's health
• getMaxHealth - returns player's max health
• getFunds - returns player's Funds(G)
• getEXP - returns player's EXP
• getXPosition - returns player's X position
• getYPosition - returns player's Y position
• getZPosition - returns player's Z position
• getMusicVolume - returns music volume
• getSoundEffectVolume - returns sound effect volume
• getVoiceVolume - returns voice volume
• getAudioOutput - returns audio output
• getVoiceChanger - returns voice changer
• getBrightness - returns brightness
• getDistance - returns distance
• getCombatDistance - returns combat distance
• getVerticalRotationSpeed - returns vertical rotation speed
• getHorizontalRotationSpeed - returns horizontal rotation speed
• getHorizontalAutoAdjust - returns horizontal auto adjust
• getVerticalAutoAdjust - returns vertical auto adjust
• getFreeEnemyTracking - returns free enemy tracking
• getZoomSpeed - returns zoom speed
• getPursuitSpeed - returns pursuit speed
• getLockedEnemyTracking - returns locked enemy tracking
• getHUDOpacity - return HUD opacity

Setters

• setPosition - sets the position of the player
• setHealth - sets player health
• setGameSpeed - sets game speed
• setHUDOpacity - sets the opacity of the HUD
• setColor - sets RGBColor combination
• setMusicVolume - sets music volume
• setSoundEffectVolume - sets sound effect volume
• setVoiceVolume - sets voice volume
• setAudioOutput - sets audio output
• setVoiceChanger - sets voice changer
• setBrightness - sets brightness
• setDistance - sets distance
• setCombatDistance - sets combat distance
• setVerticalRotationSpeed - sets vertical rotation speed
• setHorizontalRotationSpeed - sets horizontal rotation speed
• setHorizontalAutoAdjust - sets horizontal auto adjust
• setVerticalAutoAdjust - sets vertical auto adjust
• setFreeEnemyTracking - sets free enemy tracking
• setZoomSpeed - sets zoom speed
• setPursuitSpeed - sets pursuit speed
• setLockedEnemyTracking - sets locked enemy tracking
• setColor - sets color