Updating Gun Rocket through 10 years of Unity Engine

Join me as I update a project through 10 years of Unity editors. Along the way I will talk about my process, Unity tips and tricks, and the tech changes of Unity Engine - several of which I observed firsthand while working at Unity.

About 10 years ago I made Gun Rocket.

It was early in my game development journey. I had released 5 prototype games on Game Jolt, and it was time to sit down and make something worth paying for. I started with the idea "What if n++...but with the Asteroids ship?"

Development took about a month. The result was a game with 100 levels, multiple ships with different stats to pilot, and even a LAN multiplayer combat mode. Gun Rocket also stands out as my most lucrative personal project. After a successful Steam Greenlight process I was approached and licensed the Steam distribution rights for the game for a few years.

Recently I was reflecting on my game development journey. I tried to boot up Gun Rocket to play it. But it refused. No matter how hard I clicked the game would not open. The log is empty. I guess some driver or Windows API just doesn't work anymore.

So it is time to roll up my sleeves and bring Gun Rocket into 2026. Come along won't you? I could use the company.

Gun Rocket won't launch. What to do?

Let's start by opening the game in Unity Editor. We'll test the game in its current editor version and re-acquaint ourselves here before moving on. The version of a Unity project is stored in /ProjectSettings/ProjectVersion.txt. It's a simple file with a simple purpose. Here's what I see:

m_EditorVersion: 5.5.0f3

Looking back at the git history of this file, I can see that I actually developed the game in 4.6.0p1 in 2015. The ProjectVersion file was created when migrating from 4.6 to 5.5 in 2018 hoping it would fix a bug (it didn’t). So there's our first interesting factoid about how Unity has changed. Crazy how time flies.

Anyway! Looks like Gun Rocket was most recently developed in Unity 5.5.0f3. The current Unity tech stream is 6.5 beta. That doesn't seem so bad! Just one major version bump, right?

WRONG!

Some time around 2017, Unity decided that its numbering was not corporate-friendly. At that time they were trying to expand from gaming into more verticals. I guess corporations love versioning their software by year, so that's what Unity did. It makes the messaging about long-term support easier. Let's say Unity supports a release for 3 years. When does that end? It's much easier to talk about that for Unity 2017 (2017 + 3 = 2020) than for Unity 5.5 (???).

Nowadays Unity is back to simple numbers. Today’s major version number is 6. At least...that's what the website says. Unity version numbers now look something like 6000.4.1f1. I find this hilarious. It reminds me of Loony Tunes technology naming. Roadrunner Catcher 3000 anyone? Again, there is a good reason for this. 6000 > 2023. 2023 is Unity's last year-named version. So all of the version sorting code will continue to Just Work TM. A Good Reason. But I still find it funny.

So I open Unity Hub and look for 5.5.0f3. It's not one of the readily available options. Unity presents Official Releases (long-term support and the latest supported minor release 6000.4.1f1), Pre-releases (currently just the 6000.5.0b1 beta), and ArChIvE. We'll be spending a lot of time in the archive. I like to think of it as the back room in the basement where folks store things they just can't bear to part with yet. It's super excellent that all of these versions are kept around. It means my ambition to bring Gun Rocket into 2026 has legs - if only barely. The archive only goes back to Unity 5. Good thing I upgraded from 4.6 in 2018!

Wow, all this history and we haven't even opened the editor yet. Let's try that now.

Uh Oh. Gun Rocket won't open in 5.5.0f3.

It does the same thing as the game build on Steam: just closes with no information in the log. Shoot.

Some Google research tells me this might be related to the license check. Unity 5 pre-dates Unity Hub. So sure, it makes sense that it could be a license check issue. I try to open from the Unity.exe rather than through Hub as suggested. No luck.

Ok then, let's try a newer version. I wanted to verify the game in 5.5, but I guess I am out-of-luck. I nab the most recent Unity 5: version 5.6.7f1. Again, it doesn't launch from Unity Hub, but that's what I expect at this point. What about launching from the Unity.exe?

Success!

Wow, what a wave of nostalgia this is. Familiar and yet…feels old? Unity 5.5 absolutely feels dated to my eyes. I am sure it felt modern and sleek at the time, but opening it now...it just doesn't. One thing I remember is that the UI doesn't scale with Windows Display Settings. I have my screen UI scaled to 125%. Unity is absolutely not respecting that and all the UI feels small.

Another thing I notice here is the Standard Assets folder. If I recall correctly you could choose to put StandardAssets in your project when you created it. It includes some particles, scripts for camera and interactions, and a toon shader. Boy, look at this fire!

Cool cool cool. I have Gun Rocket open. Let's pay it forward and leave a comment on Unity Forums and then move on.

So Let’s Play!

