Written and compiled in VS2019 using C# and WPF.
It works by scanning your game assets folder /baseq3/ for pk3 files and changing the file extension to disable/enable them, and also allowing you to view the metadata of each .pk3 by means of the pk3's package comments.
1. System Requirements
- .NET Framework 4.7.2 Runtime
- Windows 7 SP1 or newer
Linux users: You will need Winetricks to run this application!
QLMM_setup.exeand follow the on-screen directions. Remember where you install the program to, or create a shortcut on your desktop.
2.2. Linux/Mac/BSDIf you don't already have WINE and Winetricks installed, install them from your package manager of choice.
Using Winetricks, select
Select the default wineprefix > Install a Windows DLL or Component, and install
dotnet472plus any other files you may need which you are missing. If you run into any problems during installation, please read the troubleshooting tips on WineHQ's AppDB for workarounds.
wine QLMM_setup.exein the folder where you saved the installer, and follow the on-screen directions. Remember where you install the program to, or create a shortcut on your desktop.
3. Compatible GamesQLMM currently has official support for:
- Quake III: Arena
- Quake Live
- Warfork (and by extension, Warsow)
3.1. Quake III: ArenaAs of version 22.214.171.124, Quake III may show some extra files in the QLMM window that you did not install. This does not happen with Quake Live since Quake Live's default filenames are blacklisted from the file search. You can customize the blacklist in future versions to mitigate this problem, but until then, you should compile your own copy of QLMM if you want a custom blacklist.
3.2. Quake LiveQuake Live has out-of-box support, and if is installed to the right location QLMM will set everything up for you.
3.3. WarforkWarfork uses a custom version of the Quake II engine called QFusion, but it uses the same file formats as idTech3, so it is compatible with QLMM. However, the same issue with Quake III: Arena is here: a custom blacklist will be needed in order to hide the stock game files.
Keep in mind that Warfork organizes itself a little differently. In the game's install folder, the baseq3 folder is usually found at
fvi-launcher\applications\warfork\Warfork.app\Contents\Resources\basewf\as opposed to simply
You may need to extract the PK3's contents or else Warfork may override them with the default game files!
4.1. Importing ModsidTech3 uses the ZIP format, often also labeled as PK3, to store game assets.
When importing, QLMM will ask you for which mod file you wish to import.
If you were to look for said mod in the baseq3 folder, you may notice that the file name is completely different from the file you just imported. This is for two reasons:
- Quake Live's main assets are stored in pak00.pk3. Quake Live loads pk3s in a specific order, so naming your mod starting with pak01_whateverblahblah helps prevent the mods from being cancelled out by the game itself.
- Some mods may have the same file name, so to prevent QLMM from overwriting one you already have, it will add a random number to the end of the file name, followed by the extension.
4.2. Creating MetadataQLMM reads metadata from the mod's comments, not a file inside. This allows us to store our own data inside of the PK3, without interfereing with the game, and without having to extract the mod (incase it is incredibly large).
To create metadata, you will need a ZIP archiving tool (e.g., WinRAR), with the ability to edit comments. Paste this template into your PK3's comments, after removing any existing comments. Edit the values as needed:
"name": "Put your mod's name here.",
"author": "Put the creator's name here.",
"description": "Put your description here.",
5.1. QLMM crashed, what do I do?Oh no, that's sad! Here's what you can do to fix it:
- Move all of your mods to a different folder for a moment. If QLMM successfully starts after that, it's probably an issue with how QLMM parses mod data, so send me whatever mods you have installed so I can test them and fix the issue.
- Ensure that
ICSharpCode.SharpZipLib.dllare in the same folder as
QLMM.exeand that it is the right version of the file. QLMM relies on these files to perform file operations, and the versions included with QLMM also have a special certificate attached so you know that it came from me and not someone else. The library DLLs must be available and signed with QLMM's certificate. Both of these criteria must be met or QLMM will not start.
- Reset your settings. You can find them at %LocalAppData%\bonkmaykr\QLMM\data.json. Delete the file, and restart QLMM.
5.2. When opening QLMM, I got a popup telling me that it couldn't find my game files. Help!When you start QLMM for the first time, it scans certain folders to see if Quake Live is installed. If Quake Live is not installed, or if you installed it somewhere other than the default Steam library folder location (usually C:\Program Files (x86)\Steam\steamapps\common), QLMM will not be able to find the game on it's own.
To solve this problem, you must fill in the two boxes with the right file path, as shown below:
The game's executable path is not needed unless you start the game with the "Start Game Directly" option. If you would like, you can leave it blank.
To obtain the location of your
baseq3/folder, open your Steam Library, then right click Quake Live in the games list on the right. Hover over "Manage", then click "Browse local files". Explorer will open. Look for a folder named "baseq3", open it, and copy the file path from the address bar at the top.