XWGob   version 0.3

  • Copyrights
  • License and Disclaimer
  • Updates
  • XWGob Features
  • Requirements
  • Changes and Known Things
  • Installation
  • Instructions
  • MZT format

  • Copyrights


    XWGob is CopyRight © David Lovejoy (StealthJedi) 1999
    Xwing vs TieFighter,Balance of Power,XWing Alliance are © ® ™ LucasArts Entertainment Company & Totally Games 1994 -1999
    Any copyright ,trademark not expressly mentioned belongs to it`s respective owner{s}.

    License and Disclaimer


    The Author grants the user of this software unlimited use of this software, provided the User agrees to the following. The user will not hold the Author responsible for any loss or damages implied,real or otherwise through the use of this software. The user accepts all risks associated with using this software.The user accepts the responsiblity for complying with game software licences in regards to distribution/modifictaion/use of game files. There is to be No Charge for this software. This software is not to be distributed by commercial means, ie: CDRom,Floppy disk. The author retains the copyright to this software, it is not transfered to the public domain. This software may be freely distributed on the internet,and BBS systems.

    Updates


    Latest updates can be found at Code Alliance Homepage    XWing* section

    XWGOB Features



    Requirements



    Changes and Known Things


    Version 0.3


    Version 0.2


    Version 0.1B


    Installation


    Unzip to any directory of your choice.

    With Winzip select the Extract button and choose a path or type one in , make sure the extract all files radio button is selected.

    With PkUnzip use the "-d" option to extract.

    You should have some ".TXT" files in the "\Data" subfolder , if not place all txt files in there. On first use XwGob will also create a couple of other directories "Patch_Files" is the default location for patch files you make.


    Instructions


    Create New Gob -

    Choose from Main Menu /File/New Gob , It will ask you for the base directory to gob, select your directory and press OK, it will open the directory,just press OK again. It will include all files in the base directory you picked including subdirectories,and show these to you in a list. If these are ok , press the Ok button ,then it will ask for a directory and gobfile name to save the gob file to , don`t put it inside of the directories to be gobbed . You will be given a list of the files in the gob ,if you want the gobfile to be created press "OK " if not press "abort" and start over.


    Open a Gob

    Opens a gob file and displays the contents , you select which files to extract . Press "Extract" then provide where you want the files extracted to.

    There are several methods for choosing files .
    Select with left mouse one file
    Select one file and then go to next file further down the list press "Shift + left mouse" all files in between will be selected
    Select individual files with "Ctrl+Left Mouse"
    Select one file and "holding left mouse down drag" down the list all files dragged over will be selected


    Open and Extract All

    You open a gob file and choose where you want all files to be extracted ,it will do the rest.


    Create Directories

    Choose a base directory , then open a directory list file (plain text) it will create the directories named in the file. You may choose to make your own lists for other directory structures you want, just remeber to put a base directory before the subdirectories for example
    Wave
    Wave\Devers
    
    below may not work
    
    Wave\Devers
    Wave
    

    The files can have any name and do not have to be in the "Data" directory,blank lines are ok ,but don`t leave gibberish in there or you will have gibberish directory names :-)


    Launch XWA

    Clicking on this will extract the files in the open gob file to XWingAlliance, any exsiting files will be copied to a subdirectory of XWGob called "Backup" , XWA launcher will then be launched ., A confirmation is displayed if you attempt to overwrite an existing backupset that has not been restored yet. If a MZT file is present in the gob it will copy the patch into the xwingalliance.exe, in all cases a backup of this file is made in the above directory, and is restored when "restore" is used.


    Restore

    Restores the backup files to XWA, The Backup directory will be empty after a restore unless you have choosen to overwrite in which case it may have left over files from the old backup set. Do not delete any files in the "BackUp" directory unless you have done a restore


    Make Patch File

    Menu item will be available only if
    The program finds xwingalliance.exe
    If the exe conforms to version 2.02

    Upon first opening ,you will see a list of 260 slots (performance area ) where there was some text avaliable they will have a name beside them.

    The rows show
    The item number
    Offset in decimal in the file for the start of that section
    Text name if available.

    You must export one or more slot items ,it won`t matter if it is the same as an original, in the case where you just want to export other sections.

    To use the patch maker click on the check box beside the parts you want to save to the patch file, then click on the Save button, if you now want to add other sections, you may click on the "Load" button to load a text file you have created.

    These files are very simple to make, you will find instructions in the file included with xwgob , in the "Data directory ,performance_slot.txt " , this file must be there so don`t overwrite it, you may make as many files as you like and call them anything with a Txt extension. Your files will work in the same manner as the perfomance area.

    (if someone makes a set of files i`ll include them with the xwgob zip)

    Note to international users : I don`t have a copy of an international version ,should the program not like your exe and it is version 2.02 it will give you a number, leave that on the Xwing message board at http://darkjedi.com/ and i`ll fix it up.


    MZT format


    This is the file format for the xwa patch utility of XWGob. Feel free to use this format in other programs if you like.It`s not designed to save a few bytes here and there ,it was designed for ease of implementation and speed. MZT file format below is quite simple, It comprises of a header, then the item entries.

    Header
    
    characters [0..42] null terminated  // text ,anything you like
    number of items                     // unsigned 16 bit   (2 bytes)     items counted from 1
    

    Then for each Item

    Items
    
    offset                //unsigned 32 bit(4bytes) , 0 to offset from beginning of file 
    NumOfBytes            //unsigned 32 bit(4 bytes), 1 to NumOfBytes
    data                  // size of NumOfBytes