@database SWOSEditor V1.3
@node MAIN
@title "SWOSEditor V1.3 ©1996 Mark Green."
                      SWOSEditor V1.3 (16/04/96)
                      --------------------------
                        © 1995-96 Mark Green
                       ----------------------
@{" Introduction              " link INTRO}                @{" Other Swos Editors        " link OTHER}
@{" Standard Disclaimer       " link DISCLAIMER}                @{" Requirements              " link REQUIRE}
@{" Archive Contents          " link CONTENT}                @{" What is it?               " link WHAT}
@{" Usage                     " link USAGE}                @{" The Shareware Concept     " link SWARE}
@{" My save-file doesn't load " link PROBS}                @{" Magazines read this       " link MAGS}
@{" Bugs                      " link BUGS}                @{" History                   " link HISTORY}

@{" SWOS Kit Editor v1.01     " link KITED}                

@{" Future - What Next-       " link FUTURE}               @{" Other programs by me      " link OTHERA}
@{" Credits                   " link CREDS}               @{" Contacting the author     " link CONTACT}
@{" Technical Information     " link TECH}

@endnode

@node INTRO "Introduction..."
Introduction...
---------------

    This program is a save game editor for the excellent Sensible World of
    Soccer or SWOS as it is better known.

    It has been programmed and updated over the past few months.

    I am no longer going to improve this version, instead I have started
    V2.0 which will have many more features and a better interface.

@endnode

@node OTHER

Other SWOS editors Available.
-----------------------------

    To my knowledge there is 1 other SWOS editor available. This was
    written by Piotr Bieniek. I believe people should own both of these
    editors because his editor is different to mine.


    There are a couple of differences which I should point out

    1).  My version edits Save-Game-Files so there is NO chance of damaging
         your SWOS disks with it (Even though I won't guarantee that it
         won't damage you save-files.)

    2).  Save files are NOT crunched so after editing save-files shouldn't
         take up more disk-space. Where-as Piotr hasn't included a crunch
         routine within his program so there may not be enough room on SWOS
         disk 2 for the edited file.

    3).  Piotrs' version allows editing of other teams, My save-editor
         doesn't allow this (Yet V2.0).

    4).  You can't edit the '95,'96 version with Piotrs version as the
         crunch routine is more up-to-date, but with my editor you can.


    Piotr if you are reading this then please don't take my criticisms
    personally. I am just trying to outline the difference between the two
    versions. Also my editor is called SWOSEditor and not SWOSED. If you
    feel you want to criticise my program then please feel free. I would
    like to wish you luck in incorporating a crunch-routine as without one
    your editor is almost un-usable as most people don't have 6 megs of ram
    needed for the HD installer.

    Anybody else reading this then I strongly advise you use both programs
    as they are different. I will be keeping SWOSED and I hope Piotr and
    other people will keep my version.

@endnode

@node DISCLAIMER

Disclaimer
----------

    This program and all its associated files are Shareware. They may be
    freely distibuted and used as long as the following conditions are
    met:

         1). The archive contents remain intact @{" Archive Contents " link REQUIRE}
         2). The only fee charged is that of handling and carriage costs.
         3). All executable files are NOT altered, tampered with or used
             for anything illegal.
         
         
    I will not be held responsible for any damage this program may cause to
    your machine and/or your SWOS save game, or any other files.

    I have thoroughly tested it and there should be no problems.

    The contents of this archive are the Copyright (c)1996 Mark Green.
    The games SWOS and SWOS '95/'96 are (c) 1995 Sensible Ltd.


    SwosEditor v1.3 and SwosKitEd v1.0 has been tested on the following
    configurations:

    Amiga A600  1mb Chip  0mb Fast  (Kick v2.04)
    Amiga A600  1mb Chip  1mb Fast  (Kick v2.04)
    Amiga A1200 2mb Chip  0mb Fast  (Kick v3.0)
    Amiga A1200 2mb Chip  4mb Fast  (Kick v3.0)
    Amiga A1200 2mb Chip  4mb Fast  Apollo A1220 Accelerator (Kick v3.0)
    
    They work perfectly well on all of the above configs. If you have a
    different Amiga and either program doesn't work please let me know.
    
@endnode

