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