betweenwalls / pd2-converter

Simple Character/Stash Converter for Project D2

Simple Character/Stash Converter for PD2

This program converts character/stash files between vanilla and PD2, and updates PD2 files so they can be used with the most recent season without needing to drop old items.

Supports all PD2 characters and vanilla characters from v1.10+ (.d2s files), as well as shared/personal stashes from PlugY v11.02+ (.sss and .d2x files). Built from dschu012's D2SLib repository. Requires .NET framework to run.

I didn't bother separating the source code from the release code, so there are a bunch of extra folders/files which can be ignored.

Download

Instructions

1. Download PD2-Converter-main.zip and extract the files
2. Copy your character and stash files from your save folder (Diablo II\Save) and paste them into PD2-Converter-main\src\main\input
3. Run PD2-Converter.exe (it's in PD2-Converter-main\src\main) - a command line menu will pop up
4. Leave the 3 prompts blank by pressing enter 3 times and wait for the program to convert your files
5. Copy the converted files from PD2-Converter-main\src\main\output and paste them into your save folder (Diablo II\Save)

If a converted file doesn't work for whatever reason, a backup of the original file will still be in PD2-Converter-main\src\main\input.

If you want to revert to an older version of PD2 for whatever reason, you can replace your game files with the versions included in the Patches folder.

Errors

The converter may not work in all cases - if the converter doesn't work for a particular file, you can use the traditional method of reverting to the previous season and dropping whichever items were fundamentally altered after that season. If you drop the altered items, you won't need to convert anything. If you want to try keeping those items, transfer them all to a new character instead of dropping them and then use the converter on that new character only.

1. Revert to a previous season
2. Drop any items which were fundamentally altered after that season (or move them to a new character)
3. Update to the most recent season
4. If the items were moved to a new character, use the converter on that character

Fundamentally altered items per season:

• S2: maps, Standard of Heroes
• S3: maps, any item with +X% Enhanced Damage or +X to Maximum Damage per Character Level
• S7: maps (including dungeons & arenas)
• S8: items with +X Open Wounds Damage per Second

The converter may have trouble with:

• Personalized items
• Items with specific corruptions which were removed/changed in later seasons (details unknown)
• Standard of Heroes (S2 or earlier)
• Mephisto's Soulstone (S2 or earlier)

Reverse Conversions

Although primarily designed for converting vanilla or PD2 characters & stashes to the most recent PD2 season, characters may also be converted in the reverse direction. When converting characters from PD2 to vanilla, items or item affixes that don't exist in vanilla will prevent files with them from being converted. While this "reverse" conversion seems to otherwise work correctly for loading/playing those characters in the vanilla game, other programs (such as Hero Editor) may not load them correctly. To fix this issue when using such programs to edit characters from PD2, the characters should be converted to vanilla and saved from within the vanilla game prior to being edited.

Feedback

If you encounter bugs, let me know on reddit (u/BetweenWalls) or discord (@BetweenWalls#2390), or just submit an issue here.

pd2-converter's Issues

Converting Issue

Noticed a problem with converting one of my d2x files from Season 2 save. As it turns out, having Mephisto's soulstone in the stash is a no-no. Just in case if it's possible to fix, or if anyone else runs into this problem.

Unable to convert S1 save

Hey, I tried using your tool to convert my save from S1 (it's been a while lol). Here's what happened:

The character file couldn't convert when I specified it's from S1, however when I let it automatically detect the season, it converted "successfully". Trying to load it ingame in the current S6 however throws a "bad inventory data" error.

The stash outright couldn't convert at all.

I don't think I have any of the problematic items you've listed, except perhaps a few corrupted pieces of gear. I do, however, have "cheated" (e.g. manually created in a save editor) items that I've made for RW bases and the like (I basically "traded" with myself in SP, browsing the marketplace, find a deal, copy the stats to create a new item in the editor and discard the amount of Worldstone Shards the seller was asking :D). I think these items could be causing the problems.

Another problem is that my S1 installation is no longer working after I installed S6 (I even made sure to install it on a separate game installation on a separate hard drive, still borked my S1 install :@), so I can't just go through my character and stash and drop the problematic items, unless there is a way to reinstall S1. Any suggestions?

I've attached the files if anyone wants to have a go at it. Any help is highly appreciated!
S1_SaveFile.zip

Converting PD2 S6 to S7 character doesn't work

Hi,

there is an issue converting my PD2 S6 SP character to S7. Here is the output:

This program converts character/stash files for vanilla/PD2. Enter "\" to exit.
Which format would you like to convert to?
Enter "vanilla" (1), "pd2" (2), or leave blank for pd2: 2
Files in \src\main\input will be converted to pd2.

If all files are from a specific season, conversion speed can be improved if that season's format is assumed.
Enter a season number to assume, or leave blank to auto-detect: 6
Files will be assumed to be from season 6.

Enter the character's name, or leave blank to convert all files:
Reading all characters...
Reading Igor.d2s... ignored (unknown file format)

Reading all stash files...

Some files could not be converted. (all files were assumed to be from S6)
Press enter to close.

It does not work with season auto-detect either.

I'm running PD2-Converter.exe via Wine 8.6, but that shouldn't matter I think.

I'm attaching my character files.

igor.tar.gz

Broken file on readme.md link

PlugY stashes are lost when converting S7 to S8

Hey,

It seems like all stash pages but the first one are lost when converting this save: Vadmin.zip. It's got plenty of items on the 2nd and 3rd stash pages if you open it in the S7, but only the 1st stash page is available in the converted save.