home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / dev / asm / tbsource / simcc / final / simcheat16.doc < prev    next >
Encoding:
Text File  |  1993-12-21  |  12.8 KB  |  354 lines

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