BDO Toolkit 1.3.0  

A .NET modding library for Black Desert Online, installations required for users intending to use projects depending on the library.

• BDO Toolkit, changelog - Required for all most tools
• Meta Injector, changelog - General purpose patching tool
• Meta Patcher *NEW*, changelog - Unblock all OFFICIAL regions for modding
• Restore N' Patch, changelog
• OpenBD *WIP* - File & mod browser/manager
• PartCutGen, changelog - Automatically generate partcutdesc

• .NET Framework 4.6.1

1. Download the archive anywhere on your computer.
2. Unzip all the files in the archive.
3. Open the executable "BDOToolkit Installer.exe".
4. Press 1 then enter, and then any key to exit. You're done!

Developers only: Reference your projects to BDOToolkit.dll.
Note that redistribution of the library is prohibited, users will install the library to the GAC (Global Assembly Cache), and your project will load the library from the GAC (handled automatically by the .NET Framework) on their machine, this is so that projects that were not updated to the library's latest changes (such as bug fixes) do not roll back users. DO NOT include BDOToolkit.dll while redistributing your project, link to this thread instead.

Q: Who is it for?
A: For mod developers to code with, and for users to install so that projects using the library may access it.

Q: Can I include the library in my project's/mod pack's archive?
A: No, redistribution is prohibited to prevent version conflicts, the GAC installation will provide the relevant projects with the library.

Q: Can I see the source code?
A: Not at the moment, no. The library is in serious need of clean up, refactoring and optimizations, the source code will not be made available at this time.

Q: Documentation?
A: Sadly not available yet. Documentation will be available in the library with future updates.

• .NET Framework 4.6.1
• BDO Toolkit version 1.1.0 or higher

1. Download the archive anywhere on your computer.
2. Unzip "Meta Injector.exe" to your game's "Paz" folder.
3. Copy your modified files to the sub-folder "files_to_patch" in your game's "Paz" folder
4. Run "Meta Injector.exe" and follow the menu instructions.

• .NET 6
• BDO Toolkit 1.3.0 Embedded since .NET no longer supports the GAC (Global Assembly Cache).
• A functional backup of the meta file (that allows you to play the game normally) that the library can detect (created automatically by Meta Injector).

1. Download the archive anywhere on your computer.
2. Unzip "Meta Patcher.exe" to your game's "Paz" folder.
3. Apply your mods with other tools such as Meta Injector.
4. Run "Meta Patcher.exe", if told the patching was done successfully you should be able to enter the game with mods.

Q: Who is it for?/Who needs this?
A: Every player that wishes to use mods on an official PA server that "blocks" mods (currently that's every region except NA/EU).

Q: The program won't open, what am I doing wrong?
A: Make sure .NET 6 is installed, if it is, run a repair with the .NET 6 installer.

Q: The program says "An unmodified backup is required."
A (v1.1.0+): The most recent backup of the current game version is modded, remove it and run a repair with the game launcher. Modded backups only happen when using outdated tools (such older versions of Resorepless), please avoid using those.
A (v1.0.0): If the game just updated, you probably ran the tools in the wrong order and a backup currently does not exist. If a backup does exist, then it may have been tampered with as mods are detected with it.

Q: The program says it's "Unable to generate match!"
A: If you're playing on OFFICIAL servers by Pearl Abyss, please upload a copy of the automatically generated backup and your current meta file and name the region you play on.

• .NET Framework 4.6.1
• BDO Toolkit
• Projects with implemented support to be located in the same folder (better control over that soon™)

1. Download the archive anywhere on your computer.
2. Unzip the archive's contents to your game's "Paz" folder.
3. Create a shortcut to "Restore N' Patch.exe" on your desktop (or wherever you normally launch the game from).
4. Use the shortcut from now on to run the game. No longer fearing a sudden update triggering a file recheck.

Q: What does it do?
A: The program restores the latest backup of the meta file, and launches the game's launcher, waiting for the launcher's closure, the program then attempts to find the game's process to suspend it, the program will then check if the meta file was updated, if not, the original patched meta will be restored, if it was updated, the program will execute compatible programs to patch the meta file.

Q: Does the program have to run as Administrator?
A: Yes, Black Desert Online runs as Administrator, and for the program to have access to suspend and later resume the process, the program has to have elevated permissions.