I am grinning from ear to ear. The music was created by my friend Peter Dmitrieff and boy does it still hit. What a great nostalgia hit!

I don't have any saved game data on this computer so I move through the tutorial and then into the first level. Care to watch me flail around?

Flail. flail. Explode.

Aaaand...I explode after loading into the first level? That's not good.

After trying a few times I realize if the ship isn't moving for about 0.5 seconds it explodes. Has that bug existed all this time? Oh bother. I hope not!

Do I want to tackle bugs as they come, or should I focus on the engine migration and then tackle bugs? For better or worse I decide to keep track of bugs and fix them at the end. I'll have enough work just migrating the game through the Unity Engine changes to come without giving myself more to do in the middle.

I play a bit more to make sure that nothing is horribly broken. The save system works. I play through maybe 15 levels. I can change ships. Settings changes work. Gun Rocket doesn't have a huge UI/UX surface to cover. I play long enough to feel good about it and then decide to move on.

The Plan

Knowing all of the tech changes to Unity Engine over the years, I decide my strategy is to step one major version at a time.

Foolproof.

5.6.7f1 → 2017.4.40f1

We get off to a great start. This transition was completely uneventful. I even had 2017.4.40f1 installed already.

Looking at the git commit…really nothing happened. ProjectVersion.txt updated

Oh, and we have a new file called UnityPackageManager/manifest.json. This must be where Unity introduced the package manager. Hilarious: it’s completely empty. I don’t remember ever seeing this before. It’s so beautiful.

{
	"dependencies": {
	}
}

Unity introduced package manager as the engine grew to serve at least these 3 purposes that I can remember off the top of my head:

1. Get C# code out of the engine core to where folks could see it and modify it if they need to.

2. Allow people to select which Unity packages they wanted…or didn’t! As the engine features grow allow folks to opt in/out so they can be in control of their disk space.

3. Provide a standard for C# modules to be used by 1st and 3rd party teams.

Here’s the forum post where Unity introduces package manager in case you’re feeling frisky.

I was at Unity during the great packagification. The goals were noble, but it turns out keeping dependencies between all the teams’ various packages became its own daily bother. Maybe I’ll write about that some time, but this isn’t that post.

Anyway, this upgrade was nothing. This is going to be easy.

Narrator: chuckles

2017.4.40f1 → 2019.3.15f1

I’m feeling pretty full of myself, so I skip Unity 2018. I’ve got Gun Rocket on source control. I can always revert if I need to. I just so happened to have 2019.3.15f1 installed, so let’s skip 2018 and see how it goes.

Oh boy. The upgrade to 2019 was a doozy. There are some major moves here on Unity’s part. They are:

1. Unity removes javascript support.

2. Unity’s Networking solution, UNet, was deprecated in 2018.4 and is no longer available in 2019.1+.

3. AssetDatabase v2 happened

4. Nested Prefabs and Prefab Editing Overhaul

Well, I already clicked the import button. Let’s get after it.

Regarding javascipt:

When I first started learning Unity it supported 3 scripting languages: Boo, Javascript, and C#. I started with javascript because it was more familiar to me, but I transitioned to C# because Unity broadcasted it as the future. Circumstance saves me a huge headache here for Gun Rocket. I had written a few scripts in Javascript. 3. I wrote 3 Javascripts.

Rewriting those scripts in C# was easy. Fixing broken references to them was harder. If a reference is broken, Unity Editor doesn’t give me much to go off of.

After trying a few things I landed on a workflow of opening Gun Rocket in editor 2017 and editor 2019 side-by-side. I manually compared every prefab. Again, Gun Rocket isn’t that big a game. So this wasn’t too bad. It did take hours. For 3 scripts.

Regarding Networking:

In Unity 5, Unity had a networking solution called UNet. From my perspective it was fine. I was able to get it working quickly as a new game developer. Unity hosted servers but I didn’t want to worry about paying, so for Gun Rocket I kept it LAN-only. Remember this is 2015. LAN parties were still happening, or at least they were for me!

Gun Rocket’s LAN mode never felt like it made any waves. It was pretty simple. So the decision to just cut it out was easy.

History has a way of repeating itself. Some time around 2022 Unity introduced the Netcode for Gameobjects package. But as of 31 March 2026 they are no longer hosting servers. That has transitioned from Unity Multiplay Game Hosting Service to a company called Rocket Science Group. Will the Netcode for Gameobjects package live on much longer as a 1st party solution if Unity isn’t making money from servers?

x

Regarding AssetDatabase v2:

This update looks scary. It changes literally every asset file in my project. Looking back at Unity’s blog post about AssetDatabase v2, we can read all the great improvements this brings. Especially relevant to me are faster import times and faster platform switching.

