home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / dev / asm / tbsource / simcc / final / simcheat.doc < prev    next >
Encoding:
Text File  |  1993-12-21  |  11.7 KB  |  324 lines
  1.  
  2. 03/10-91                    SimCity cheat V1.07
  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. Updated: --/05-91    - for version 1.05
  10. Updated: 20/05-91    - for version 1.06
  11. Updated: 03/10-91    - for version 1.07
  12.                         
  13.  Copyright (C) Tomi Blinnikka 1991, All Rights Reserved.
  14.                     ^^^^^^^^^^^^^^^^^^^^
  15. This program is freely distributable. This means that you can copy it and 
  16. give it to all your friends, upload it to a BBS or include it in a PD-
  17. library (FISH etc.). The only restrictions are that all of the files are
  18. included in their original form without additions, deletions, or modifi-
  19. cations of any kind and that it IS NOT SOLD. THIS INCLUDES GERMAN PD 
  20. SELLERS. If you want to use this program for commercial purposes you
  21. need written permission. The SimCity cheat program is provided "AS IS"
  22. without warranty of any kind, and the author is not responsible for
  23. any damage this software may do.
  24.  
  25. ***********************************************************************
  26.   HAVE COPIES OF ANY FILE YOU WILL TRY TO CHANGE WITH THIS PROGRAM!!!
  27. ***********************************************************************
  28.  
  29. WHAT DOES IT DO?
  30. ~~~~~~~~~~~~~~~~
  31. With this program you can change the amount of money your city or game
  32. has. You can add it, or then you can take some of it away. Technically
  33. all this program actually does, is it changes a few bytes of data in your
  34. CityMap.DATA/Game.trp file. There are two ways to use this program,
  35. through DOS (only SimCity) or through intuition. When using the intuition
  36. interface you have a few nice things that you don't have if using DOS
  37. (i.e. a command line).
  38.  
  39. WHAT DO YOU NEED
  40. ~~~~~~~~~~~~~~~~
  41. If you use the Intuition-interface, you will need the Req.library in your 
  42. LIBS: directory, which is copyright Colin Fox (of Pyramid Designs).
  43.  
  44. COMPATIBILITY
  45. ~~~~~~~~~~~~~
  46. This program has been tested on a few different types of machines. If you
  47. do have problems, let me know straight away so I can fix the bug. Anyway,
  48. this program has been tested on the 68000 and 68020 processors (A1000,
  49. A500, A2000, A2500/20) and a little bit on the 68030, so it should work
  50. on the A2500/30 and A3000 as well. I have tested it also on Kickstart
  51. 1.3 and Kickstart 2.0 (37.59). I have tried to make this program 2.0
  52. compatible. I have tested it with various special 2.0 functions and fixed
  53. all the bugs I have been able to find.
  54.  The program has been tested with SimCity 1.3 and it works ok.
  55.  
  56. HOW TO USE IT
  57. ~~~~~~~~~~~~~
  58. To use the program, simply run it from the CLI or click on its icon in
  59. the Workbench. This way, it will open a window on your Workbench screen
  60. (or a public screen with the Shanghai-mode on). In the window you will
  61. see a string gadget (the box with the number in it). The amount you see
  62. in the box is the amount you will have in your game after you have made
  63. the change. If, for some reason (like running a script for all your
  64. cities), you would like to use the CLI-interface, run the program with
  65. the filename of the city after it.
  66.  
  67.  O.K. If you didn't get that here's the whole thing step by step...
  68.  
  69.     Running from the WORKBENCH
  70.     --------------------------
  71.  
  72.  Click on the program's icon. This will run the program, goto 'The
  73. INTUITION-interface', step 2.
  74.  
  75. OR
  76.  
  77.  Click once on the game file's icon while holding down the SHIFT-key
  78. and then twice on the SimCheat icon (hold down the SHIFT-key all the
  79. time, from the point of clicking _ONCE_ on the map's icon to the point
  80. where you click _TWICE_ on the SimCheat icon.)
  81.  
  82.  
  83.     The INTUITION-interface
  84.     -----------------------
  85.  
  86. 1. Run the program
  87.     1> SimCheat
  88.  
  89. 2. Choose the game from the menus.
  90.  
  91. 3. Give the amount of money you would like to have (in the game of
  92.    course :-)
  93.  
  94. 4. Choose CHEAT! from the menus.
  95.  
  96. 5. Give the filename of the game
  97.  
  98. 6. Click OK. And when it asks 'Cheat on this file?' click
  99.    OK again.
  100.  
  101. Here is some more about the windows and menus...
  102.  
  103.         THE MENUS
  104.         ---------
  105.  
  106. There are two menus in the program. The menu 'Project' has four
  107. items: CHEAT!, Help, About, Quit.
  108.  
  109.     CHEAT!    Amiga-C    - This will ask first for the filename of
  110.               your city and then change it. You can
  111.               choose CANCEL! after selecting a file
  112.               if you feel like it.
  113.  
  114.     Help    Amiga-H    - This will give you some help. If
  115.               running under Kickstart 2.0, you can
  116.               also use the Help-key. Press help
  117.               again to get help on the help (see
  118.               section below).
  119.  
  120.     About    Amiga-A    - This will give you the copyright notice 
  121.               etc.
  122.  
  123.     Quit    Amiga-Q    - This will let you leave the program.
  124.               You can also leave the program by click-
  125.               ing on the window's close gadget or by
  126.               pressing the Escape-key.
  127.  
  128. The second menu 'Games' has one item (Games 1) and two subitems:
  129. SimCity and Ports of Call.
  130.  
  131.     SimCity    Amiga-1    - Select this if you want to cheat on
  132.               SimCity.
  133.  
  134.     Ports   Amiga-2    - Select this if you want to cheat on
  135.     of Call          Ports of Call.
  136.  
  137.  
  138.     The DOS-interface (only SimCity)
  139.     --------------------------------
  140.  
  141. 1. Run the program with the filename
  142.     1> SimCheat Mydisk:MyDir/MyCity
  143.  
  144. OR if you have spaces in your directory names or filenames.
  145.  
  146.     1> SimCheat "Mydisk:MyDir/My City"
  147.  
  148. You can also get some help by running the program from the CLI and add-
  149. ing a question mark after it.
  150.     1> SimCheat ?
  151.  
  152. DIFFERENCES BETWEEN DOS- AND INTUITION-INTERFACES
  153. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  154. The main difference is that when you use the program through the DOS-
  155. interface you don't get the windows. One other major thing (using
  156. intuition) is that you get to choose how much money your city gets.
  157. Through DOS you'll always get $16, 777 215. Plus you can't (in this
  158. version) cheat on Ports of Call, Oil Imperium or Ports of Call.
  159.  
  160. HELP
  161. ~~~~
  162. Under Kickstart 2.0, pressing the help key, and under 1.3, pressing
  163. Amiga-H (or choosing it from the menus) you will get some on help on
  164. using the program. There is listed the min and max amounts a game
  165. file can have and some special info about using the program with the
  166. game. Below are listed the commands you can use in the help section.
  167.  
  168. To view the next page, press the
  169.  
  170.     N-key
  171.     Arrow right      (KS 2.0)
  172.     Arrow Up         (KS 2.0)
  173.     'Next'-gadget
  174.  
  175. To view the previous page, press the
  176.  
  177.     P-key
  178.     Arrow left       (KS 2.0)
  179.     Arrow down       (KS 2.0)
  180.     'Prev'-gadget
  181.  
  182. To quit help press the
  183.  
  184.     Q-key
  185.     ESC-key (ESCAPE)
  186.     'Quit'-gadget
  187.     Close-gadget
  188.  
  189.  To get help on help, press the ?-key. Under KS 2.0 press the help-
  190. key again. You may also scroll through the pages until you get there.
  191.  
  192. ERROR MESSAGES
  193. ~~~~~~~~~~~~~~
  194. The program checks for just about every possible error, just in case.
  195. I hate programs that crash my whole system if they couldn't open a 
  196. library etc. I also hate programs that don't give the user any kind of
  197. message if there has been a file error (say, 'No disk in drive XXX:'),
  198. and then it gives you something like 'Disk error.', so I have included
  199. the most important disk errors. The only problem is if run from the
  200. Workbench. If there is an error, like the program couldn't open lib-
  201. rary, the texts will go to a device called NIL: (i.e. you won't see
  202. the error text). If you are having trouble and not getting any error
  203. texts, to tell you what is going on, run the program from the CLI.
  204.  SimCheat also checks to see if the file you have given it is actually
  205. a SimCity/Ports of Call game-file. If the file isn't, it will tell you
  206. about it and ask if you would like to change the file anyway (for
  207. possible future versions of game datafiles that mess up my great file
  208. checker).
  209.  
  210. VERSIONS
  211. ~~~~~~~~
  212. Here is a list of changes etc. between different versions, starting
  213. with the newest version.
  214.  
  215. Version     Size    Date    Description
  216. ---------------------------------------------------------------------
  217. 1.07    15200    03/10/91 Added some size. Updated version number to
  218.              1.07. Uploaded to MITS.
  219. 1.06    11632    01/05/91 Problem with program name not fixed. Rework-
  220.              ed whole help-system (you'll most likely see
  221.              it in my other programs also). File size 
  222.              grew a lot though, so if you don't play PoC,
  223.              save version 1.04. New optimization needed,
  224.              _not_ done in this version.
  225.  
  226. 1.05     ----    --/05/91 Added stuff for Ports of Call. Thinking about
  227.              renaming again. NOT FOR DISTRIBUTION.
  228.  
  229. 1.04     7456    01/05/91 Optimized code. Size from version 1.03 (7732)
  230.              to version 1.04 (7556) dropped quite a bit! 
  231.              (Don't forget that I ADDED stuff to the pro-
  232.              gram also...) Added ability to handle quotes.
  233.              This means you can have spaces in your file-
  234.              names. Fixed some CSHELL bugs still in code.
  235.              Added version number into CLI help text.
  236.              Fixed menus by 1 pixel :)
  237.              BUGS: Unknown.
  238.         
  239. 1.03     7732    30/04/91 Fixed bug that stopped program from working
  240.              with CSHELL. Added some error texts and added
  241.              NIL: so the texts go there if run from WB.
  242.              Changed icon a little bit.
  243.  
  244. 1.02     7720    27/04/91 Fixed bug that crashed program when run from
  245.         28/04/91 the WB and the map was in a directory (!)
  246.         29/04/91 and not in the root. Fixed font bug. Added
  247.              Zoom gadget for 2.0. Fixed bug that caused
  248.              Workbench to think it has lots and lots of
  249.              visitor windows (_LVOUNLOCKPUBSCREEN =
  250.              _LVOLOCKPUBSCREEN). Added text after the
  251.              change has been made (so you don't start
  252.              wondering why isn't anything happening,
  253.              when its actually been done already...)
  254.              Checked the docs.
  255.  
  256. 1.01    6984    26/04/91 Added some Workbench stuff. Now added an
  257.         27/04/91 icon to the program. Fixed little bug that
  258.              stopped CHEAT! (from menus) from working the 
  259.              first time it was selected. Updated docs.
  260.  
  261. 1.00    6320    19/04/91 Added a dollar sign into the window. Fixed bug
  262.              that stopped program from working through the
  263.              DOS-interface. Tested program also with 68000.
  264.              Changed string gadget border from image to 
  265.              real border. Checked the documents. Added
  266.              check for files when using the DOS-interface.
  267.              Changed name from SimCCheat to SimCheat.
  268.              Added font stuff, so when 60-column mode set
  269.              in prefs, the texts come out OK.
  270.  
  271. 0.00a-     6144    18/04/91 Wrote the program. Included DOS- and Intuition
  272. 0.99a             interface, possibility to change amount of 
  273.              money for city, tested with 68020, KS 1.3/2.0.
  274.  
  275. FUTURE VERSIONS
  276. ~~~~~~~~~~~~~~~
  277. (No, no i'm not going to write an AREXX interface... :)
  278. Future versions will only have optimized code and possible bug fixes. At
  279. this moment I have nothing to add to this program :(. But if YOU have
  280. something you would like to see (a new game added to it etc.), leave me
  281. some mail, call me or contact me by some other means.
  282.  
  283. WARNING ABOUT SIMCITY
  284. ~~~~~~~~~~~~~~~~~~~~~
  285. 1. When using PublicScreens with SimCity be careful when exiting. If your
  286. PublicScreen is the default screen and it has the SHANGHAI-flag set,
  287. SimCity (when exiting) will think that it is the Workbench and will not
  288. re-open the real Workbench screen.
  289. 2. It seems SimCity will not start when there is a program that uses the
  290. audio.device, like SetBeep (It plays an IFF-sample when the screen is
  291. flashed). Remove these before trying to start SimCity.
  292.  
  293. THANKS ETC.
  294. ~~~~~~~~~~~
  295. Thanks go to Kai Sainio for reporting the bug with CSHELL. 
  296.  
  297. BUG REPORTS ETC...
  298. ~~~~~~~~~~~~~~~~~~
  299. Please send donations, bug reports, name suggestions and list of
  300. features you would like to have included in future versions to
  301.  
  302. Tomi Blinnikka
  303. Syystie 10
  304. 00780 Helsinki
  305. FINLAND
  306.  
  307. If you want the source code (it has some examples how to take care of
  308. command line inputs, WB selections, menu usage, requesters (req.lib,
  309. normal, etc. etc. + some special 2.0 stuff) contact me at the address
  310. above or you can also contact me on the following BBS:
  311.  
  312. MITS +358-0-458 2066
  313. MITS +358-0-458 2077
  314. MITS +358-0-458 2088 (Paying users with sec. level 40 or higher ONLY) 
  315.  
  316. "...trademark of Xerox Corporations. Reading legal mush can turn your
  317. brain to guacamole! Epson is registered trademark of Epson America
  318. ..." -Amiga RKRM Includes & AutoDocs, fourth page.
  319.  
  320.  
  321.                         Tomi Blinnikka
  322.  
  323.                         docbliny@mits.mdata.fi
  324.