From 74742251d2412272e36385857e6bd8ce26647ec2 Mon Sep 17 00:00:00 2001 From: DeltaDesigns <50308149+DeltaDesigns@users.noreply.github.com> Date: Wed, 12 Feb 2025 15:58:33 -0500 Subject: [PATCH 1/2] Update README.md --- README.md | 84 ++++++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 77 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 9f462cd7..c9b8c8d4 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,80 @@ -## !! OUTDATED !! -# S&Charm (CharmBox?) +# Charm - the Destiny tool that does everything ## What is this? -A fork of [Charm](https://github.com/MontagueM/Charm) solely focused on exporting to S&Box -## WIP - - [Import guide](https://github.com/DeltaDesigns/Charm/wiki/Source-2-Importing) - - Generates .shader files from decompiled game shaders - - Generates .vmat (material) and .vmdl (model) files for exported objects +A new, flashier, fully C# version of my previous tool Phonon. + +It is designed to support many versions of the Tiger engine, including many game versions of Destiny 2. + +The tool focuses on providing as much access to the information in the game files as possible, **ideal for artists and content preservation**. +> [!CAUTION] +> # Disclaimer +> * Before you go any further, understand that Charm ***IS NOT*** a datamining tool! While it can access many things in the game files, it's main purpose is focused towards **3D artists, content preservation and learning how the game works**! +> * Please **DO NOT** use this tool to spread leaks and spoilers or anything that may break Bungie's TOS. Don't ruin the experience for yourself and others. Uncover things the way they were intended! +> * Seeing this tool used for such acts can and will result in fewer and fewer public updates and releases. I enjoy maintaining and updating this for others, don't be the one to ruin it. + +## How do I install and use it? + +You'll first need at least one game installation. +Charm currently supports: + +| Version | Description | Where | Main manifest id | Language manifest id | +|---------|--------------------------|-----------------|---------------------|----------------------| +| ?.?.?.? | Rise Of Iron last update | Ask in DMR | | | +| 2.6.0.1 | Shadowkeep first update | DepotDownloader | 7002268313830901797 | 2399965969279284756 | +| 2.9.9.9 | Shadowkeep last update | DepotDownloader | 4160053308690659072 | 4651412338057797072 | +| 3.4.0.2 | Beyond Light last update | DepotDownloader | 5631185797932644936 | 3832609057880895101 | +| 6.3.0.7 | Witch Queen last update | DepotDownloader | 6051526863119423207 | 1078048403901153652 | +| 7.3.6.6 | Lightfall last update | DepotDownloader | 7707143404100984016 | 5226038440689554798 | +| N/A | The Final Shape latest | Steam | N/A | N/A | + +If you just want to look at the latest release, you only need Destiny 2 downloaded on Steam. + +Otherwise, you can download the DepotDownloader versions by +- Downloading [DepotDownloader](https://github.com/SteamRE/DepotDownloader/releases) +- Running it with the following arguments: +``` +dotnet DepotDownloader.dll -app 1085660 -depot 1085661 -manifest {main_manifest_id} -username -password -dir -validate +dotnet DepotDownloader.dll -app 1085660 -depot 1085662 -manifest {language_manifest_id} -username -password -dir -validate + +e.g. +dotnet DepotDownloader.dll -app 1085660 -depot 1085661 -manifest 4160053308690659072 -username myusername -password mypassword -dir "D:/DestinyCharmStore/v2601/" -validate +dotnet DepotDownloader.dll -app 1085660 -depot 1085662 -manifest 4651412338057797072 -username myusername -password mypassword -dir "D:/DestinyCharmStore/v2601/" -validate +``` + +After you've downloaded the version(s) you want: + +- You'll need [.NET 7.0 x64](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-7.0.400-windows-x64-installer) installed. +- Download the [latest release]() and run Charm.exe. +- Set the packages and export paths first. + +If you encounter any problems, take a look in the `Logs/` folder, find the latest log file, and look at the exception. +Feel free to raise an issue on this repository on in DMR `#charm-tool-help` if you need help. + +Also take a look at the [Charm wiki](https://github.com/MontagueM/DestinyDocs/blob/main/Charm/Home.md) for more info. + +> [!TIP] +> ## Some tips and tricks +> * Middle click tabs to close them. +> * In a packages view, you can type in any hash and it will take you to it. No need to look through all the packages. +> * If you already have the hash of an Entity (Dynamic), you can press CTRL+D to enter 'Dev' view. Paste the hash into the box and press enter. It will open in a viewer and be exported + +## Reporting issues + +If you experience any issue, you can register an issue in this repository. If the program has crashed, it is extremely valuable to provide the charm.log file. + +## Learning and Contributing + +To learn about how Charm works or to contribute, check out the [wiki](https://github.com/MontagueM/Charm/wiki). + +## Sponsor + +I put a sponsor on this project as some people wanted to contribute, if you want to you can help me out :) + +## License + +The Charm source code is licensed under GPLv3. All other used code and DLLs are subject to their own licenses. + +## Credits + +Thanks to Alcidine, BIOS, Carson Reed, Delta, and nblock for testing, feedback, and help throughout the project's development. HighRTT for audio help (RevorbStd and librevorb). From 418a05e9ff303f868c45d4af214aba99ea0b1863 Mon Sep 17 00:00:00 2001 From: DeltaDesigns <50308149+DeltaDesigns@users.noreply.github.com> Date: Mon, 25 Aug 2025 22:54:08 -0400 Subject: [PATCH 2/2] Update README.md --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index c9b8c8d4..397a7edd 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,5 @@ +# The Main branch is not regularly maintained, see [Here](https://github.com/MontagueM/Charm/tree/delta/EOF) for the latest. + # Charm - the Destiny tool that does everything ## What is this?