@node REQUIRE "Do I need a Super Amiga?" 
SWOSEditor and SWOSKitEd require:
---------------------------------
       These Editors require the following:

   An Amiga (A bit obvious Really)
   Kickstart v2.04+
   1MB of Memory
   The SWOSED.FONT in FONTS: 
   The ReqTools.Library V38+ in LIBS:
   The Diskfont.Library in LIBS:
   A Sensible World Of Soccer Save Game File.


   All those Kick 1.3 owners out there had better upgrade.
   If I get Enough interest I MIGHT consider doing a 1.3 compatible version

@endnode

@node CONTENT "Contents of the Archive"
    
Archive Contents:
-----------------

    The data held in this archive is shareware, you may freely distribute
    it as-long as the following files are in the archive AND are not
    altered:

        SWOSEditor1.3          ; The main program.
        SWOSEditor1.3.info     ; Icon for main prog (Can be changed).
        SWOSEditor.doc         ; Docs for SWOSEditor.
        SWOSEditor.doc.info    ; Icon for doc (Can be changed)
        SWOSEditor.Guide       ; Amigaguide Docs
        SWOSEditor.Guide.info  ; Icon for Amigaguide docs (Can be changed)
        SWOSKitED              ; Program for changing the kit
        SWOSKitED.Info         ; Icon for KitED (Can be changed)
        Install                ; Install Script for Hard Drive
        Install.info           ; Install Icon (Can be changed)

    Please keep all the above with the archive.

    
@endnode

@node WHAT "What the hell does it do then?"

What does it do?
----------------

    This editor allows you to alter various things within your SWOS team.
    Here is a list of things that can be changed. Any option with a + will
    probably have a button within the editor but it won't do anything yet.
    This is because I might not include it.

    The Following can be changed:

        Team Name
        Mangers Name
        Players Names
        Players Attributes
        Players Position
        Players Nationality
        Players Skin/Hair colour
        Money in bank 
        Players values
      # Kit Editor
      + Tactics Editor  (I can't see much use for this but I might write it)

      # Kit Editor is included as a separate program.

    The Following Players Attributes can be changed. The range is 0-15 with
    15 being the maximum.

        Passing
        Shooting
        Heading
        Tackling
        Ball Control
        Speed
        Finishing  (Shot Power)

    I could have included the following but I decided they would probably
    totally spoil the playability of the game:

        Number of Goals Scored by a Player
        Number of Games Won/Drawn/Lost
        League Position
        Points on League Table
        Whether a Player is on LOAN (May be included yet)

    If you would like any of the above including, then write or EMAIL me. If
    I get enough interest in any of the above I will then include it in the
    next version. Also if you have any Ideas on new features then don't
    hesitate to let me know. Anybody sending me a good Idea will recieve
    the registered version free.

@endnode

@node USAGE "So.....How do I use it then?"

How do I use it?
----------------

    Erm. Simple really, you shouldn't need to read this!

    On startup you will be presented with a requester to choose which
    version of SWOS you are using. Click on the button determining the
    version you own. Please ensure you select the correct version otherwise
    the program may behave strangely.

    You will then be presented with a file requester to select your save
    game file. Select your file it will then be loaded.

    You will now notice 30 buttons arranged into 2 columns on the left
    side of the screen. Next to these buttons are the players names. To
    edit a player depress the button to the left of his name. All his stats
    will then appear in the gadgets in the box on the right.

    The string gadget at the top of this box allows you to edit the players
    name. The next 7 gadgets allow the players personal attributes to be
    changed. The 3 buttons below allow you to change face/hair, position
    and, select what nationality a player is. Clicking on one will bring up
    a window to which you can change the required setting. The nationality
    will firstly let you select the continent and then the country.
    The last button allows you to remove any injuries and/or cards the
    player may have incurred.

 
    The gadgets located along the bottom/right of the screen allow you to
    edit the team name, and money. There are also 4 other buttons:

        Load   - Load a save game file (Will also bring up requester to
                 select version being used).
        Save   - Save a save-game-file
        About  - About the editor
        Quit   - Oh come on it's obvious


    Finally there are 2 string gadgets located in the bottom right corner.
    These enable you to edit your managers name. The top gadget alters
    his/her forname (Max 8 chars) and the lower gadget alters his/her
    surname (Max 12 chars). I haven't added the option of altering the
    managers nationality (Next version perhaps).

    All the above buttons are also present in the menus.

    
@endnode

@node SWARE "What's Shareware then Bob?"
The Shareware Concept:
----------------------

    Shareware is a concept where you may try a program before registering
    (Paying). This program is shareware but unlike other shareware programs
    it isn't limited in any way. All I ask is if you use it regularly and
    get some enjoyment out of it you to send me something (Anything from
    a postcard to cash, I don't really mind).

    The more people who send me a donation will give me an inclination of
    the size of the Amiga community, I will then decide whether it's worth
    writing more programs.

    To register @{" Press " link CONTACT} for my address

@endnode

@node MAGS "What do we do then?"
Magazines.
----------

    The editor may be included on any magazine coverdisk. All I ask is that
    the whole archive is included, and that a copy of the months magazine
    it appears on is sent to me.

@endnode

@node BUGS "Arhhhhh no not them....!"
Known Bugs
-----------
     There is one tiny bug, but it doesn't affect the use of the program

     if you select to load another file and then cancel the editor will
     quit-out.  I am currently trying to solve this problem.

     If you find any send me a detailed description of the bug and 
     send it to me at@{" My Address " link CONTACT}

@endnode

@node HISTORY "What has been changed and added.."
SWOSEditor Version History
--------------------------

(16/04/96)
   V1.3 Released

    1). Players Values can now be edited
    2). Added Iconify button. (Maybe pointless but all other progs have
        them).

