# NaResolver

**Repository Path**: midterm/NaResolver

## Basic Information

- **Project Name**: NaResolver
- **Description**: 轻量化的Unity游戏插件开发框架，给你带来极佳的体验
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2023-07-23
- **Last Updated**: 2023-07-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: il2cpp, hack

## README

#  NaResolver

"轻量化的Unity游戏插件开发框架，给你带来极佳的体验."

------

| [介绍](#介绍) - [特点](#特点) - [如何使用](#如何使用) - [实现原理](#实现原理) - [协议](#协议) |
| :----------------------------------------------------------: |
|                [English Readme](README.en.md)                |

### 介绍

**NaResolver**是**Perfect**团队下子项目**NaLibrary**中为插件开发研发的一款轻量化开发框架. 

包括**NaResolver**在内的**NaLibrary**项目全部开源并以**MIT**为开源协议.

### 特点

"NaResolver"是一个由C++语言编写的轻量化的UnityEngine游戏插件项目框架

"NaResolver"有强劲兼容性

- 快速初始化
- 较好的兼容性
- 支持x64与x86
- 同时拥有 Mono 适配版本
- 支持 Il2Cpp29+ 版本

### 如何使用

#### 如何安装框架呢？

```cpp
// 引入例子 (需要使用Il2CppType时):
#include <NaResolver/Types/27.2-2021.1.0-2021.1.99+.h>
#include <NaResolver/NaResolver.h>
// 注意: 版本文件必须要早于核心文件引入

// 引入例子 (不需要使用Il2CppType时):
#define __NARESOLVER_ONLY_API
#include <NaResolver/NaResolver.h>
```
``27.2``  : IL2cpp版本

``2021.1.0-2021.1.99+`` : UnityEngine版本

```cpp
NaResolver::Config config;
if(Il2CppResolver->Setup(config))
    return false;
```

#### 要如何获取类和方法呢？

```cpp
// 获取类
Il2CppClass* _class = Il2CppResolver->GetClassEx("assembly", "namespace", "className");
_class = Il2CppResolver->GetClass("(assembly)namespace.className");

// 获取方法
Il2CppResolver->GetMethod(_class, "returnType methodName(parameterType1, parameterType2)");

// 获取字段
Il2CppResolver->GetField(_class, "fieldName");
```

***(注意: 获取方法时参数之间的 ',' 后面有一个空格)***

### 实现原理

通过使用**UnityEngine**引擎在**Runtime**时会暴露**API**的特性来实现获取信息.

**Il2Cpp**暴露的**API**来源于``GameAssembly.dll``.

**Mono**暴露的**API**来源于``mono-2.0-bdwgc.dll``.

协议
-------

**NaResolver**使用MIT协议, 详细见 [LICENSE.txt](LICENSE.txt).