home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / PHOENIX.LZX / Phoenix_int.doc < prev    next >
Encoding:
Text File  |  1995-07-24  |  11.7 KB  |  346 lines
  1.  
  2.                 
  3.                       P H O E N I X Version 1.0
  4.                       =========================
  5.     
  6.     
  7.     
  8.     
  9.     
  10.                      (c) 1995 by New Wave Design    
  11.  
  12.                      All rights reserved!
  13.                      
  14.                      
  15.                      
  16.               International, freely distributable version.
  17.               
  18.               
  19.               
  20.           Chapter 1:
  21.           
  22.                 - Introduction..........1.1 
  23.                 - About PHOENIX.........1.2
  24.                 - Distribution..........1.3
  25.                 - Requirements..........1.4
  26.                 - Installation..........1.5
  27.                
  28.           Chapter 2:
  29.                
  30.                 - The Interface.........2.1
  31.                 - The modes.............2.2
  32.                 - Workshop..............2.3
  33.                 
  34.           Chapter 3:
  35.            
  36.                 - Compare-Mode..........3.1
  37.                 - Backup................3.2
  38.                 - Thanx to..............3.3
  39.                 - Future Plans..........3.4
  40.                 
  41.                 
  42.                 
  43.                         C H A P T E R  O N E                                           
  44.                        ^^^^^^^^^^^^^^^^^^^^^^ 
  45.               
  46. Introduction:              
  47.                            
  48.    PHOENIX is an easy-to-use program which allows everyone to change
  49.    data in saved games. For example, it`s more than easy, to give one-
  50.    self a bunch of money in any kind of managergame or any other game
  51.    that saves games. 
  52.    (To be honest: PHOENIX doesn`t work with Lucasfilm-Adventures AFAIK,
  53.    but I`m working on it.)
  54.    I didn`t choose the name Phoenix because I like the capital of Arizona,
  55.    which I`ve never been to, but because getting more money in a game
  56.    may be represented by Phoenix, rising from the Ashes. Maybe a little
  57.    too metaphoric, but I like stuff like that :-)))
  58.  
  59.    Phoenix uses a very simple, but efficient way to change the values:
  60.    
  61.    First you tell Phoenix for which value it ought to search, in case you
  62.    only have 4$ left, you tell Phoenix to search for 4.
  63.    Then you tell Phoenix by which value the original value is to be replaced.
  64.    (1000.000$ is often very handy...:-))
  65.    
  66.    Anyway, this method doesn`t work always, that`s why I included 4 
  67.    different search-methods. 3 of them can be used in this Version, the 4th
  68.    method comes with the registrated version. With this you can virtually
  69.    deal with EVERY game, as long as you`re clever enough to registrate :-)) 
  70.    
  71.  
  72. About PHOENIX:
  73.  
  74.    Phoenix is, well erm..., some kind of Shareware, more exactly it`s
  75.    Crippleware. That`s because I think it really IS useful, especially
  76.    if you`re one of those guys who like playin` games.
  77.    I spent a lot of time coding it, and I think that in case you`re
  78.    using it regularly, it would be more than fair to pay for it, right?
  79.    
  80.    To make it easier for you to decide if you want to pay the requested
  81.    fee, I built in something which I`d like to call "Payment Motivation".
  82.    From time to time, a requester will appear, tellin` you that you`re
  83.    using an unregistered version of Phoenix.
  84.    The other "Motivation" is that the most powerful, but not always 
  85.    neccesary function "COMPARE" can`t be used in the FD-Version.
  86.    
  87.    Now I guess that all of you are convinced, that Phoenix is a proggy
  88.    which is really worth being paid for, am I right?
  89.    It`s only 10 DM or 5 British Pounds or 30 French Francs or 7 US$,
  90.    or the equivalent of the above in any other European currency.
  91.    Additionally you ought to send me an envelope with either enough stamps
  92.    (in Germany) or an international reply coupon (from any other country)
  93.    plus an empty disk.
  94.    
  95.    In case there will be updates (that depends on the number of people
  96.    who registrate, and the number of suggestions), all registrated users
  97.    can get them for half the price.
  98.    
  99.    As stated above, I`m always interested in suggestions and bugreports,
  100.    so feel free to send them along with your registration to:
  101.    
  102.                            Volker Schlecht            
  103.                            Ziegelstrasse 22
  104.                            70734 Fellbach
  105.                       Federal Republic of Germany
  106.                       
  107.                       Or just contact me via :
  108.  
  109.                        2:246/1416.59 (FidoNet)
  110.                        karras@amiuni.tynet.sub.org (UUCP)
  111.                        
  112.    Please understand, that I can`t accept registrations sent via the Net.                      
  113.  
  114.  
  115.  
  116. Distribution:
  117.  
  118.    
  119.    Ha, that`s a really easy one : You may distribute this Version freely,
  120.    AS LONG AS (aaahhh.. here it comes..) all files contained in the original
  121.    archive are spread together.
  122.    
  123.    
  124. Requirements:
  125.  
  126.    
  127.    You need 3 eggs, 1/2 l fresh milk, 1/2 pound of sugar....
  128.    
  129.    Naahhh...All you need is an Amiga with at least Kickstart 2.04, and
  130.    maybe 1MB RAM (Not so sure `bout this, maybe it also works with 512K,
  131.    but does anyone work with that ??). 
  132.    Ah, yes, and you need the Reqtools.library by Nico Francois, but that
  133.    should be just like the RAM..... everyone has it...
  134.    
  135.    
  136. Installation:
  137.  
  138.    
  139.    Ahhhh... you have a HD? Now it`s getting more complicated. Be sure,
  140.    that you read this twice, because it can go very wrong. It really IS
  141.    some kind of hard to install, and you could do a lot of damage to
  142.    your HD.
  143.    
  144.    Now here it is:
  145.    
  146.    Just copy the program to any drawer on your HD where you want it to
  147.    be. If you like its Icon and doc-file, copy them also, otherwise forget
  148.    about them.
  149.    
  150.    Make sure you understood all of it :-))))
  151.    
  152.    
  153.  
  154.             C H A P T E R  T W O
  155.                ^^^^^^^^^^^^^^^^^^^^^^      
  156.                
  157. The Interface:
  158.  
  159.  
  160.    The method of using PHOENIX follows a completely new and revolutianary               
  161.    concept......as long as you use a PC. For Amiga-Users a graphical user-
  162.    interface with full multitasking is quite normal, and that`s what it is.
  163.    
  164.    The GUI consists of two parts. One is the part with the gadgets in, and
  165.    the other one is the part where Phoenix informs you about everything it`s
  166.    doing. This might not always be neccesary, but I like programs doing 
  167.    this. 
  168.    The comments that Phoenix shows are so obvious that they don`t need 
  169.    further explanation. 
  170.    
  171.    The gadgets might be a little more cryptic, so I`ll explain `em :
  172.    
  173.    LOAD  : Guess what ?? Right! This loads a game!
  174.    
  175.    SAVE  : Saves it again.
  176.    
  177.    INFO  : This is the MOST important part of PHOENIX. It informs you
  178.           about itself and ME!
  179.          
  180.    START : Who needs that ? It just starts the search.
  181.            
  182.    
  183.    Search for : Here you tell Phoenix for which value it is to search for.
  184.    
  185.    Replace by : Here you tell Phoenix which value you want instead.
  186.    
  187.    
  188.    ASCII Search  : Checkbox. With this one you activate the ASCII-Search
  189.               mode. The mode is described in 2.2
  190.              
  191.    String Search : See above.
  192.    
  193.    Backup        : Backs up the original game, before saving the changed
  194.               one. Always useful, switch it on!
  195.               
  196.               
  197.    COMPARE       : Ha! This one starts the COMPARE-mode which probably
  198.                    is the most powerful function in Phoenix. Unfortunately
  199.                    you`ll have to registrate before you can use it.:-) 
  200.  
  201.    QUIT          : That`s a function you can use in all versions. It quits
  202.                    Phoenix.                                 
  203.    
  204.    
  205.    
  206. The Modes :
  207.  
  208.  
  209.    1) Search & Replace
  210.    -------------------
  211.    
  212.    This is the primitive but fast usual method. It searches for a value
  213.    in the saved game and replaces it by another value. This does not work
  214.    if a value can be found in the game twice or more, which can occur with
  215.    very small values. If Phoenix tells : "Not unequivocally found!", you
  216.    have to use COMPARE, which you can`t use in the unregistered version.
  217.    
  218.    Search & Replace is started by the "Start" Button.
  219.    
  220.    2) ASCII & String Search
  221.    ------------------------
  222.    
  223.    Maybe a value in a game isn`t saved as a value, but as a character or
  224.    a string. In that case this method leads to success. It`s use just the
  225.    same way as Search&Replace
  226.    
  227.    3) Compare
  228.    ----------
  229.    
  230.    See chapter 3.1
  231.    
  232.    
  233. Workshop:
  234.  
  235.    
  236.    Now, to make it easier for you to understand the way PHOENIX works,
  237.    I decided to write a little "Workshop". For this we use an imaginary
  238.    saved game which contains the following values:
  239.    
  240.    
  241.    Cash:  $345    (saved as a word, for those who know what that means.)
  242.    
  243.    Lives: 3       (saved as ASCII-Character)
  244.     
  245.    Score: 123     (saved as String)
  246.    
  247.    depts: $10.000 (Saved as word, but 10.000 occurs two times in the game)
  248.    
  249.    
  250.    First I guess you`d like $20.000 rather than $345, so we tell Phoenix
  251.    to search for 345 and replace it by 20000 (Don`t use a "." in numbers!!).
  252.    Then we press the "START"-Button, and wait a while. After some time,
  253.    Phoenix opens a requester, telling us, that it has found the value, and
  254.    asks if it shall replace it. We click on "Yes", and that`s it. 
  255.    Afterwards we save the game, and play on with some more money.
  256.    
  257.    Now, you need more lives than just 3. But the method above doesn`t work.
  258.    Now there`s still the possibility that they`re saved as ASCII, in that
  259.    case just switch on the ASCII-Search Checkbox, and do as described above.
  260.    
  261.    The same goes for the string search.
  262.    
  263.    Getting your depts down to 0 is a little harder, because Phoenix can`t
  264.    find it unequivocally and therfore doesn`t knoe which value to replace.
  265.    That`s why "Search & Replace" doesn`t work here. In that case you use
  266.    "COMPARE". You just compare your game with another on, which you saved 
  267.    right after starting the game, so it contains the original values.
  268.    (In that case 0 depts.), now you load your game, tell which value 
  269.    "COMPARE" is to search for, and by what it`s ought to be replaced, then
  270.    you click on "COMPARE" and with the requester appearing, load the 
  271.    game containing the original values. After a while Phoenix should show
  272.    a requester telling "Value in game: 10000. Value in original : 0",
  273.    so you know that Phoenix found the right value, and clicking on 
  274.    "Replace" does the job.
  275.    
  276.    BTW, you don`t have to search for a special value with COMPARE, it
  277.    also can show any difference between the two games. Often also helpful!
  278.    
  279.    COMPARE is a registrated-version-only function!
  280.    
  281.    
  282.             C H A P T E R  T H R E E
  283.             ^^^^^^^^^^^^^^^^^^^^^^^^
  284.             
  285. COMPARE-Mode:
  286.  
  287.    See chapter 2.3 for explanation.
  288.  
  289.  
  290.    
  291. BACKUP:
  292.              
  293.    I haven`t got very much to say about this. It`s just a function which
  294.    ALWAYS should be switched on.
  295.          
  296.       
  297.       
  298. THANX TO:
  299.  
  300.  
  301.  - Every single Heavy-Metal Band who released on of the CD`s I have. They`re
  302.    far too much to list here, but their music was a great help while writing
  303.    the program and the docs.
  304.   
  305.  - Markus Junginger for writing the MegaEd and releasing it as PD.
  306.  
  307.  - ACID-Software for the Blitz-II Compiler.
  308.  
  309.  - ESCOM for buying C=.
  310.  
  311.  - Each one of you who read this text until here.
  312.  
  313.  - My Amiga for running this proggy nearly bug-free :-)) 
  314.  
  315.  
  316. Further Plans:
  317.  
  318.  
  319.    First I have to say, that I really have plans to improve Phoenix,
  320.    but in how far I can realize this depends on the number of people
  321.    who registrate or at least tell me, that they`re using it. I`d really
  322.    love to know if you like PHOENIX, even if you don`t registrate, tell
  323.    me your opinion anyway. I can be reached by the addresses in chapter
  324.    1.2.
  325.    
  326.    Now here are the plans:
  327.    
  328.    - A small built-in Hex Editor for hard-to-cheat games.
  329.    
  330.    - Improved "Compare"-Mode
  331.    
  332.    - An ability to load packed games might also be useful
  333.    
  334.    - Maybe a runtime-search method which allows to change values while
  335.      the game is running in a multitasking environment.
  336.      
  337.      
  338.    Sounds nice, dunnit? And don`t forget, that all registrated users
  339.    will get eventual updates for half the price.
  340.    
  341.    
  342.    
  343.              HAVE FUN WITH PHOENIX !!                  
  344.              
  345.              
  346.                    Volker Schlecht, 24.7.1995