How to make a patch PK3
Started by Tig
Tig Rep. 1234
#1   28 Feb 2016
There are many maps on ..::LvL that have small errors like missing textures, sounds, .arena files or even bot files. This is the preferred way that you as a player or fellow developer can fix these issues.

1) Find the issue and locate a suitable fix.

2) Create a PK3 that contains ONLY your fix. Do NOT touch the original PK3 at all. It will be explained below why.

3) Name your patch PK3 something like z-original-filename.pk3. The z- prefix makes sure that your PK3 is loaded last and will override anything from the original PK3. With missing files this is not so important but is still a good habit to have.

4) Include a simple text file that includes details about what has changed or been added. This helps others work out if they even want to use the patch PK3.

Now you can play the map with your fixes and so can other players.

Why not update the original map?
There are a number of reason however the most important is you do not want to create a conflicting PK3. For example, at a LAN game or online a number of security and anti-cheat checks are performed. If you have a PK3 that is different to that of the game server you will not be able to join that match.

Another reason is you are not the author of the original work. It is not your job and you should NOT touch the released version of someone's work. While different, it is a little like going around the neighbourhood and fixing someone's house because you see a problem without asking the owner first.

The next reason is once a modified version of a map is available to others (via a download link for example) you have polluted the Internet with an invalid version of a release. It now becomes harder to work out which is the correct version.

While all this is not a problem at home playing bots, it is an issue with online and LAN matches.

Correctly compiled patches are welcome to be submitted to ..::LvL as well. Use the contact page - - to submit them. I'll add patch files to the bottom of the review for others to download.

FistMarine Rep. 2476
#2   03 Mar 2016
Thanks for the guide Tig. It should clear confusion for people who want to create fixes.
Colton Rep. 329
#3   03 Mar 2016
I requested this be made FistMarine. So some of the credit automagically goes to me because of that... hugs myself
Colton Rep. 329
#4   06 Mar 2016
I request that this thread be stickied for the people looking for tutorials on how to do this... and their questions could be posted on this thread...
FistMarine Rep. 2476
#5   20 Sep 2016
My bad Colton, I didn't know you requested this.

Anyway I could try to make some patches myself and submit here because there are some issues I noticed with some maps.

Neon_Knight Rep. 113
#6   29 Feb 2020
Just for the record, maps released under the GPLv2 license or similar do allow other people to modify the map (freedom #2) and distribute the modified version (freedom #4). In order to do so, however, access to the source of said map (the .map file) and a license file are required to be packaged in the same archive the map is located, and the derivative must follow the same rules.
Edited 2.15 minutes after the original posting.

Only registered members can post a reply.
Already registered? Sign in.