(14/03/96)
   V1.22.1 released

   No major update. I just positioned and resized some of the gadgets.
   When Sysihack, Framihack and Urouhack are used the text is now properly
   positioned. Simply cosmetic.

(11-02-96)
   V1.22 released

    1). Replaced the cruddy ASL requesters with Nico François' excellent
        Reqtools Requesters.
    
    2). The file SWOSEdInc is no longer needed instead it has been included
        within the executable binary.

    3). Added more gaming information to the About requester. 

    4). Finally Finished the Kit Editor. Included within the archive as a
        separate file. Sorry to say it doesn't work on pre-aga machines yet

    5). Because of some stupidness on my behalf all versions prior to this
        one wouldn't work on a 500+ or 600. This has now been fixed and the
        program should now run on all Amigas' with Kickstart v2.04+

 --------------------------------------------------------------------------

(03-01-96)
   V1.21 released

   Fixed a couple of silly bugs:

   1). ASL File Requester opened on Workbench instead of the SWOSEditor
       Screen. Now opens on the SWOSEditor screen.

   2). A Small bug in the editing of the team name caused the team name to
       have the letter of the original name remaining. EG. If you changed
       NEWCASTLE UNITED to SPLOGS ATHLETIC the editor would save the name
       as NSPLOGS ATHLETIC.

   3). Checks to see if the SWOSED.font is in FONTS: and the ASL.LIBRARY is
       in LIBS:

   4). A small oversight on my behalf meant that any save file which is
       embeded deep within a directory structure would cause the
       information within the Info box to spread out into the gadgets on
       the right. So I have removed the information box. Instead I have
       replaced it with a logo. The information has not been deleted it
       has simply moved into the ABOUT requester.

   5). Removed the INSTALL program from the archive. Now uses Commodore's
       Installer utility.

   6). Included AmigaGUIDE documents.

   7). Cursor now moves into the next string gadget when changing stats.
       This removed the need to select each one with the mouse.

 --------------------------------------------------------------------------

(27-12-95)
   V1.2 released

   Combined V1.1 and V95/96 into one program. It is now about 10k larger
   than either of the other versions and about 85k smaller than the other
   versions added together.

 --------------------------------------------------------------------------

(25-12-95)
   V95/96 released:

   A version specifically for the 95/96 version of SWOS. Otherwise the same

 --------------------------------------------------------------------------

(23-12-95)
   Bought SWOS '95/'96 update and played with it.

 --------------------------------------------------------------------------

(12-12-95)
   V1.1 released.

   Added the info box at the bottom
   Fixed another bug with the save option.
   Allows user to save a file with LOWERCASE letters and it converts it to
   UPPERCASE
   Adds the .CAR to the Save file if user forgets it.

 --------------------------------------------------------------------------

