using System; using System.Collections.Generic; using System.Diagnostics; using System.IO; using System.Linq; using System.Reflection; using System.Text; using BepInEx.Common; using BepInEx.Logging; using Mono.Cecil; using Mono.Cecil.Cil; using UnityInjector.ConsoleUtil; using MethodAttributes = Mono.Cecil.MethodAttributes; namespace BepInEx.Bootstrap { /// /// The main entrypoint of BepInEx, and initializes all patchers and the chainloader. /// public static class Preloader { #region Path Properties private static string executablePath; /// /// The path of the currently executing program BepInEx is encapsulated in. /// public static string ExecutablePath { get => executablePath; set { executablePath = value; GameRootPath = Path.GetDirectoryName(executablePath); ManagedPath = Utility.CombinePaths(GameRootPath, $"{ProcessName}_Data", "Managed"); PluginPath = Utility.CombinePaths(GameRootPath, "BepInEx"); PatcherPluginPath = Utility.CombinePaths(GameRootPath, "BepInEx", "patchers"); } } /// /// The path to the core BepInEx DLL. /// public static string BepInExAssemblyPath { get; } = typeof(Preloader).Assembly.CodeBase.Replace("file:///", "").Replace('/', '\\'); /// /// The directory that the core BepInEx DLLs reside in. /// public static string BepInExAssemblyDirectory { get; } = Path.GetDirectoryName(BepInExAssemblyPath); /// /// The name of the currently executing process. /// public static string ProcessName { get; } = Path.GetFileNameWithoutExtension(Process.GetCurrentProcess().ProcessName); /// /// The directory that the currently executing process resides in. /// public static string GameRootPath { get; private set; } /// /// The path to the Managed folder of the currently running Unity game. /// public static string ManagedPath { get; private set; } /// /// The path to the main BepInEx folder. /// public static string PluginPath { get; private set; } /// /// The path to the patcher plugin folder which resides in the BepInEx folder. /// public static string PatcherPluginPath { get; private set; } #endregion /// /// The log writer that is specific to the preloader. /// public static PreloaderLogWriter PreloaderLog { get; private set; } /// /// The dictionary of currently loaded patchers. The key is the patcher delegate that will be used to patch, and the value is a list of filenames of assemblies that the patcher is targeting. /// public static Dictionary> PatcherDictionary { get; } = new Dictionary>(); /// /// The list of initializers that were loaded from the patcher contract. /// public static List Initializers { get; } = new List(); /// /// The list of finalizers that were loaded from the patcher contract. /// public static List Finalizers { get; } = new List(); /// /// Adds the patcher to the patcher dictionary. /// /// The list of DLL filenames to be patched. /// The method that will perform the patching. public static void AddPatcher(IEnumerable dllNames, AssemblyPatcherDelegate patcher) { PatcherDictionary[patcher] = dllNames; } /// /// Safely retrieves a boolean value from the config. Returns false if not able to retrieve safely. /// /// The key to retrieve from the config. /// The default value to both return and set if the key does not exist in the config. /// The value of the key if found in the config, or the default value specified if not found, or false if it was unable to safely retrieve the value from the config. private static bool SafeGetConfigBool(string key, string defaultValue) { try { string result = Config.GetEntry(key, defaultValue); return bool.Parse(result); } catch { return false; } } /// /// Allocates a console window for use by BepInEx safely. /// internal static void AllocateConsole() { bool console = SafeGetConfigBool("console", "false"); bool shiftjis = SafeGetConfigBool("console-shiftjis", "false"); if (console) { try { ConsoleWindow.Attach(); uint encoding = (uint) Encoding.UTF8.CodePage; if (shiftjis) encoding = 932; ConsoleEncoding.ConsoleCodePage = encoding; Console.OutputEncoding = ConsoleEncoding.GetEncoding(encoding); } catch (Exception ex) { Logger.Log(LogLevel.Error, "Failed to allocate console!"); Logger.Log(LogLevel.Error, ex); } } } /// /// The main entrypoint of BepInEx, called from Doorstop. /// /// The arguments passed in from Doorstop. First argument is the path of the currently executing process. public static void Main(string[] args) { try { AppDomain.CurrentDomain.AssemblyResolve += LocalResolve; ExecutablePath = args[0]; AllocateConsole(); PreloaderLog = new PreloaderLogWriter(SafeGetConfigBool("preloader-logconsole", "false")); PreloaderLog.Enabled = true; string consoleTile = $"BepInEx {Assembly.GetExecutingAssembly().GetName().Version} - {Process.GetCurrentProcess().ProcessName}"; ConsoleWindow.Title = consoleTile; Logger.SetLogger(PreloaderLog); PreloaderLog.WriteLine(consoleTile); Logger.Log(LogLevel.Message, "Preloader started"); AddPatcher(new [] { "UnityEngine.dll" }, PatchEntrypoint); if (Directory.Exists(PatcherPluginPath)) { SortedDictionary>> sortedPatchers = new SortedDictionary>>(); foreach (string assemblyPath in Directory.GetFiles(PatcherPluginPath, "*.dll")) { try { var assembly = Assembly.LoadFrom(assemblyPath); foreach (var kv in GetPatcherMethods(assembly)) sortedPatchers.Add(assembly.GetName().Name, kv); } catch (BadImageFormatException) { } //unmanaged DLL catch (ReflectionTypeLoadException) { } //invalid references } foreach (var kv in sortedPatchers) AddPatcher(kv.Value.Value, kv.Value.Key); } AssemblyPatcher.PatchAll(ManagedPath, PatcherDictionary, Initializers, Finalizers); } catch (Exception ex) { Logger.Log(LogLevel.Fatal, "Could not run preloader!"); Logger.Log(LogLevel.Fatal, ex); PreloaderLog.Enabled = false; try { UnityInjector.ConsoleUtil.ConsoleWindow.Attach(); Console.Write(PreloaderLog); } finally { File.WriteAllText(Path.Combine(GameRootPath, $"preloader_{DateTime.Now:yyyyMMdd_HHmmss_fff}.log"), PreloaderLog.ToString()); PreloaderLog.Dispose(); } } } /// /// Scans the assembly for classes that use the patcher contract, and returns a dictionary of the patch methods. /// /// The assembly to scan. /// A dictionary of delegates which will be used to patch the targeted assemblies. internal static Dictionary> GetPatcherMethods(Assembly assembly) { var patcherMethods = new Dictionary>(); foreach (var type in assembly.GetExportedTypes()) { try { if (type.IsInterface) continue; PropertyInfo targetsProperty = type.GetProperty( "TargetDLLs", BindingFlags.Public | BindingFlags.Static | BindingFlags.IgnoreCase, null, typeof(IEnumerable), Type.EmptyTypes, null); //first try get the ref patcher method MethodInfo patcher = type.GetMethod( "Patch", BindingFlags.Public | BindingFlags.Static | BindingFlags.IgnoreCase, null, CallingConventions.Any, new[] {typeof(AssemblyDefinition).MakeByRefType()}, null); if (patcher == null) //otherwise try getting the non-ref patcher method { patcher = type.GetMethod( "Patch", BindingFlags.Public | BindingFlags.Static | BindingFlags.IgnoreCase, null, CallingConventions.Any, new[] {typeof(AssemblyDefinition)}, null); } if (targetsProperty == null || !targetsProperty.CanRead || patcher == null) continue; AssemblyPatcherDelegate patchDelegate = (ref AssemblyDefinition ass) => { //we do the array fuckery here to get the ref result out object[] args = { ass }; patcher.Invoke(null, args); ass = (AssemblyDefinition)args[0]; }; IEnumerable targets = (IEnumerable)targetsProperty.GetValue(null, null); patcherMethods[patchDelegate] = targets; MethodInfo initMethod = type.GetMethod( "Initialize", BindingFlags.Public | BindingFlags.Static | BindingFlags.IgnoreCase, null, CallingConventions.Any, Type.EmptyTypes, null); if (initMethod != null) { Initializers.Add(() => initMethod.Invoke(null, null)); } MethodInfo finalizeMethod = type.GetMethod( "Finish", BindingFlags.Public | BindingFlags.Static | BindingFlags.IgnoreCase, null, CallingConventions.Any, Type.EmptyTypes, null); if (finalizeMethod != null) { Finalizers.Add(() => finalizeMethod.Invoke(null, null)); } } catch (Exception ex) { Logger.Log(LogLevel.Warning, $"Could not load patcher methods from {assembly.GetName().Name}"); Logger.Log(LogLevel.Warning, $"{ex}"); } } Logger.Log(LogLevel.Info, $"Loaded {patcherMethods.Select(x => x.Key).Distinct().Count()} patcher methods from {assembly.GetName().Name}"); return patcherMethods; } /// /// Inserts BepInEx's own chainloader entrypoint into UnityEngine. /// /// The assembly that will be attempted to be patched. internal static void PatchEntrypoint(ref AssemblyDefinition assembly) { if (assembly.Name.Name == "UnityEngine") { #if CECIL_10 using (AssemblyDefinition injected = AssemblyDefinition.ReadAssembly(BepInExAssemblyPath)) #elif CECIL_9 AssemblyDefinition injected = AssemblyDefinition.ReadAssembly(BepInExAssemblyPath); #endif { var originalInjectMethod = injected.MainModule.Types.First(x => x.Name == "Chainloader") .Methods.First(x => x.Name == "Initialize"); var injectMethod = assembly.MainModule.ImportReference(originalInjectMethod); var sceneManager = assembly.MainModule.Types.First(x => x.Name == "Application"); var voidType = assembly.MainModule.ImportReference(typeof(void)); var cctor = new MethodDefinition(".cctor", MethodAttributes.Static | MethodAttributes.Private | MethodAttributes.HideBySig | MethodAttributes.SpecialName | MethodAttributes.RTSpecialName, voidType); var ilp = cctor.Body.GetILProcessor(); ilp.Append(ilp.Create(OpCodes.Call, injectMethod)); ilp.Append(ilp.Create(OpCodes.Ret)); sceneManager.Methods.Add(cctor); } } } /// /// A handler for .AssemblyResolve to perform some special handling. /// /// It attempts to check currently loaded assemblies (ignoring the version), and then checks the BepInEx/core path, BepInEx/patchers path and the BepInEx folder, all in that order. /// /// /// /// /// internal static Assembly LocalResolve(object sender, ResolveEventArgs args) { AssemblyName assemblyName = new AssemblyName(args.Name); var foundAssembly = AppDomain.CurrentDomain.GetAssemblies().FirstOrDefault(x => x.GetName().Name == assemblyName.Name); if (foundAssembly != null) return foundAssembly; if (Utility.TryResolveDllAssembly(assemblyName, BepInExAssemblyDirectory, out foundAssembly) || Utility.TryResolveDllAssembly(assemblyName, PatcherPluginPath, out foundAssembly) || Utility.TryResolveDllAssembly(assemblyName, PluginPath, out foundAssembly)) return foundAssembly; return null; } } }