home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD2.bin / bbs / dev / tbsource.lha / TBSource / SimCC / Final / SimCheat14.DOC < prev    next >
Text File  |  1993-12-21  |  10KB  |  258 lines
  1.  
  2. 29/04-91                    SimCity cheat V1.04
  3.  
  4. Updated: 19/04-91    - for version 1.00
  5. Updated: 26-27/04-91 - for version 1.01
  6. Updated: 27-29/04-91 - for version 1.02
  7. Updated: 30/04-91    - for version 1.03
  8. Updated: 01/05-91    - for version 1.04
  9.                         
  10.  Copyright (C) Tomi Blinnikka 1991, All Rights Reserved.
  11.                     ^^^^^^^^^^^^^^^^^^^^
  12. This program is freely distributable. This means that you can copy it and 
  13. give it to all your friends, upload it to a BBS or include it in a PD-
  14. library (FISH etc.). The only restrictions are that all of the files are
  15. included in their orginal form without additions, deletions, or modifi-
  16. cations of any kind and that it IS NOT SOLD. THIS INCLUDES GERMAN PD 
  17. SELLERS. If you want to use this program for commercial purposes you
  18. need written permission. The SimCity cheat program is provided "AS IS"
  19. without warranty of any kind, and the author is not responsible for
  20. any damage this software may do.
  21.  
  22. ***********************************************************************
  23.   HAVE COPIES OF ANY FILE YOU WILL TRY TO CHANGE WITH THIS PROGRAM!!!
  24. ***********************************************************************
  25.  
  26. WHAT DOES IT DO?
  27. ~~~~~~~~~~~~~~~~
  28. With this program you can change the amount of money your city has. You
  29. can add it, or then you can take some of it away. Technically all this
  30. program actually does, is it changes a few bytes of data in your
  31. CityMap.DATA file. There are two ways to use this program, through DOS or
  32. through intuition. When using the intuition interface you have a few nice
  33. things that you don't have if using DOS (i.e. a command line).
  34.  
  35. WHAT DO YOU NEED
  36. ~~~~~~~~~~~~~~~~
  37. If you use the Intuition-interface, you will need the Req.library in your 
  38. LIBS: directory, which is copyright Colin Fox (of Pyramid Designs).
  39.  
  40. COMPATIBILITY
  41. ~~~~~~~~~~~~~
  42. This program has been tested on a few different types of machines. If you
  43. do have problems, let me know straight away so I can fix the bug. Anyway,
  44. this program has been tested on the 68000 and 68020 processors (A1000,
  45. A500, A2000, A2500/20) and a little bit on the 68030, so it should work
  46. on the A2500/30 and A3000 as well. I have tested it also on KickStart
  47. 1.3 and KickStart 2.0 (37.59). I have tried to make this program 2.0
  48. compatible. I have tested it with various special 2.0 functions and fixed
  49. all the bugs I have been able to find.
  50.  
  51. HOW TO USE IT
  52. ~~~~~~~~~~~~~
  53. To use the program, simply run it from the CLI or click on its icon in
  54. the Workbench. This way, it will open a window on your Workbench screen
  55. (or a public screen with the Shanghai-mode on). In the window you will
  56. see a string gadget (the box with the number in it). The amount you see
  57. in the box is the amount you will have in your game after you have made
  58. the change. If, for some reason (like running a script for all your
  59. cities), you would like to use the CLI-interface, run the program with
  60. the filename of the city after it.
  61.  
  62.  O.K. If you didn't get that here's the whole thing step by step...
  63.  
  64.     Running from the WORKBENCH
  65.     --------------------------
  66.  
  67.  Click on the program's icon. This will run the program, goto 'The
  68. INTUITION-interface', step 2.
  69.  
  70. OR
  71.  
  72.  Click once on the city map's icon while holding down the SHIFT-key
  73. and then twice on the SimCheat icon (hold down the SHIFT-key all the
  74. time, from the point of clicking _ONCE_ on the map's icon to the point
  75. where you click _TWICE_ on the SimCheat icon.)
  76.  
  77.  
  78.     The INTUITION-interface
  79.     -----------------------
  80.  
  81. 1. Run the program
  82.     1> SimCheat
  83.  
  84. 2. Give the amount of money you would like to have (in the game of
  85.    course :-)
  86.  
  87. 3. Choose CHEAT! from the menus.
  88.  
  89. 4. Give the filename of the city
  90.  
  91. 5. Click OK. And when it asks 'Do you want to cheat this city' click
  92.    OK again.
  93.  
  94. Here is some more about the windows and menus...
  95.  
  96.         THE MENUS
  97.         ---------
  98.  
  99. There is only one menu in the program. The menu 'Project' has four
  100. items: CHEAT!, Help, About, Quit.
  101.  
  102.     CHEAT!    Amiga-C    - This will ask first for the filename of
  103.               your city and then change it. You can
  104.               choose CANCEL! after selecting a file
  105.               if you feel like it.
  106.  
  107.     Help    Amiga-H    - This will give you some help. If
  108.               running under KickStart 2.0, you can
  109.               also use the Help-key.
  110.  
  111.     About    Amiga-A    - This will give you the copyright notice 
  112.               etc.
  113.  
  114.     Quit    Amiga-Q    - This will let you leave the program.
  115.               You can also leave the program by click-
  116.               ing on the window's close gadget or by
  117.               pressing the Escape-key.
  118.  
  119.     The DOS-interface
  120.     -----------------
  121.  
  122. 1. Run the program with the filename
  123.     1> SimCheat Mydisk:MyDir/MyCity
  124.  
  125. OR if you have spaces in your directory names or filenames.
  126.  
  127.     1> SimCheat "Mydisk:MyDir/Some Where"
  128.  
  129. You can also get some help by running the program from the CLI and add-
  130. ing a question mark after it.
  131.     1> SimCheat ?
  132.  
  133. DIFFERENCES BETWEEN DOS- AND INTUITION-INTERFACES
  134. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  135. The main difference is that when you use the program through the DOS-
  136. interface you don't get all of the error-checks and of course you don't
  137. get the windows. One other major thing (using intuition) is that you get
  138. to choose how much money your city gets. Through DOS you'll always get
  139. $16, 777 215.
  140.  
  141. ERROR MESSAGES
  142. ~~~~~~~~~~~~~~
  143. The program checks for just about every possible error, just in case.
  144. I hate programs that crash my whole system if they couldn't open a 
  145. library etc. I also hate programs that don't give the user any kind of
  146. message if there has been a file error (say, 'No disk in drive XXX:'),
  147. and then it gives you something like 'Disk error.', so I have included
  148. the most important disk errors. The only problem is if run from the
  149. Workbench. If there is an error, like the program couldn't open lib-
  150. rary, the texts will go to a device called NIL: (i.e. you won't see
  151. the error text). If you are having trouble and not getting any error
  152. texts, to tell you what is going on, run the program from the CLI.
  153.  SimCheat also checks to see if the file you have given it is actually
  154. a SimCity city-file. If the file isn't, it will tell you about it and
  155. ask if you would like to change the file anyway (for possible future
  156. versions of cities that mess up my great file checker).
  157.  
  158. VERSIONS
  159. ~~~~~~~~
  160. Here is a list of changes etc. between different versions, starting
  161. with the newest version.
  162.  
  163. Version     Size    Date    Description
  164. ---------------------------------------------------------------------
  165. 1.04     7456    01/5/91    Optimized code. Size from version 1.03 (7732)
  166.             to version 1.04 (7556) dropped quite a bit! 
  167.             (Don't forget that I ADDED stuff to the pro-
  168.             gram also...) Added ability to handle quotes.
  169.             This means you can have spaces in your file-
  170.             names. Fixed some CShell bugs still in code.
  171.             Added version number into CLI help text.
  172.             Fixed menus by 1 pixel :)
  173.             BUGS: Unknown.
  174.         
  175. 1.03     7732    30/4/91    Fixed bug that stopped program from working
  176.             with CShell. Added some error texts and added
  177.             NIL: so the texts go there if run from WB.
  178.             Changed icon a little bit.
  179.  
  180. 1.02     7720    27/4/91    Fixed bug that crashed program when run from
  181.         28/4/91    the WB and the map was in a directory (!)
  182.         29/4/91    and not in the root. Fixed font bug. Added
  183.             Zoom gadget for 2.0. Fixed bug that caused
  184.             Workbench to think it has lots and lots of
  185.             visitor windows (_LVOUnlockPubScreen =
  186.             _LVOLockPubScreen). Added text after the
  187.             change has been made (so you don't start
  188.             wondering why isn't anything happening,
  189.             when its actually been done already...)
  190.             Checked the docs.
  191.  
  192. 1.01    6984    26/4/91    Added some Workbench stuff. Now added an
  193.         27/4/91    icon to the program. Fixed little bug that
  194.             stopped CHEAT! (from menus) from working the 
  195.             first time it was selected. Updated docs.
  196.  
  197. 1.00    6320    19/4/91    Added a dollar sign into the window. Fixed bug
  198.             that stopped program from working through the
  199.             DOS-interface. Tested program also with 68000.
  200.             Changed string gadget border from image to 
  201.             real border. Checked the documents. Added
  202.             check for files when using the DOS-interface.
  203.             Changed name from SimCCheat to SimCheat.
  204.             Added font stuff, so when 60-column mode set
  205.             in prefs, the texts come out OK.
  206.  
  207. 0.00a-     6144    18/4/91    Wrote the program. Included DOS- and Intuition
  208. 0.99a            interface, possi