logo

ShrimpWorks

// why am I so n00b?
Unreal Archive

Over the past several months, I’ve been working on a project to provide a place to catalogue and preserve the vast amounts of user-created content the Unreal and Unreal Tournament community has been creating over the past 20+ years.

This has resulted in the Unreal Archive.

While it may seem a silly cause to invest so much time (and money) into, this stuff directly influenced the lives of myself and thousands of others. I would certainly not be in the profession I’m in, driving my car, living in my house, if not for the direct influence of working on Unreal Tournament maps, mods and community, and personal websites.

This stuff made many of us who we are today, and a lot of it has already been lost in time. The internet may not ever forget, but it certainly misplaces things in ways it can’t be found again.

A lot of content is in fact mirrored in various places on the internet, but it can be hard to download, as people generally don’t appreciate you mirroring 100s of gigabytes off their shared hosting.

Thus, the Unreal Archive is an initiative to gather up, index, and catalogue as much Unreal, UT99 and UT2004 content as possible. So far, we have maps, map packs, voices, skins, mutators, player models, as well as support for things such as patches, updates and drivers as well as a (currently very empty) section for written documents with the intent of providing guides, tutorials, manuals, and other related documented knowledge which also seems to get lost and forgotten.

The tech stack and some of the decisions involved may seem odd, but in keeping with the theme of longevity, preservation, and the general ease of losing things on the internet, these are some of my motivations:

  • statically generated content - the website is generated as a collection of plain HTML pages. this ensures no dependence on having to host a website with any dependency on any sort of back-end service beyond the simplest of HTTP servers. specific pains have been taken to ensure it works well with file:// local resources as well, so it doesn’t even need to be hosted!
  • written in Java - largely because I know it well enough to do this, but also because it’s not going anywhere soon, so the indexing and site generation capabilities will remain in action for a long time.
  • data stored as YAML files - a dead simple format that’s also easily human- readable. in 30 years when all the YAML parsers have died, if someone looks at these files, they’ll be easy to write new parsers for, if that’s ever needed.
  • the “database” is Git - easy to distribute amongst many people, and since this is primarily an archive, the data does not change rapidly enough to require anything more real-time.
  • the entire project is “licensed” under UNLICENSE, with the intent of it being as absolutely open as possible, for as long as possible.

As I’m collecting a lot of the data for the archive directly from the pieces of content themselves, a large part of implementing this also involved figuring out the Unreal Package data formats. Thankfully there are still several references for this hanging around, and many people have made their research on the topic public.

I’ve released a separate Unreal Package Library (Java) which some people may find useful. I’m using it to read map information, such as authors, player counts, titles, etc, export images such as screenshots and player portraits, as well as for parsing Unreal’s INT and UPL metadata files (more-or-less glorified INI files).

All the code for the project is up on GitHub, as is the content database.

UTStatsDB is a player and match statistics system for Unreal Tournament 99, 2003, 2004 and 3, which parses match logs generated by each game (sometimes requiring additional server-side mutators), and makes stats for each game available through a website.

The stats are also aggregated by player, map and server, allowing you to browse and analyse quite a number of in-depth stats for each.

The project was developed and maintained by Patrick Contreras and Paul Gallier between 2002 and around 2009, where the original project seems to have been abandoned some time after the release of UT3. (addendum: by some coincidence, after 9 years of inactivity, the original author did create a release a few days after my revival/release) Locating downloads (the download page is/was not working) or the source (their SCM system seems to require auth or is simply gone) was quite troublesome.

Thankfully it was released under GPL v2, so I’ve taken it upon myself to be this project’s curator (addendum: since the original author also made a new release, I may now need to look into a rename or major version bump), and have since released two new versions, 3.08 and 3.09 which focus firstly on getting PHP support up to scratch so it runs without issue on PHP 7+, as well as implementing PHP’s PDO database abstraction layer for DB access, rather than using each of the supported DB drivers (MySQL, MSSQL, SQLite) directly.