I honestly don’t know much inside baseball about this. What I do know is conversion goes off without a hitch. Cool.

Regarding Nested Prefabs and Prefab Editing Overhaul:

Prefabs in Unity used to be serviceable, but not great. Users asked for improvements to basic prefabs for years.

In response Unity invested heavily in prefabs and here we see it pay off. You can now edit prefabs in their own virtual scenes. You can override properties on prefabs and choose later to reflect individual changes back to the prefab asset…or choose not to! You can NEST prefabs. This was all huge. It makes prefabs much more valuable and enables all sorts of new usages and workflows. Another big win.

Again, I could write an entire article about just this change, but it isn’t very relevant to this story. So let’s move on.

Other Things!

Unity Editor UI got a facelift. It feels a lot more modern. It is also scaling according to my Windows Display Settings, which is super nice.

I also notice another bug. In this version of Unity the button animations on the main menu get weirdly stuck. When they get stuck the text overlaps and it looks bad. I’ll add that to my bug list. Who knows: maybe it is fixed in a newer editor version? One can hope.

2019.3.15f1 -> 2019.4.41f2

The last update spooked me, so I download the last 2019 editor version.

I immediately notice the editor boots into a dark theme. This is another thing users asked for for a long time. It was a big deal.

Hey nerds: dark theme is dumb. Just light up your space. Eye strain comes from the contrast between a bright screen and your dark room background. Fix your lighting. Or if you insist on being a cave goblin then lower your screen brightness. Dark theme is overrated. Fight me.

There are a few deprecated APIs that Unity auto-updates. Cool.

It’s somewhere around here that I was working at Unity. I navigate to Help → About Unity and yep! There I am! I always thought it was classy that Unity just puts everyone’s name in alphabetical order. I recognize a few names as I scroll, smile, and then move on.

2019 → 2020→2021 → 2022

All I got in this leg was a few warnings about inconsistent line endings. Funny enough one of those issues is even in a Unity-published package. Lol.

2022.3.62f3 → 2023.1.22f1

It’s weird to see such a low number as the final build of Unity 2023. This must have been the last build before they switched naming back from the year to Unity 6.

On first attempt, I get package cache errors. No worries, I blow away the Library/PackageCache folder and try again. Often blowing away all or part of the Library folder fixes issues like this.

Huh. That didn’t fix it. Oh well. Let’s go for broke and skip to the latest Version 6 long-term support build instead.

2022.3.62f3 → 6000.3.12f1

Unity 6000? Now I’m living in the future!

There are some graphics settings changes. DX12 is now the default. OpenGL ES 2.0 is deprecated. No worries. My game has 5 colors. The only non-standard shader I have is a hole shader. Easy peasy.

Some APIs change. Unity fixes them. It’s just simple renames. When I worked at Unity I attended some sort of education where I wrote an API updater module. Features like these are largely invisible but solve huge pains. I’m glad they exist.

com.unity.ide.vscode is deprecated. Package Manager tells me I can continue to use it if I want. It was probably added as a default package at some point. I've never used it. So I open package manager and remove it. "Oh no! Anyways..."

I play the game again. Test all the flows. It’s working great.

I work through my short bug list without issues. The ship no longer explodes if it isn’t moving. Cool.

Keeping Score

Unity then vs Godot now

I was poking at Godot Engine recently, and it is amazing how much Unity 5.5 reminds me of Godot today: scrappy, interesting, fun, and full of potential. Will Godot drop GDScript to focus on C#? Will Godot’s size balloon as features are added? What choices will be made the same or differently as it matures? I’m excited to see how it all plays out.

Speaking of Unity ballooning in size, let’s compare Unity Install Size by version. Because numbers are fun:

2022 and 2023 were good years. Looks like they were fighting the good fight. The jump from 2023 to 6000? Woof.

Wow I am Lucky💋

I’d like to say it was my skill that made this process easy. I’m sure experienced played its part. To be honest it was mostly luck. I am lucky that I chose C# for Gun Rocket. I am lucky that I intentionally chose a very simple art direction. Most of all I am lucky that I was not yet a good enough developer to write complex systems.

Keep It Simple Stupid. Nothing about Gun Rocket is complex. Again: I made this game in a month. That’s perfect for a single-person personal project. As I chose personal projects going forward from Gun Rocket they got more complex and took more and more time. Returning now, Gun Rocket reinforces to me that simple and scrappy has its place.

What’s Next

Now that we’re on the latest Unity Editor, I have a little list of improvements to make. Then off to Steam goes the new build.

I’ll do my best to keep scope brutally small, but now that I’m back on this project there are a lot of exciting ways I can go.

• 100 new levels?

• Better out-of-bounds shader?

• Localization?

• Mod support for custom levels?