UMOD/Creating

Until somebody writes a detailed technical description of the process, here's a link to an old [Chimeric tutorial].

Be sure to backup your existing Manifest.ini before compiling the UMOD file or you might no longer be able to install some UMOD files that check if UT is installed in the specified directory.

Automating UMOD Creation

When you're developing a mod or a mutator it's always a good idea to automate as much of the creation process as possible; that includes the creation of distribution packages.

There are a couple of very pragmatic reasons for that: Firstly, it's more convenient for you on the long run; secondly, once you have automated and validated the process you don't have to bother with whether the created files are complete and working in future; thirdly, last-minute changes and fixes are much more easily and conveniently applied if all you have to do to pack your distribution packages is a single double-click on a batch file.

You can use umod Wizard to have the .ini and .int files created necessary for making an UMOD installer. Then use the following batch file (for Windows):

:: UCCMaster.bat 

@echo off
if "%1" == "" goto end

copy Manifest.* OldManifest.*
ucc.exe master %1
del Manifest.*
copy OldManifest.* Manifest.*
del OldManifest.*

:end

Place this file in Unreal Tournament's System directory and simply drop your custom .ini file for UMOD creation on it. To automatize even this step, create another small batch file that calls UCCMaster.bat with the .ini file being its first command line argument.

UMOD files for UT2003: UT2MOD

Creating UT2MOD files is basically the same as creating a UMOD file. Actually the only difference is the file's extension and UT2003 as requirement instead of Unreal Tournament.

Note: You should not only create YourMod.ini and YourMod.int for creating your UT2MOD file, but also YourMod.det, .est, .frt, .itt, .kot, .smt and .tmt (just copy YourMod.int for that). Otherwise localized versions of UT2003 will display your mod as "Unreal Tournament 2003" complete with Epic Games as developer and the UT2003 website. This problem is caused by a Manifest.det, .frt, etc. in the UT2003\System directory which doesn't really belong there. It'll override the settings in YourMod.int unless you override them yourself with the corresponding YourMod localization file.

Instead of creating physical copies of YourMod.int (for the .det, .frt etc. versions), you can use the following statements in your UT2MOD file's Manifest.ini to have "ucc master" create them for you automatically when packing the UT2MOD file:

  Copy=(Src=System\Manifest.ini,Flags=3)
  Copy=(Src=System\Manifest.int,Master=System\Manifest.int,Flags=3)
  Copy=(Src=System\Manifest.det,Master=System\Manifest.int,Flags=3)
  Copy=(Src=System\Manifest.est,Master=System\Manifest.int,Flags=3)
  Copy=(Src=System\Manifest.frt,Master=System\Manifest.int,Flags=3)
  Copy=(Src=System\Manifest.itt,Master=System\Manifest.int,Flags=3)
  Copy=(Src=System\Manifest.kot,Master=System\Manifest.int,Flags=3)
  Copy=(Src=System\Manifest.smt,Master=System\Manifest.int,Flags=3)
  Copy=(Src=System\Manifest.tmt,Master=System\Manifest.int,Flags=3)

Avoiding filename problems

If you include filenames over 31 characters you'll prevent Mac users from using your mod.

If you include filenames with spaces ("My New Mod Readme.txt") you'll make it more difficult for Linux users to use your mod (the text-mode installer can cope with filenames like that, but the GUI one can't).

Please don't call your readme "Readme.txt" when you could make it clear what it applies to by calling it something like "CTF-Whatsitsname][.txt".

UMOD/Creating

Automating UMOD Creation

UMOD files for UT2003: UT2MOD

Avoiding filename problems

Related Topics