解决pelican-eggs项目中V Rising服务器BepInEx启动崩溃问题

问题背景

在pelican-eggs项目的V Rising服务器部署过程中，用户遇到了BepInEx启动时崩溃的问题。该问题主要表现为服务器启动过程中出现Il2Cpp初始化异常，导致服务无法正常运行。经过技术分析，发现这与BepInEx安装过程中的dotnet文件夹处理不当有关。

问题现象

服务器启动日志显示以下关键错误信息：

[Error :InteropManager] Failed to generate Il2Cpp interop assemblies: Cpp2IL.Core.Exceptions.LibCpp2ILInitializationException: Fatal Exception initializing LibCpp2IL!

这表明IL2CPP互操作程序集生成失败，最终导致服务器崩溃。

根本原因

经过深入排查，发现问题的根源在于：

1. BepInEx安装包中包含了一个dotnet文件夹
2. 该文件夹在安装过程中被保留在服务器目录中
3. 这个残留的dotnet文件夹与新版egg的运行环境产生冲突
4. 特别是当用户从旧版egg迁移到新版时，这个问题尤为明显

解决方案

临时解决方案

对于已经出现问题的服务器，可以采取以下步骤：

1. 停止V Rising服务器
2. 删除服务器根目录下的dotnet文件夹
3. 重新启动服务器

永久解决方案

项目维护者已在安装脚本中添加了清理逻辑，确保：

1. 在BepInEx安装完成后自动清理不必要的dotnet文件夹
2. 防止残留文件影响服务器正常运行

最佳实践建议

为了避免类似问题，建议用户：

1. 在更新egg时，完全删除旧服务器实例
2. 使用最新版的egg重新创建服务器
3. 确保WINETRICKS_RUN变量设置为"mono"
4. 在安装完成后检查根目录，确保没有残留的旧版文件

技术原理

该问题的技术本质在于：

1. BepInEx作为Unity游戏的mod加载框架，需要正确处理IL2CPP互操作
2. dotnet文件夹中的旧版运行时可能与新版egg的运行环境不兼容
3. 文件残留会导致运行时加载错误的依赖项，从而引发初始化异常

通过规范安装流程和添加清理逻辑，可以有效避免此类兼容性问题，确保V Rising服务器稳定运行。