Project settings

安装 NekoRay

确保你已经正确安装了 NekoRay，如果尚未安装，参考 NekoRay 官方文档或社区指南进行安装。

---

配置开发环境

1 安装必要工具

NekoRay 通常依赖以下工具：

• Java JDK：NekoRay 需要 Java 环境来运行，你可以在 Oracle 官方网站 或 Java 官方网站 下载 Java JDK。
• IntelliJ IDEA 或其他支持 Java 开发的 IDE（可选）：如果你使用 IntelliJ IDEA，可以安装 NekoRay 插件来简化配置。

2 设置 Java 环境

在你的操作系统中设置 Java 环境变量，如果你使用的是 Windows，右键点击 This PC，选择 Properties，然后进入 Environment Variables，编辑 PATH 变量，添加 Java 的 bin 文件夹。

---

导入模组项目到 NekoRay

假设你有一个模组项目（如 .jar 文件），你可以将其导入到 NekoRay 中进行反编译和调试。

1 打开 NekoRay

双击 NekoRay 的可执行文件（通常位于 NekoRay 文件夹中）。

2 导入项目

1. 点击菜单栏中的 File > Open > Java Project。
2. 浏览到你的模组 jar 文件，点击 Open。
3. 确认 Extract 或 Inline（根据需求选择）：
   • Extract：将 jar 内容提取到项目目录。
   • Inline：直接在 jar 中反编译，不提取文件。

3 配置项目

• 类路径：确保 NekoRay 可以访问模组的 classpath，如果项目路径不正确，可以手动编辑 NekoRay 的 nekoray.conf 文件，修改 root_dir 或 jar_list。
• 源代码目录：如果需要调试模组源代码，可以将源文件夹添加到 NekoRay 的 source_dir 列表中。

---

配置 NekoRay 插件

NekoRay 提供了许多插件，可以扩展其功能，以下是常用插件的配置示例：

1 安装插件

1. 点击菜单栏中的 File > Settings > Plugins。
2. 点击 Browse，选择 nekoray 文件夹中的插件 jar 文件。
3. 点击 Install。

2 配置插件

根据插件的需求,调整配置参数，某些插件可能需要特定的路径或设置。

---

调试模组

1 运行模组

1. 确认模组项目已正确导入。
2. 点击菜单栏中的 Run > Run。
3. 选择要运行的类或方法。

2 调试

• 点击菜单栏中的 Run > Toggle Breakpoint，设置断点。
• 使用 F5 或 Step Into 进入代码。
• 使用 F7 或 Step Over 进行下一步。

---

分析和反编译

1 反编译模组

1. 点击菜单栏中的 Tools > Reverse Compile。
2. 选择反编译的类或方法。
3. 点击 Reverse Compile，生成反编译文件。

2 分析代码

• 使用 Ctrl + D 或 Insight 查看代码依赖关系。
• 使用 Ctrl + Shift + D 或 Type hierarchy 查看类继承关系。

---

常见问题

• 项目导入失败：检查 jar 文件路径是否正确，确保 NekoRay 有权限读取文件。
• 编译错误：检查 nekoray.conf 文件是否正确配置，特别是 java_exec 和 jar_list。
• 调试慢：优化 Java 环境，确保垃圾回收机制正常。

---

高级配置

1 修改配置文件

NekoRay 的配置文件通常位于 NekoRay 文件夹中的 nekoray.conf 文件。

jar_list=C:/your/module.jar

2 设置调试选项

在 Run/Debug 界面中，可以设置断点、方法过滤和其他调试选项。