Diablo II

Mitte 2006 habe ich eine Zeitlang einen kleinen (<100 User) Diablo II Battle.net Server administriert, der mit der OpenSource Software PvPGN lief. Dabei fallen einige nervige Aufgaben an und ich habe mir dazu eine Reihe von Tools geschrieben, z.B. einen Dupescanner oder eine webbasierte Ladder.

Den Server gibt es zwar schon länger nichtmehr, die Tools möchte ich der Nachwelt trotzdem nicht vorenthalten. Diese Seite ist leider noch auf Englisch, habe bisher keine Zeit gefunden sie zu übersetzen.

Flos PvPGN Utilities

Hi there, this little site is a collection of some small utility software I wrote for my PvPGN server. For those of you who don't know, PvPGN is a piece of free GPL software that emulates the well known "Battle.Net" services, provided by Blizzard Entertainment. I am using it to host a Diablo 2 1.09d Classic Realm on a Linux box (so all the software is developed with linux in mind, but with some minor adjustments, it should work on Windows, too).

Well, since PvPGN is open source, I thought why not publish my tools as GPL too. I dont want to make money, I just did some stuff that is useful for me and maybe other people can use it too, so feel free to do so.

Thanks to Johannes "heipei" Gilger for his support. He did some parts of the coding, especially the Ruby stuff.

Dupescanner

A dupe scanner is very important for an 1.09d server because duping was not that hard in Diablo 2 1.09d. To dupe means to duplicate an item, which is a way of cheating, because you can "make" as many copies as you like of any item you like. It is obvious that an administrator (who wants his users not to cheat on each other) needs to restrict the possibility of duping. Well, as a matter of fact, I dont think that it is possible to restrict it (without upgrading to newer versions of Diablo, but I definetly want to use 1.09d) but when I cant restrict it, I at least can detect it (and delete the user who duped). This is where my software comes in.

Download dupescan
Change the DEFINE for the directory where the charfiles are
Run "make" to compile it
Run "./dupescan -s" (you may also want to use "-q") to scan

For additional information on implementation see the README file

Unfortunately, if you detect a dupe, means, you detect two items with the same fingerprint, you cannot tell which one was the original and which one is the dupe. So, if you have two users with the exact same item, you cant tell who cheated and who got the item from the cheater thinking it is legit (or maybe both cheated, you will never know). You will have to live with that. I use to delete both copies of the item, even if that means deleting a legit item.

Note that I am running a HC only server. That means, that every char is a hardcore char. When a hardcore char dies, he is dead. There is no "restart in town". Dead in the literal sense. No resurrection. My dupescanner will still work on SC chars, but they may be able to hide the dupes. The reason is, that there are different item sections in every char file. One main item section, which holds your equipment, inventory, belt and stash. That is the only section my software scans for dupes. But, there are other sections. Like a corpse section. When you die in SC and leave the game, the next time you will enter a new game, you will see your corpse on the ground, holding all your stuff ready for you to pick up. If a character has a duped item in his corpse, my software wont detect it

Also note that I am using a Diablo 2 classic server. In Diablo 2 Classic, it is not possible to equip your merc. In Lord of Destruction, it is. So, if you are using a LoD Server and one of your users equips his merc with a duped item, my software wont notice.

For those of you who are using windows to host their games: You may also want to have a look at ATMA, which also includes a dupe scanner. I just could not use that one for my server because I am running linux and I am way to lazy to download all the chars and scan them manually.

Item Counter

My users wanted a way to see how many SoJ exist on the server, so I coded a little program which reads the characters and counts all the items. I just needed SoJ but I added the following item classes:

low quality item
normal quality item
high quality item
magical item
set item
rare item
unique item
SoJ

Download

Charlist

charlist is a little tool which parses all the charfiles, reads the level and the class (barb, sorc, ...) and characters status (dead or alive). It then prints out a space seperated list which is easy to parse by my "Web Userlist" script.

The output will look like that:

