|Top • Home • Introduction • Intro To Setup Design • Understanding Setup.ini • Redist Settings • Registry Values How-To • Split & Merge Large Files • Useful/Required Tools|
Ultimate Conversion Compressor (UCC) V4.1.2 Tutorial
UCC is a custom game conversion batch script, pre-encoded as a windows executable (EXE) file, it was created by myself (VollachR) for the benefit of everyone who want to create game conversion.
Welcome to the Ultimate Conversion Compressor (UCC).
In this document you will learn how to set-up and use UCC, but first, a few words on what UCC is…
So… What is UCC? Ultimate Conversion Compressor (UCC) is an advanced, mostly automated script program for compressing game conversions in order to fit the games on cheaper/smaller media, for example, converting a game from a single Blu-ray media to five (5) 4.5GB DVD discs or converting a game from a single DVD Dual Layer disc to 1 or 2 normal 4.5GB DVD discs.
Now, let's not waste any more time….
The UCC script is pre-encoded as an executable (EXE) file, despite the fact that it was written as a batch (BAT) file, therefore you cannot edit the script directly, so don't ask, I'm not going to give the script code out, that's why the script takes most variables & settings from multiple .ini files, the main one and the most important one being Settings.ini.
The UCC executable is also built in with all necessary files for all the various compressor & FreeArc external compressors available to use in UCC, therefore making a clean working environment.
First, let's take a look at the UCC folder structure:
The UCC main folder after you extract the downloaded file will comprise of the following…
The main executable is called Converter.exe and this is the file the end user will run to start the conversion.
But first, let's take a look at the folders…
The [Conversion] folder is basically a placeholder in which the compressed files are being created by default, each inside a designated folder, this is where you eventually find the ready and complete conversion if you don't select a different folder.
Now, the [Common] folder comprised of 3 additional Sub-folders as follows:
[Lists] – OPTIONAL FOLDER
The [Settings] folder is the most important folder in here, it comprised of the main settings file called Settings.ini and multiple Data#.ini files that sets the compression for each compressed archive, you will also find 3 sample Data#.ini files in this folder.
The Settings.ini File
The first thing you'll see when you open the Settings file is that it is well organized with section headers and basic explanation for the included features.
This file is also the most important file, it is where you set most of the variables that tells UCC how to look & behave. It is built into various sections, each named, organized & includes basic explanation for each function within the section.
Let's begin with the first section…
VISUAL ENVIRONMENT VARIABLES
Here are the available settings you'll find there:
Title=Your Title Here
Now, let's break them apart to understand what each of them is…
This OPTIONAL setting controls the background color of the console window, there are 14 available colors to choose from, the full list and values for each is listed in the INI file.
Note: If Color2 is not set this will change the text color instead, the background will remain default black.
This OPTIONAL setting controls the color of the console window's text, there are 14 available colors to choose from, the full list and values for each is listed in the INI file.
If set to 1 UCC will use the default title which is derived of the %GameTitle%, %conversionBy%, %Discs#% & %DiscType%, all of which are also set in Settings.ini
A custom title of your own for the UCC window title bar, used only if DefaultTitle=0
GENERAL CONVERSION VARIABLES
There are more options available here than the previous section, some are optional, others are required and some are used by other options, here's the list:
Let's break them down…
This setting must be set, it is the name of the converter, usually your name or nickname, used in many aspects of the UCC script.
This setting must be set, it is the name of the person who created the file lists and tested the compression levels, could be your name or some else's if you got help, could also be more than one name, used at the beginning of the UCC script.
This setting must be set, it is the name of the person who designed the Autorun/Setup of the conversion, usually your name/nickname or a partner who helped you, used at the beginning of the UCC script.
This setting is OPTIONAL, it is used to give out additional thank you for anything you want.
This setting is OPTIONAL, it is used to list the music tracks used for the conversion.
This settings controls a variables that allows the UCC script to account for All-In-One/Collection conversion, it has only one value: "y" (without the quotation marks), set it up if you're making an AIO conversion, otherwise leave it blank.
This settings is also for AIO conversion, here you set the number of games in your conversion, it will allow UCC to account for the number so it will know how many "executables values" to check for.
Note: refer to EXE1-EXE9 sub-section in GAME VARIABLES section for more information
This setting is meant to tell UCC if the game is steam or retail/other source, it effects the example folder shown and also the default game folder, the available values are "y" or "n" (without the quotation marks)
This settings point to where the steam games are installed, there's usually no need to change it but I decided to make it available for change in case it needs be.
This setting is OPTIONAL, it is used to specify a name or address of a website for which you make the conversion on, only use if you are making the conversion exclusively for that site.
This setting is OPTIONAL, it is used to tell UCC if the game you are converting require file splitting, there's only one value: "y" (without the quotation marks), if the game requires file splitting set this up and UCC will start REV0's splitter.exe before compressing the game, leave it blank if unused.
This tells UCC the amount of discs the conversion results in, for example, if the end result is 5 DVDs type 5.
This tells UCC the type of media the conversion creates, for example, if the conversion is for 5xDVD5 type DVD5.
This section is used to set information related to the game or games you are converting, it is comprised of the following options:
Now I'll explain what each of these is…
This option must be set, it is where you set-up the name of the game you are converting or the name of the AIO conversion you make, it is also used to set the example & default folder, as well as the UCC window title.
This option must be set, define here which company published the game/games the conversion is for, this option is also used for the example & default folder, as well as the UCC window title.
This setting must be set, it tells UCC how to name the various discs folders in the conversion, for example, if your game is ABCD and you want the disc folders to be ACD_1, ACD_2 and so on, set this to ACD.
This setting is OPTIONAL, it allows you to set a custom default folder for your game, useful if the game default folder do not use the publisher name or only uses part of the game's name.
This 9 settings are used to set the game(s) executable file(s), the EXE1 setting must be set or UCC will give you an error, it is what tells UCC what executable to look for after the game's folder is selected, if the file isn't found in the selected folder UCC will return an error and will give the option of using the default folder or choose again. If the game executable is inside a sub-folder you need to include the folder name/names as well (i.e. Binaries\Win32\Game.exe) EXE2-EXE9 are only used for AIO collections in accordance with the number set in GamesInCollection option at the GENERAL CONVERSION VARIABLES section.
GENERAL DATA FILES VARIABLES
This section is used to set general variables that relates to naming the data files and some data files related behavior.
Let's take a look at what these do
This option must be set, it tells UCC to create only 1 data file or more than 1 data file, there are 2 options "y" or "n" (without the quote marks), if set to "y" UCC will create only 1 data file and will ignore any data#.ini file other than Data1.ini. If set to "n" UCC will create as many data files as there are Data#.ini files, if there are 3 Data#.ini files than 3 data files will be create, if there are 5 than 5 files will be created and so on.
This option must be set, it tells UCC what extensions to use for the data files, most common are CAB or BIN.
This option must be set, there are 2 possibilities, "y" or "n" (without the quotation marks), it tells UCC if the conversion should be made for only 1 disc or not, if set to "y" (yes) all data files will be put into the same folder & the folder name for the disc will be comprised from the MediaPrefix setting alone.
Note: If this option set to "y" the Disc option in the Data#.ini files have no effect.
This option must be set, it tells UCC what to use for the data files name before the file number, for example: if set to ACE will result in data files named ACE1.EXT, ACE2.EXT and so on, when EXT is the extension set under the EXT setting.
This options allows you to select if you prefer to input the list of files to include/exclude in your compression directly in the Data#.ini files or in separate list files, there are to variables "y" & "n", if set to yes "y", you must create a separate list files for each data file and then input the list files names in the include/exclude option in the Data#.ini files, if set to no "n", you need to input the files to include/exclude directly in the data#.ini files.
If using external list files they must be located inside the [Common\Lists] sub-folder to be found & used.
AUTOMATIC AUTORUN.INF CREATION VARIABLES
This section is used to tell UCC how to fill out the autorun.inf file in each disc of the conversion, it is comprised of the following options:
Here's are the options explained:
This setting tell the UCC what to add after the game name & before the disc number in the LABEL value inside autorun.inf, the result in the autorun.inf file will be comprise of %GameTitle% - %LabelSuffix% #, if the game is named ABC and you type DVD in this setting it will result in Label=ABC – DVD 1 for the first disc in the conversion, and Label=ABC – DVD 2 for the 2nd and so on, if only 1 disc is available in the conversion the result will be Label=ABC DVD
Sets the action= label prefix in the autorun.inf on the first disc, the suffix will always be equal to %GameTitle% so if the GameTitle is set to Fallout 4 and Action set like above example the result will be "Install/Play Fallout 4"
That's it for the Settings.ini…
The Data#.ini Files
Now, alongside the Settings.ini file, the [Common\Settings] folder comprise of multiple data#.ini files which all have the same settings in them:
Include=File1.ext File2.ext File3.ext
IncludeEN=ENFile1.ext ENFile2.ext ENFile3.ext
Let's take a look at these options:
This tell UCC what compression method to use for this specific data file, this can be any method supported by FreeArc, Winrar or 7zip without the switch beginning (-m for freearc & rar or –mx for 7zip), in the example above method 0 is used which mean no compression, files are just stored in archive. This option must be set.
(1)External compressors, can be combined with any other FreeArc method & each other, further external compressor options can be set here as well (e.g. srep+lzma:a1:mfbt4:d256m:fb128:mc1000:lc8)
(2)7Zip method # sets compression level, 0 is store only, all the others uses lzma but can be set to a different compression method by adding =MethodID when MethodID is replaced with the name of the method, available methods are: lzma, lzma2, PPMd, BZip2, Deflate, Copy (no compression), these methods can be combined together to enhance compression.
There are also quite a lot of presets (48 to be exact) for the FreeArc compressor that are used to easily set some more complex combined compression methods such as precomp+srep+lzma or srep+rar+lzma.
|Preset Name||Full Method Command|
This tells UCC what files to compress, separate the file with a space, wildcards are allowed, files or folders with spaces in the name must be quoted like this: "My Folder\My File"
This options are used to compress only one language of the game, it tells UCC what files to include for the specific language of the game only, it works exactly the same way as the regular Include option.
This tells UCC what files to exclude from the current Data archive, This can be a single file or multiple files, if entering multiple files separate them with a space and put each file inside quotation marks ("), for example: "File1" "File2" "File3*" "Dir\File*".
You can also exclude multiple files with wildcards by typing something like this: File*.ext
This will exclude all files beginning with the word File that have the extension EXT.
As long as only 1 value is entered here and there are no spaces in the file/folder name there is no need for quotation marks.
This options are used to compress only one language of the game, it tells UCC what files to exclude for the specific language of the game only, it works exactly the same way as the regular Exclude option.
Note: If more than 2 languages please input files for all languages to exclude, so if the selected language is English and other languages are Italian & German input all Italian & German language files under ExcludeEN option.
This tells UCC to what disc number within the conversion this specific data file belong, for example if the MedaiPrefix is set to ABC and this value set to 3, the data file will be put in the folder ABC_3. This option must be set.
Note: If OneDiscOnly option is set to "y" this option have no effect.
This tells UCC what program to use for compression, it set individually per data file, the available options are: arc, 7zip, rar. If left blank UCC will use arc compressor.
Note: Please take under consideration the Custom Installer Ultimate V2 (CIUv2) have a certain archive extraction priority, it will first extract the FreeArc files, then 7zip files and lastly the rar files.
General Note: If LastData value in Settings.ini is set to 1, the Data1.ini file will be used for the first data file, there's no need for Data.ini file anymore.
That's it for the [Settings]….
The [Setup] Folder
But wait, there's another folder called [Setup], what's that about?
Well, simple really, just drop you Setup.exe & Setup.ico file in there, UCC will then distribute them automatically to the correct folders and create/edit the autorun.inf accordingly.
The [Lists] Folder
The [Lists] folder is an optional folder used only when the UseFileLists option in Settings.ini is set to "y" (yes), it is where you need to place the .lst or .txt files that contains the list of files to Include/Exclude, these files names are then typed in the appropriate Include/Exclude option in the Data#.ini files. If UseFileLists is set to "n" (no) in Settings.ini this folder should be removed before you release your conversion.
That's it, you now know all there is to know to make a conversion using UCC v4.1.2
Continue reading to learn how to use UCC after you set it up…
Using UCC (After you finished setting it up)
Now that you finished setting all the INI files (and also the list files if you're using them), let's run UCC and learn how to use all its functions:
When you first run UCC you will be asked to choose the location where the game you are converting is installed on your computer (figure 1):
If your press Cancel on the browse window you will be shown a Yes/No choice asking if you want to use the default folder or try to select again (figure 2):
If you answer yes by pressing the Y button, UCC will use the example (e.g) folder shown at the beginning or the folder defined under the DefaultDir option in Settings.ini, pressing no (N) will return to the beginning and let you choose a folder again.
The next step is to choose the output directory for the conversion (figure 3):
This is where the conversion files will be created, whatever folder you select will have a new folder created inside of it which is named by using the MediaPrefix, Discs# & DiscType options in Settings.ini, it is within that folder that the conversion will be created.
By pressing the Cancel button you will direct UCC to use the default location to create the conversion, which is the [Conversion] folder that comes with UCC.
After that you will be asked what you wish to do when the conversion ends:
As you can see in figure 4 above, there are 3 options:
Shutdown PC – Will turn your computer off at the end of the conversion, there's a 15 seconds delay to allow the user to abort the shutdown if he/she wishes or close any other program that still works.
Reboot PC – Will perform a restart to your computer at the end of the conversion, there's a 15 seconds delay to allow the user to abort the reboot command if he/she wishes or close any other program that still works.
Exit – This will just close the UCC window when the conversion ends.
Next you will be asked if you wish to create ISO files for the conversion:
Select yes (Y) to create ISO file(s) before the conversion ends or no (N) to not create ISO file(s) (figure 5).
The next step depends on your answer to the ISO creation question, for the purpose of this tutorial I will assume you answered yes.
You will now be asked to choose the location in which to save the ISO file(s) (figure 6):
The folder you choose will have the ISO files for your conversion when all things are done, if you press the Cancel button you will tell UCC to create the ISO file(s) in the same directory where the conversion files are.
Next up is the language menu (figure 7), this menu will only show up if at least one of the Data#.ini files have Include/Exclude options set for specific languages:
This menu lets you choose which of the game's language files you wish to keep when compressing, only one language is selectable. Type the number which correspond with the desired language and press ENTER to continue.
At this time UCC will begin compressing (figure 8) your game files:
If no errors occur during compression UCC will proceed automatically to the next data file until it reaches the last one to be created and will then give you the compression finished message as show in figure 9 bellow:
UCC will then distribute the setup files (figure 10) to the conversion folders:
It will then continue and declare the location where you chose to save the ISO files (figure 11) if you selected to create them and begin the ISO creation (figure 12):
Once the ISO creation is completed a finished message will appear and UCC will perform the action you chose for the end of the conversion (figure 13):
If you chose not to create ISO file(s) you will see figure 14 bellow instead:
That's it, all done, you now know how to set-up & use UCC.
Enjoy the Ultimate Conversion Compressor (UCC)
Ron Vollach (VollachR)
|Top • Home • Introduction • Intro To Setup Design • Understanding Setup.ini • Redist Settings • Registry Values How-To • Split & Merge Large Files • Useful/Required Tools|