Compiling Project

Compiling Projects

When a project had been loaded, from the Main Menu, the option to compile that project will become available. With the project loaded, you are essentially instructing PSCAT the exact location as to what files are to be compacted into a PK3 archive data file. Please be sure that the file structure matches exactly with what ZDoom is expecting, otherwise the game engine will not be able to decipher the project’s assets correctly.

Compiling Process

The PowerShell Compact-Archive Tool will perform the following procedure when compiling a project:

1. Assure that all resources are available, such as the output directory had been created.
2. Copy the project’s source files into a temporary directory.
3. Remove unnecessary files from the project’s source files stored in the temporary directory.
   1. Directories to be deleted, if exists within the temporary directory:
      1. .git
      2. .svn
   2. Files to be deleted, if exists within the temporary directory:
      1. .gitattributes
      2. .gitignore
      3. *.md
      4. Thumb.dbs
      5. desktop.ini
      6. PSCAT.Proj
4. Build a compressed PK3 archive file using the files stored in the temporary directory.
5. Delete the temporary directory.
6. Finished

The main location where the project’s source files are stored are never touched by the PowerShell Compact-Archive Tool; any changes made to the files will be done so only within the temporary directory.

Location of Compiled Builds

Compiled Builds will be stored in the current user’s My Documents folder, then navigating through the PowerShell Compact-Archive Tool directory, and then lastly stored within the project’s name.

For example:
C:\Users\Admin\Documents\PowerShell Compact-Archive Tool\TGRDM3\TGRDM3.pk3

In general form:
%UserProfile%\Documents\PowerShell Compact-Archive Tool\TGRDM3\TGRDM3.pk3