OmniTweaker

Create/Edit a game profile

Game profiles (.otz file) are located in your 'profiles' directory in the OmniTweaker install folder. They are actually just text files, so use Notepad to edit them and/or make new game profiles.

General Settings

[Title]
{game name}
{date} (dd-mm-yy)
{author} (your name)

I think this speaks for itself. It is crucial that you set the date correct! OmniTweaker reads the date to see if there is a newer version available so it can not have mistakes. Example of a date: 31-12-05

[Syntax]
{look-a-like installpath}
{configfilename}
{string}cvar{string}value{string}
{on}|{off}

You need to provide OmniTweaker with a look-a-like installpath. This text appears when OmniTweaker asks you to save your default config save location. It exists to help you find the correct folder to save your configs in. Example: C:\...\BG2\System\
Configfilename should be the name of the config file OmniTweaker will save by default (e.g. config.cfg). Next comes the syntax of the config, a string is just a line of text. Let's say for example that a line in the config looks like this:

cl_updaterate "20"

Then the syntax line should look like this:

cvar "value"

Got it? Good :). After that it gets even more easy, you need to determine which value is 'on' and which value is 'off'. Usually it's '1' and '0' respectively, but it could also be 'True' and 'False'.

CVars

There are 5 types of cvars in OmniTweaker: (Ping) Simple, Multi, (Ping) Text. Let's start with a Simple cvar.

[Add Simple]
{cvar}
{default}|{high quality}|{high FPS}|{ultra FPS}
{short description}
{long description}

A simple is a cvar which can only be turned 'on' (='1') or 'off' (='0'). Below the cvar itself you need to specify the default value for the cvar, the high quality value, the high FPS value and the ultra FPS value. So for example: 1|1|1|0. You should always write '1' or '0', regardless of the values you specified for 'on' and 'off' in the general settings. The short description should be kept under 50 characters. The long description is the more extensive description you see in the yellow description box and should be between 100 and 400 characters.

You can also add a special version of the simple, called a ping simple.

[Add Ping Simple]
{cvar}
{us OR dl}{< OR >}value
{short description}
{long description}

In this version, you do not have to specify any preset value's. The ping simple is turned 'on' if the specified condition is met. First you choose to write either 'us' or 'dl', 'us' is the users upload speed and 'ds' is the users download speed in bytes/s. Then you choose either '<' or '>', and finally you set the value to be met. You have to read the condition like so: IF (us OR ds) IS (lower OR greater) THAN (value) THEN TURN CVAR 'ON', ELSE TURN CVAR 'OFF'.

You can also add multi's, which act as a list of different value's for a cvar.

[Add Multi]
{cvar}
{listitem 0}|{listitem 1}|{listitem 2}|...|{listitem x}
{cvar value 0}|{cvar value 1}|cvar value 2}|...|{cvar value x}
{default}|{high quality}|{high FPS}|{ultra FPS}
{short description}
{long description}

The first line after the cvar itself specifies the text you see in the dropdown box in OmniTweaker. The second line determines the value for the corresponding listitem. You can set the presets by typing in the 'index' of the listitem in question. For example, if 'listitem 2' is the default value, then you should type '2' as the default value

The last type is a textbox type, which comes in two flavours (ping and non-ping).

[Add Text]
{cvar}
{min value}|{max value}
{default}|{high quality}|{high FPS}|{ultra FPS}
{short description}
{long description}

If there are too many value's possible to contain in a multi, then you can use a text cvar. It allows the user to input a value himself.

[Add Ping Text]
{cvar}
{min value}|{max value}
expression(ds,us,^,*,/,+,-)
{long description}

It's almost the same as a text cvar, only it doesn't have presets. Instead, you have to type an expression using any combination of us (upload speed), ds (download speed), +, -, *, / or ^. For example if the optimal value for the cvar 'rate' is your download speed in kbytes/s then you would have to use this as an expression:

ds/1024

Well that's it for the cvars! You can also make your game profiles look pretty with markup...

Markup

You can add tabs:

[Add Tab]
{tab name}

And you can add labels, which also serve as topic-separators, but within one tab.

[Add Label]
{label}

You can jump to the next column like so:

[Next Column]

And finally, you can also insert a certain amount of space (defined in pixels) between 2 objects.

[Add Space]
{space} (in pixels)

This can be especially usefull in combination with [Add Label], because you might want to add about 10 pixels before adding a label to differentiate topics better.

That's it! Now you can start making your own professional looking game profiles!

Content & Design © 2005