In addition to many other bug fixes and issues, I’ve thus far revised the presentation significantly, provided Docker support, improved performance of several SQL operations by implementing caching and better queries, etc.

UTStatsDB can be found on GitHub, where the the latest release can also be downloaded.

A live example of UTStatsDB in action can be found at the UnrealZA stats site.

With all the talk of Unreal Tournament 4 possibly being cancelled one of these days, due to Epic’s runaway success with Fortnite, I’ve decided there’s really no reason to not be playing UT99.

Thus, we set about trying to run it on modern hardware, with a modern Linux installation.

As much as this is about setting things up on Linux, it’s also partially my own attempt at some knowledge preservation, as a lot of this stuff ends up being forgotten or lost over time (it’s been almost 20 years! a lot of the old sites and things you expect to find this info on simply do not exist anymore :()

This is part one of two, and will focus on installing and running the game using Wine.

arrow Continue Reading ...

I really have to use this thing more often than once or twice a year :D. I’m just going to do a few posts on a couple of subjects just for personal lols.

Lots of Team Fortress 2 has been played. I thought since it went free, there’d be plenty of noobs to beat up. Sadly all the kids playing games these days are not noobs ;). I’m also really enjoying playing an online FPS on PC once more, still something I haven’t done to any degree since UT3 fizzled (did it ever really get going at all, though?).

The more I play however, the more I long for something like Unreal to return.

TF2 is great fun, but it all feels extremely luck and spam based. Pretty much every class with the exception of the Spy and Sniper can be played by running headlong into the fight with your finger glued to the trigger and hoping for the best.

As much as I noobed my way through UT for years, I find myself missing the “precision” elements of that sort of game. Carefully timing armour and pickup spawns, shock-comboing someone halfway across the map, the intensity of a close CTF match. Sure there are still plenty of Flak monkeys and rocket spam, but TF2 just feels pretty flat compared to all that.

They just don’t make them the way they used to :). Quake Live doesn’t count because it’s Quake and I suck at it. Looking forward to trying Rage though, and I hope the multiplayer (on PC) is not too full of novelties like vehicles and crazy weapons. I could really do with some old-fashioned DM!

Well, in the interests of Monster Hunt surviving a bit longer, I’m releasing the full UnrealScript source code.

Included is a basic license document, outlining in simple terms what you may and may not do. Basically, you may make any kind of MH mod or ‘sub-mod’, however you must give due credit for the original creation. Even if it’s very basic, please read it if you intend using it for creating a mod.

You’ll find the file at the end of this post… Have fun :)

MonsterHuntSource.zip

How kewlies is that - UnWheel has taken it’s rightful place as the #1 voted driving mod of 2004 (across all games supported by modDB). Hehehehe.

Might as well list all UnWheel’s achievements to date for the fun of it ;)

Make Something Unreal Contest - Phase 2 (UT2003):

  • 1st place, Best Non-FPS Mod
  • 1st place, Best Vehicle
  • 1st place, Best use of Karma Physics

Make Something Unreal Contest - Phase 3 (UT2004):

  • 3rd place, Best Non-FPS Mod
  • 2nd place, Best Vehicle
  • 1st place, Best use of Karma Physics

Make Something Unreal Contest - Phase 4:

  • 7th place, Best Non-FPS Mod (can’t win em all ;-))

Make Something Unreal Contest - Grand Finals:

  • Finalist (results pending)

Other accolades and awards:

  • Bundled as one of 11 mods in the retail Unreal Tournament 2004: Editor’s Choice Edition.
  • 1st place in ModDB’s Mod of the Year - Driving category.
  • Awarded PC Zone UK’s Essential Choice, and featured on cover DVD twice (Sept + Oct 2004).
  • Featured Mod on FilePlanet’s homepage (EC/MSU Phase 4 version).
  • Featured on several magazines' cover disks throughout the world, including UK PC Gamer (Dec 2004).

Not too shabby, hey?