RockDLL: Instructions file for Codex

AGENTS.md - RockDLL Project

Project Overview

This project develops a command-line tool to inject ReShade DLLs into Roco Kingdom (洛克王国) game.

• Game Path: C:\Games\WeGameApps\rail_apps\RocoKingdom(2002304)
• Target EXE: Win64\NRC\Binaries\Win64\NRC-Win64-Shipping.exe
• Graphics: DX11/DX12
• Anti-Cheat: ACE (lenient version)
• Constraint: Modified DLLs CANNOT be placed in game directory

Build Commands

CMake with Ninja (Recommended)

mkdir build && cd build
cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=Release
ninja

CMake with MinGW Makefiles

mkdir build && cd build
cmake .. -G "MinGW Makefiles" -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release

Single Test

cd build
ctest -R <test_name> --output-on-failure
# Or run directly:
./injector_tests.exe

Lint (if available)

cmake --build build --target lint

Code Style Guidelines

General

• C++17 standard minimum
• Windows-specific code should use #ifdef _WIN32 guards
• 4-space indentation, no tabs
• LF line endings (.gitattributes enforces this)

Naming Conventions

Element	Style	Example
Classes	PascalCase	DllInjector
Structs	PascalCase	ProcessInfo
Functions	PascalCase	InjectDll
Variables	camelCase	targetPid
Constants	kebab-case	MAX_PATH_LENGTH
Private members	m_ prefix	m_hProcess
Enums	PascalCase	InjectionMethod
Enum values	PascalCase	InjectionMethod::Manual

Headers & Imports

// Order: associated header, C standard, C++ standard, third-party, project
#include "dll_injector.h"
#include <windows.h>
#include <string>
#include <vector>
#include <tlhelp32.h>

Error Handling

• Use std::optional<T> for nullable returns
• Throw std::runtime_error for critical failures
• Log errors with severity levels: ERROR, WARN, INFO, DEBUG
• Always check Win32 API return values

Types

• Use DWORD, HANDLE, LPVOID for Windows types
• Use uint32_t, int64_t for portable integers
• Prefer std::string over char*
• Use std::vector<uint8_t> for binary data