[0]flo@classic-addiction:~$ charinfo
flo FMS_Storm 60 Sorc alive
flo FMS_Kitana 38 Amazone alive
flo FMS_HurricanE 39 Barb alive
flo FMS_Cleric 18 Paladin dead
flo FMS_TheWatcher 26 Nec alive
flo FMS_LifeSuxx 37 Sorc alive
flo FMS_ChuckNorris 33 Barb alive
flo FMS_PennyLane 31 Sorc alive

First row is the account name, second row is the charactername, third row level, class, status.

I use this software to periodically write its output to a place the webserver can read it so my php site can parse the charlist.

Download

Web Userlist

This one shows you a list of all accounts with status (online or offline) and some info (description, location, sex, creation date, ...). Additionally, it will show you a list of characters on the account including level, class and status!

Note that this php file reads its data from a text file which contains the output of the charlist software!

You will have to change the paths in both of the php files in order to make it work. I recommend you write the charlist.txt with cron.

Download

Resource Usage

I needed a quick way to have a look at the servers memory and cpu usage from the linux console, so I wrote a little script that reads it data from "ps" (/proc/pid/mem would be smarter, but I did not think about that at the time).

The output will look like that:

 +-------+--------+--------+------------+------------+------------------------------------------+
 |  Proc |   CPU% |   MEM% |        VSZ |        RSS | PIDS                                     |
 +-------+--------+--------+------------+------------+------------------------------------------+
 | bnetd |   0.00 |   0.20 |     4.41 M |     1.91 M | 364                                      |
 |  d2cs |   0.00 |   0.10 |     2.27 M |   916.00 K | 26629                                    |
 | d2dbs |   0.00 |   0.10 |     2.87 M |     1.13 M | 2943                                     |
 |  d2gs |   0.00 |  34.50 |     1.62 G |   304.74 M | 2594 5980 699 32509 32225                |
 +-------+--------+--------+------------+------------+------------------------------------------+
 | Total |   0.00 |  34.90 |     1.63 G |   308.68 M | -                                        |
 +-------+--------+--------+------------+------------+------------------------------------------+

Download

Ladder XML Output Bug in PvPGN 1.8.0-rc2

If you are using pvpgn-1.8.0rc2, you will notice, that there is something wrong with your titles. Some chars that are Dukes in the ingame ladder will be Countess in the exported XML ladder. This is a bug in the pvpgn software which I noticed and fixed.

You can use my patch to fix this: ladder_xml_output_bug.patch

PHP XML Ladder Parser

I wanted to add the ingame ladder to my servers website so that my users can have a look at it without joining the game. I just needed the "Hardcore Overall" ladder (there are also class-specific ladders and softcore ladders).

You can config your pvpgn to export the ladder in XML, which is much more userfriendly than the internal binary format. I used SimpleXML to parse it, so you have to download it if you want to use my script.

Download

You will have to change some variables in the PHP file so the script finds your stuff. And make sure the webserver has read permission on the files and directories (can be tricky with php safemode enabled).

Character counter

For statistics, I needed a tool which counts all characters (dead and alive). here it is

Additional command line tools

Some additional console tools:

DuplicateAccs.pl - I dont wanted people to use more than one account, so I wrote this tool. It scans for accounts which have the same password, lastlogin IP or lastlogin Windows username, since those things are indications that the accounts belong to the same person
EmptyAccounts.pl - Scans for empty accounts so I could delete them
FindChar.pl - Finds the account which hosts some given character
LoginHighscore.pl - Prints an ordered list of accounts and the time of its last login, so you can see which account has not been used for the longest time

And some Ruby Scripts, nicely provided by Johannes Gilger. Thanks for that!

check-accounts.rb - Tests if file integrity is okay, for example file permissions of the character files and possible contradictions in the charinfo and charsave directory structures (which can happend if you do not properly delete an account)
delete-account.rb - Reports all filenames associated to a given account name, so you can fully remove that account without f*cking up the file integrity and leaving dead useless files
delete-char.rb - Same as above, just for single character files instead of the whole account

Contact

Feel free to contact me if you are having problems using my software or if you discover bugs. If you want to drop me a line, mail to "flo" at the websites domain (no direct mail adress here, too much spam, sorry).