From 1a7632a305d721bdb23d26f20c46b3a3a0966f99 Mon Sep 17 00:00:00 2001 From: Bloody Date: Sat, 2 May 2026 22:07:23 +0200 Subject: [PATCH] Improve local Data Center docs --- CHANGELOG.md | 2 + README.md | 4 + docs/INSTALL_DATACENTER_DE_EN.md | 125 ++++++++++++++++++++++++++ docs/TROUBLESHOOTING_DATACENTER_DE.md | 75 +++++++++++++++- 4 files changed, 202 insertions(+), 4 deletions(-) create mode 100644 docs/INSTALL_DATACENTER_DE_EN.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 02f9908..50dbc0e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,11 +8,13 @@ All notable changes to this Data Center-focused UnityExplorer fork are documente - GitHub Actions now uploads the ready-to-use CoreCLR ZIP plus generated SHA256 checksums. - `build-datacenter.ps1` now writes `Release\CHECKSUMS_SHA256.txt` for the ZIP and installed DLLs. +- Added local bilingual installation and troubleshooting docs for users who do not use the wiki. ### Deutsch - GitHub Actions lädt jetzt die fertige CoreCLR-ZIP plus erzeugte SHA256-Prüfsummen hoch. - `build-datacenter.ps1` schreibt jetzt `Release\CHECKSUMS_SHA256.txt` für ZIP und installierbare DLLs. +- Lokale zweisprachige Installations- und Troubleshooting-Dokumente für Nutzer ohne Wiki ergänzt. ## v1.0.1 - CoreCLR build cleanup diff --git a/README.md b/README.md index 172a5ef..8a9eb13 100644 --- a/README.md +++ b/README.md @@ -174,6 +174,8 @@ Weitere Informationen: Weitere Informationen findest du im Wiki: +- [Lokale Installation / Local Installation](docs/INSTALL_DATACENTER_DE_EN.md) +- [Lokales Troubleshooting / Local Troubleshooting](docs/TROUBLESHOOTING_DATACENTER_DE.md) - [Home](https://github.com/BloddyMichi/Unity-Explorer-/wiki) - [Installation](https://github.com/BloddyMichi/Unity-Explorer-/wiki/Installation) - [Known Issues](https://github.com/BloddyMichi/Unity-Explorer-/wiki/Known-Issues) @@ -427,6 +429,8 @@ More information: The wiki contains additional setup, troubleshooting and development information: +- [Local Installation](docs/INSTALL_DATACENTER_DE_EN.md) +- [Local Troubleshooting](docs/TROUBLESHOOTING_DATACENTER_DE.md) - [Home](https://github.com/BloddyMichi/Unity-Explorer-/wiki) - [Installation](https://github.com/BloddyMichi/Unity-Explorer-/wiki/Installation) - [Known Issues](https://github.com/BloddyMichi/Unity-Explorer-/wiki/Known-Issues) diff --git a/docs/INSTALL_DATACENTER_DE_EN.md b/docs/INSTALL_DATACENTER_DE_EN.md new file mode 100644 index 0000000..1355b03 --- /dev/null +++ b/docs/INSTALL_DATACENTER_DE_EN.md @@ -0,0 +1,125 @@ +# Installation — Data Center + +## Deutsch + +### Empfohlene Variante + +Lade den neuesten Release herunter: + +```text +https://github.com/BloddyMichi/Unity-Explorer-/releases/latest +``` + +Entpacke das Release-ZIP direkt in deinen Data-Center-Spielordner. Danach sollten diese Dateien existieren: + +```text +Data Center\Mods\UnityExplorer.ML.IL2CPP.CoreCLR.dll +Data Center\UserLibs\UniverseLib.ML.IL2CPP.Interop.dll +``` + +Typischer Steam-Pfad: + +```text +C:\Program Files (x86)\Steam\steamapps\common\Data Center +``` + +### Update von einer älteren Version + +Beende Data Center vollständig, bevor du Dateien ersetzt. + +Wenn du eine alte Installation manuell aktualisierst, sichere oder entferne vorher diese Dateien: + +```text +Data Center\Mods\UnityExplorer.ML.IL2CPP.CoreCLR.dll +Data Center\UserLibs\UniverseLib.ML.IL2CPP.Interop.dll +``` + +Falls du aus dem Repository baust, kann das Install-Skript die Dateien kopieren und vorhandene DLLs automatisch sichern: + +```powershell +powershell -ExecutionPolicy Bypass -File .\install-datacenter.ps1 -BuildIfMissing +``` + +Bei einem anderen Installationspfad: + +```powershell +powershell -ExecutionPolicy Bypass -File .\install-datacenter.ps1 -GameDir "D:\SteamLibrary\steamapps\common\Data Center" -BuildIfMissing +``` + +### Prüfen + +Nach dem Start sollten MelonLoader und UnityExplorer im Log sichtbar sein: + +```text +Data Center\MelonLoader\Latest.log +``` + +Erwartete Hinweise: + +```text +UnityExplorer 4.13.5 (IL2CPP) initialized. +ObjectExplorerPanel: Unity 6000 safe mode skips Scene Explorer... +Object Search (Safe) +``` + +## English + +### Recommended path + +Download the latest release: + +```text +https://github.com/BloddyMichi/Unity-Explorer-/releases/latest +``` + +Extract the release ZIP directly into your Data Center game folder. These files should exist afterwards: + +```text +Data Center\Mods\UnityExplorer.ML.IL2CPP.CoreCLR.dll +Data Center\UserLibs\UniverseLib.ML.IL2CPP.Interop.dll +``` + +Typical Steam path: + +```text +C:\Program Files (x86)\Steam\steamapps\common\Data Center +``` + +### Updating from an older version + +Close Data Center completely before replacing files. + +If you update an old installation manually, back up or remove these files first: + +```text +Data Center\Mods\UnityExplorer.ML.IL2CPP.CoreCLR.dll +Data Center\UserLibs\UniverseLib.ML.IL2CPP.Interop.dll +``` + +If you build from the repository, the install script can copy the files and back up existing DLLs automatically: + +```powershell +powershell -ExecutionPolicy Bypass -File .\install-datacenter.ps1 -BuildIfMissing +``` + +For a custom install path: + +```powershell +powershell -ExecutionPolicy Bypass -File .\install-datacenter.ps1 -GameDir "D:\SteamLibrary\steamapps\common\Data Center" -BuildIfMissing +``` + +### Verify + +After starting the game, MelonLoader and UnityExplorer should appear in the log: + +```text +Data Center\MelonLoader\Latest.log +``` + +Expected messages: + +```text +UnityExplorer 4.13.5 (IL2CPP) initialized. +ObjectExplorerPanel: Unity 6000 safe mode skips Scene Explorer... +Object Search (Safe) +``` diff --git a/docs/TROUBLESHOOTING_DATACENTER_DE.md b/docs/TROUBLESHOOTING_DATACENTER_DE.md index fb28f7e..6380f36 100644 --- a/docs/TROUBLESHOOTING_DATACENTER_DE.md +++ b/docs/TROUBLESHOOTING_DATACENTER_DE.md @@ -1,6 +1,8 @@ # Troubleshooting — Data Center -## Wichtigster Build +## Deutsch + +### Wichtigster Build Für Data Center wird diese Variante verwendet: @@ -10,14 +12,14 @@ Release\UnityExplorer.MelonLoader.IL2CPP.CoreCLR `build-datacenter.ps1` baut gezielt nur diese CoreCLR-Variante. Der volle Upstream-Build ist für Data Center normalerweise nicht erforderlich. -## Dateien im Spielordner +### Dateien im Spielordner ```text Data Center\Mods\UnityExplorer.ML.IL2CPP.CoreCLR.dll Data Center\UserLibs\UniverseLib.ML.IL2CPP.Interop.dll ``` -## Erwartete sichere Meldungen +### Erwartete sichere Meldungen ```text UnityExplorer 4.13.5 (IL2CPP) initialized. @@ -25,10 +27,75 @@ ObjectExplorerPanel: Unity 6000 safe mode skips Scene Explorer... Object Search (Safe) ``` -## Bekannte Einschränkung +### Häufige Probleme + +**UnityExplorer erscheint nicht** + +- Prüfe `Data Center\MelonLoader\Latest.log`. +- Prüfe, ob die DLL wirklich im `Mods`-Ordner liegt. +- Prüfe, ob `UniverseLib.ML.IL2CPP.Interop.dll` im `UserLibs`-Ordner liegt. +- Entferne alte UnityExplorer- oder UniverseLib-Dateien aus falschen Ordnern. + +**Button-Klicks oder Mausfokus wirken unzuverlässig** + +- Öffne UnityExplorer erst nach dem Laden des Spielstands. +- Schließe Spielmenüs oder Overlays, die Eingaben abfangen. +- Nutze Mouse Inspect nur gezielt und schließe das Panel danach wieder. + +**Scene Explorer fehlt** Der normale Scene Explorer ist unter Unity 6000 deaktiviert. Nutze stattdessen: - Inspector → Mouse Inspect - Object Explorer → Object Search (Safe) - gezielte `Evaluate`-Buttons statt Auto-Update + +## English + +### Main build + +Data Center uses this build: + +```text +Release\UnityExplorer.MelonLoader.IL2CPP.CoreCLR +``` + +`build-datacenter.ps1` only builds this CoreCLR variant. The full upstream build is usually not needed for Data Center. + +### Files in the game folder + +```text +Data Center\Mods\UnityExplorer.ML.IL2CPP.CoreCLR.dll +Data Center\UserLibs\UniverseLib.ML.IL2CPP.Interop.dll +``` + +### Expected safe messages + +```text +UnityExplorer 4.13.5 (IL2CPP) initialized. +ObjectExplorerPanel: Unity 6000 safe mode skips Scene Explorer... +Object Search (Safe) +``` + +### Common issues + +**UnityExplorer does not appear** + +- Check `Data Center\MelonLoader\Latest.log`. +- Check that the UnityExplorer DLL is really in the `Mods` folder. +- Check that `UniverseLib.ML.IL2CPP.Interop.dll` is in the `UserLibs` folder. +- Remove old UnityExplorer or UniverseLib files from wrong folders. + +**Button clicks or mouse focus feel unreliable** + +- Open UnityExplorer after the save game has finished loading. +- Close game menus or overlays that may capture input. +- Use Mouse Inspect only when needed and close the panel afterwards. + +**Scene Explorer is missing** + +The regular Scene Explorer is disabled on Unity 6000. Use these instead: + +- Inspector → Mouse Inspect +- Object Explorer → Object Search (Safe) +- targeted `Evaluate` buttons instead of auto-update