(2-12-95)
   V1.0 finished added the following:

   New screen layout.
   Ability to alter managers name
   alter player attributes
   remove bookings/injuries
   change money
   rename team
   Automatically converts all data to UPPERCASE (This was important)

 --------------------------------------------------------------------------

(27-11-95)
   Removed a save bug (Sometimes wouldn't save)

 --------------------------------------------------------------------------

(25-11-95)
   Beta test version (v0.9) finished. (Not Released)
   Could only alter player names

 --------------------------------------------------------------------------

(22-11-95)
   Idea concieved. Preparation and ideas

@endnode

@node FUTURE "What's on the horizon now?"

The Future.
-----------

    I am currently working on a couple of new projects they should be
    finished shortly, they are:

    SwosEditor v2.0   -  New version featuring a newer better interface
                         that uses Listviews and Cycle gadgets. It will
                         also have all the things I couldn't fit or be
                         bothered to include in the current versions.

                         (Might not finish this program as existing editor
                         does the job well enough).
                         

    DetroitED         -  Savegame editor for the excellent Detroit.

@endnode

@node CREDS "Who do we blame for this program?"

Credits.
--------

    The idea, conception, and programming is courtesy of: Mark Green.

    The games SWOS and SWOS '95/'96 were programmed by Sensible Software.
    The games SWOS and SWOS '95/'96 were published by Renegade.

    Thanks must go to the following people:

    Sensible Software for this brilliant game.

    Lee Wilkins and Simon Tooth for their help in deciphering the save files.
    And also bug hunting.
    Dave and Sue for testing it on an Amiga 500+

    The following people for the amazing leagues we have played:

    Daniel Green
    Mick and Gary Roberts
    John R. Lamb (even though he is totally crap)
    Simon Tooth
    Lee Wilkins.

    And to all the Amiga owners who have helped keep the machine alive. If
    it wasn't for people like you the Amiga would be dead. Stick with the
    Amiga and if a Software House stops supporting the Amiga then write to
    them. If they still say NO then it's their loss.

    A final word to Sensible Software.

      Don't Abandon the Amiga lads. As you have probably noticed SWOS is
      still riding high in the charts, even though it has been on sale for
      more than twelve months.

      And please release a version that is HD installable. It takes Sooooo
      long to load from disk.

    If you have this program yet you don't possess SWOS then buy it NOW.
    You don't know what you're missing.

@endnode

@node PROBS "I've got a different version"

    There are a few versions of SWOS floating around this editor currently
    only supports two versions. The version numbers are held within the
    save game file and the main SWOS files. The editor currently supports
    the following versions:

    CJ0612235###
    CJ0112114###

    The hashes are not important they have something to do with what
    machine the game was loaded into.

    If you have a different version to those supported the editor will tell
    you. Send a copy of your save game file and 3 pounds Sterling @{" to me " link CONTACT}.
    also include the following information:

    Name of your team.
    Name of the Manager.  (Important for finding location of team)
    Amount of money in your bank account


    I will then update the editor and send you the new version which will
    enable you to edit your save files.

@endnode

@node CONTACT "You wanna contact me then?"

Okee Dokee. I hope you use and enjoy this program as much as I enjoyed
programming it.

Contact me concerning any of the following:

    Bugs    (God I hope not!)
    Improvements or possible additions
    Information on new programs
    or anything else.

Here is my current E-Mail address.

    A word of warning I don't go on-line very often so it would probably be
    better to contact me via slow-mail

- @{fg highlight}mark_andrews@metnet.demon.co.uk@{fg text}

    or write to:

    Mark Green
    13B Gerard St,
    Derby,

    DE1 1PA.


    Finally If you create any decent or funny save-game-files then send
    them to me.

@endnode

@node TECH "Some intiguing info"

Technical Information
---------------------

    This editor was programmed on an Amiga A1200 with an Apollo A1220 ram
    accelerator (I should have a Blizzard 1260 with 8 megs ram by May 1996)
    and a Quantum Maverick 540meg hard drive held all that precious data.

    Blitz Basic 2 was used to program the Editor.

    There seems to be a problem with the WTITLE command in Blitz. It
    doesn't seem to want to work on any Kickstart v2.04 machines. If
    anybody has any idea why I would be eternally grateful if you let me
    know.

    Deluxe Paint 4 AGA was used to create the Graphics
    Personal Fonts Maker v2 was used to create the Swosed Font.


Information on the Swos-Save files

    Each player in Swos is allocated about 38 bytes in Swos. These 38 bytes
    hold all the details about a player i.e. Shirt number, value,
    attributes etc.... Below are some values I've used within the editor.

    The position of the first player is actually the players nationality if
    you move 38 bytes through the file you will be positioned on player 2's
    nationality. The attributes are about 22 bytes in from the start of a
    players data. it can be recognised if the player is not injured or
    booked by the following ##000#######?? the first two hashes are the
    players skin/hair colour and also his chosen position. The next two
    numbers (Usually 0) hold details on whether a player is booked or
    injured, and finally the 7 hashes that follow are the players
    attributes. Straight after the attributes you have got the players
    value (represented by ??). I haven't figured out exactly how swos
    handles the values yet but as-soon-as I do I will incorporate it into
    the editor.

    Well this is all I can be bothered to type for-now below are the file
    offsets for the players details.

    Version CJ061223: Original Version

    Postion of number of Players in save-file           56719
    Position of Team Name in save-file                  55431
    Position of managers forename in save-file          54989
    Position of managers surname in save-file           54998
    position of managers name in save file              55462
    position of first player in save file               55502
    position of money in save-file                      54744
    position of first tactic                            88378
    position of version number                          90618


    Version CJ011211: 1995/1996 Updated Version

    Postion of number of Players in save-file           57485
    Position of Team Name in save-file                  56197
    Position of managers forename in save-file          55134
    Position of managers surname in save-file           55143
    position of managers name in save file              56228
    position of first player in save file               56268
    position of money in save-file                      54748
    position of first tactic                            96222
    position of version number                          98462

    If you suss out the players values send me the information and I will
    update the Editor. I will also give you the credit for sussing the
    values out.

@endnode

@node OTHERA "Other programs by Mark Green"

I have also written the following


 Text Reverser : A totaly useless program that reverses text input into it
                 One of my first programs

 Swoseditor #.# : Editor for Sensible World of Soccer save game files.
                  There are loads of versions floating around. Latest
                  version is V1.3 - (16/04.1996)

@endnode

@node KITED "The Kit Editor"

                         SWOSKitEd v1.01
                         ---------------

                           Written by:
                           Mark Green.

                    @{ " Introduction     " link INTRO2}
                    @{ " Disclaimer       " link DISCLAIMER}
                    @{ " Requirements     " link REQUIRE}
                    @{ " Usage            " link USAGE2}
                    @{ " History          " link HISTOR}



@endnode

@node INTRO2 "Introduction to SWOSKitEd"

Introduction.
-------------

    The SWOSKitEd has been written to allow the user to easily change
    his/her teams kits for the game SWOS.

    It has been included as a separate program to the main editor as to
    allow easier and quicker access and usage.

@endnode

@node USAGE2 "How to use the Kit Editor"

Usage.
------

    When the Editor first loads you will be presented with a requester to
    select the version of SWOS you use (Press CANCEL to quit). After
    selection a file-requester will appear for you to select your CAREER.
    Once loaded you will be presented with 8 buttons (4 have pictures of
    shirts on them). A palette selecter, a display of the kit, and a cycle
    gadget.

    They do the following:

    Cycle Gadget:    Change between editing your Home/Away kits
    Shirt Gadgets:   Choose the different types of shirt supported by Swos
    Load Gadget:     Load another career for editing
    Save Gadget:     Save career with new kit colours
    About Gadget:    Some info about program
    Quit Gadget:     Quit program

    Palette:         On selecting this you will be presented with another
                     requester. The requester allows the following:

               Shirt:    Select shirt as the chosen colour
               Stripe:   Select the Stripe (2nd shirt colour) as the chosen
                         colour
               Shorts:   Select chosen colour for shorts
               Socks:    Select chosen colour for socks
               Cancel:   Forget operation

                      Also only the last 9 colours on the palette can be
                      selected. This is due to the fact SWOS only allows
                      editing of 10 colours. I have scrapped the Grey
                      colour.
@endnode

@node HISTOR "History file for Kit Editor"

History.

(11-02-96)
   V1.0 Initally released.

(14-03-96)
   V1.01 released.

   Minor update. Changed the size and position of the gadgets. The program
   now looks okay if used with Sysihack, Framihack, and Uroukhack

@endnode
