Skip to content

Latest commit

 

History

History
239 lines (193 loc) · 7.34 KB

README.md

File metadata and controls

239 lines (193 loc) · 7.34 KB
Raw

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