[listing] Patchs et utilitaires les plus utiles pour RM2k/3

-Nachricht --------
Betreff:    Re: Two patch
Datum:    Tue, 31 May 2011 14:39:24 +0200
Von:    Cherry <cherry@cherrytree.at>
An:    Ulysse Darmet <XXXXXX@XXXXXX.fr>


Sorry for not replying to your last message, it looks like I missed it.

You need Finder 1.20, because 1.11 (which is shipped with Power Patch Compact) doesn't work with Power Mode 2003.
Download Finder 1.20 here: http://cherrytree.at/downloads/finder.rar
I'd also suggest to use the latest, extended version of Power Patch Compact: http://share.cherrytree.at/showfile-2786/ppcomp.exe (note: this is just the ppcomp.exe file. Get the other files from the normal PPC download).

Also, make sure you have the latest version of Power Patch, which is version 0.44.

These are the steps for an unmodified project:

A) POWER PATCH
1) Rename rpg_rt.exe to rpg_rt.oex
2) Copy the following files from Power Patch into your project: powerp.cfg, powerp.oex, rpg_rt.exe, starter.exe - and the Script folder. The PlugIn folder is only needed if you plan to use additional plug-ins.
3) Open the Power Patch's demo project in RPG Maker and copy the three common events (using rightclick -> mass copy).
4) Open your project and paste the common events.
5) Make sure variables 0001 to 0011 and switches 0001 and 0002 aren't used in your project! If they are - tell me, you'll get extra instructions then.
6) Open common event "Power Patch Init" and look at the first two statements: "Change Var 0300 = -1" and "Change Switch 0300 = -1". Change "0300" to the last variable/switch ID that is avialable in your project.
7) Create an event which calls the "Power Patch Init" event when a new game is started. (Hm, maybe it's enough if you just set the common event to Parallel Process...)

B) POWER PATCH COMPACT
1) Copy ppcomp.exe and zlib1.dll to your project.
2) Run Finder 1.20 with your rpg_rt.oex file.
3) Create a file "ppcomp.cfg" in your project folder and write the line "rpg_rt.oex" in it (without quotes).

C) CONNECTING THESE TWO
Power Patch works using scripts. The scripting language is Lua. You can find Lua tutorials at the internet.
To call Power Patch Compact, you'll need Power Patch's "ExecProgram" function.
The mainloop.lua file in the Script folder is the main script. It's called over and over again as long as the game is running. The example script includes two commands (exiting the game and showing a "Hello World!" message box) which you can call from an event, and also settings to write the states of the keys "A" and "D", as well as the left mouse button, into switches; and also settings to write the mouse position in two variables. If you don't need these things, you can delete everything between "-- Tasten verarbeiten" and "Ready() -- Dem Maker mitteilen, dass der Patch fertig ist" (note that comments start with "--"), also delete "ExitGame() -- Spiel beenden" and "MsgBox("Hello World!", "Test") -- Messagebox". You can put your own commands there, like this:

if msg == 1 then
 -- here goes what should happen for command #1
elseif msg == 2 then
 -- here goes what should happen for command #2
elseif msg == 3 then
 -- here goes what should happen for command #3
elseif msg == 4 then
 -- here goes what should happen for command #4
-- and so on
end

To call Power Patch Compact, you need to use the following command:

ExecProgram(GamePath .. "\\ppcomp.exe", "PUT PARAMETERS HERE!")

(Note that ".." connects two strings, and backslashes need to be escaped with a second backslash.)

For example:

ExecProgram(GamePath .. "\\ppcomp.exe", "UNLOCKPICTURES 1")
...this will call Power Patch Compact's UNLOCKPICTURES function, which allows you to show/move/erase pictures while a message is displayed.

If you would - for example - put this line in the "elseif msg == 3 then" branch, you would need to use the following code to call it from an event:
<> Change Variable [0009] => 3 (note: 0009 is the power patch message variable. 3 is the code which is checked in the script.)
<> Call Common Event: Power Patch Msg

Okay, now about saving, loading, etc.:

== POWER PATCH COMPACT'S SAVE MANAGEMENT FUNCTION ==

SAVE <Slot> <Map> <X> <Y>
<Slot>: The save slot to be used (1 to 15).
<Map>, <X>, <Y>: Coordinates where the hero should be teleported to after loading this game. These parameters are optional.

Example:
SAVE 3
...saves in save slot 3.
SAVE 7 18 2 3
...saves in save slot 7. When this savestate is loaded, the hero will be on map 0018 at tile (002, 003).

LOAD <Slot>
<Slot>: The save slot to be used (1 to 15).

Example:
LOAD 3
...will load savestate 3.

CHECKSAVE <Slot> <Destination switch>
Checks if a savestate exists.
<Slot>: The save slot to be checked (1 to 15).
<Destination switch>: ID of a switch which will be set to ON (savestate exists) or OFF (savestate doesn't exist).

Example:
CHECKSAVE 3 123
...will set Switch 0123 to ON, if savestate 3 exists - otherwise OFF.

COPYSAVE <Source slot> <Destination slot>
<Source slot>: Save slot which will be copied (1 to 15).
<Destination slot>: Slot where the savestate will be copied to (1 to 15).

DELETESAVE <Slot>
<Slot>: The save slot to be deleted (1 to 15).

GETSAVEDATETIME <Slot> <Destination variables>
<Slot>: The save slot which's date/time should be checked (1 to 15).
<Destination variables>: ID of first variable which should be used for the date/time. You need 7 variables altogether.

Example:
GETSAVEDATETIME 3 1001
...will retrieve the date/time of savestate 3 and write it into the following variables:
1001 < year
1002 < month
1003 < day
1004 < weekday (1 = monday, ..., 7 = sunday)
1005 < hour
1006 < minute
1007 < second

Power Patch Compact cann also get a parameter from a variable. In this case, put a "V" in front of the parameter. Example:

LOAD V201
...will save the game. The save slot number will be retrieved from variable 0201.

Okay, here another example how to interface with Power Patch Compact using Power Patch:

=== BEGIN of mainloop.lua ===

Busy()
msg = GetMsg()

if msg == 1 then
 ExecProgram(GamePath .. "\\ppcomp.exe", "SAVE V21")
elseif msg == 2 then
 ExecProgram(GamePath .. "\\ppcomp.exe", "LOAD V21")
-- add other commands here!
end

Ready()

=== END of mainloop.lua ===

To save a game, you would then use the following commands:

<> Change Variable [0009] => 1 (because the SAVE function is called in the "if msg == 1 then" branch)
<> Change Variable [0021] => 5 (in case you want to save in save slot 5)
<> Call Common Event: Power Patch Msg


SOMETHING YOU MIGHT LIKE:
1) Start the game
2) Start ppcomp.exe with the parameter DEBUG (for example, use a shortcut, or use Start Menu > Run to enter c:\path\to\project\ppcomp.exe DEBUG)
3) Be happy!

You'll get a debug window, where you can save your game anytime, set up watches for variables, switches, hero position, gold, timer, etc. - which means you can watch these values and change them whenever you like. (Changing the hero position will teleport you.)

By the way, you can use this DEBUG window in ANY game, not just yours. Just run finder with that game's rpg_rt.exe and copy ppcomp.exe and zlib.dll in it :)

Best regards,
Cherry

<ABCDE>

#include "main.h"


#include <string>
using namespace std;
#include <windows.h>

/*
PowerPatch Sample PlugIn C++ Version
by Cherry and elvissteinjr

For accessing the process, you have to use this code:
int pid;
GetWindowThreadProcessId(hWnd, &pid);
HANDLE hProcess = OpenProcess(PROCESS_ALL_ACCESS, FALSE, pid);
*/



HWND hWnd; // this will hold the window handle of the game window
string GamePath; // this will hold the path of the game

// these will hold the pointers to the GetVar and SetVar functions.
// remember that you can get/set switches by specifying a negative index value.
int (*GetVar)(int index);
bool (*SetVar)(int index, int value); // SetVar will return false on failure

// this will hold the pointer to the Terminate function.
// this function terminates the game and Power Patch in a graceful way.
bool (*Terminate)(); // although declared as bool, Terminate shouldn't return at all

// exported sample function, adding variables
// call from Lua like this:
//    result = AddVars(14, 19, 22)
// ...to add variables 14, 19 and 22
int LAddVar(lua_State* L)
{
    int numpar = lua_gettop(L); // get number of parameters
   int sum = 0;
   for(int i = 1; i <= numpar; i++) // iterate through parameters
      sum += GetVar(lua_tonumber(L, i)); // read value from variable and add to result
   lua_pushnumber(L, sum); // return the result
   return 1; // tell Lua that we used one return value
}

// exported sample function, showing a nonsense message box
int LNonsense(lua_State* L)
{
   MessageBoxA(hWnd, "The quick brown fox jumps over the lazy dog!", "Nonsense", MB_OK | MB_ICONINFORMATION); // just some nonsense
   return 0; // tell Lue we didn't return any values
}

// arrays containing the names of the Lua function and their function pointers
char* FunctionNames[] = {"AddVars", "Nonsense"};
int (*FunctionsPointers[])(lua_State*) = {&LAddVars, &LNonsense};

// main function, registering Lua functions and receiving useful information
bool DLL_EXPORT RegisterFunctions(int index, LuaDec* Declaration)
{
   switch(index)
   {
      case -1:
         // receive window handle and game path
         hWnd = (HWND)Declaration->FuncPtr;
         GamePath = string(Declaration->FuncName);
         return true;
      case -2:
         // receive GetVar function
         GetVar = (int(*)(int))Declaration->FuncPtr;
         return true;
      case -3:
         // receive SetVar function
         SetVar = (bool(*)(int, int))Declaration->FuncPtr;
         return true;
      case -4:
         // receive Terminate function
         Terminate = (bool(*)())Declaration->FuncPtr;
         return true;
      default:
         // register functions
         if(index < sizeof(FunctionNames) / sizeof(FunctionNames[0]))
         {
            // fill function declaration in if function exists
            Declaration->FuncPtr = FunctionPointers[index];
            Declaration->FuncName = FunctionNames[index];
            return true;
         }
         else
         {
            // otherwise return false
            return false;
         }
   }

}

// mandatory DllMain function
BOOL WINAPI DllMain(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpvReserved)
{
    switch (fdwReason)
    {
        case DLL_PROCESS_ATTACH:
            // attach to process
            // return FALSE to fail DLL load
            break;

        case DLL_PROCESS_DETACH:
            // detach from process
            break;

        case DLL_THREAD_ATTACH:
            // attach to thread
            break;

        case DLL_THREAD_DETACH:
            // detach from thread
            break;
    }
    return TRUE; // succesful
}

#ifndef __MAIN_H__
#define __MAIN_H__

#include <windows.h>
using namespace std;

extern "C"
{
   // include the Lua header files
    #include "Lua/lua.h"
    #include "Lua/lauxlib.h"
    #include "Lua/lualib.h"
}

#define DLL_EXPORT __declspec(dllexport)

// declaration structure
class LuaDec
{
    public:
        void* FuncPtr;
        char* FuncName;
};

int LFooBar(lua_State* L);

extern "C"
{
    bool DLL_EXPORT RegisterFunctions(int index, LuaDec* Declaration); // export the interface function
}

#endif

Power patch compact v0.85

I) Présentation:

Power Patch Compact est le petit frère du Power Patch. Le PPC est un fichier exe. qui prend une commande comme paramètre et l’exécute. Le PPC peut donc être facilement contrôlé par le patch "Ineluki".

Le PPC ne fonctionne qu'avec RPG maker 2000 et 2003.

Inclus dans ce pack:
        - Power Patch Compact v0.85 Build 137 (07.06.2009)
        - Finder v1.11 Beta


II) Caractéristiques:

Le PPC, comme son numéro de version l'indique (c'est la même que celle du Power Pacht standard), possède certaines fonctionnalités du Power Patch:
        - Effectuer des calculs complexes avec les variables
        - Arrêter ou redémarrer le jeu
        - Mettre le jeu en pause
        - Enregistrer ou charger le jeu (dans les options)
        - Permet de voir, copier ou supprimer la date et heure de jeu
        - Modifié la luminosité globale (voir ci-dessous)
        - Permet de voir la date et temps du système
        - Mettre en pause le chronomètre
        - Changement de scène du jeu (voir ci-dessous)
        - Menu de stockage et de chargement, écran titre et menu du jeu (avec d'autres options)
        - Simuler les frappes
        - Changer de touches
        - Changement graphique de l'écran, de l'écran titre et du game-over
        - Interragir avec les images (voir, déplacer, supprimer) tout en affichant un message
        - Boîte de dialogue en couleur
        - Afficher la fenêtre de débogage pouvant être exécuté par les commandes et certaines fonctions du débogages sont disponibles.



III) Définitions:

1) La luminosité globale

RPG Maker a, en plus de la fonctionnalité "Ton de l'écran", une valeur de luminosité interne qui est modifié dans les transitions (Menu, éléportation, etc.) Il peut prendre les valeurs suivantes:

* 0: Noir
* 1 à 99: Rien
* 100: Normal
* 101 à 199: Rien
* 200: Blanc

Les valeurs supérieures à 200 donnent des résultats étranges (à essayer juste pour le fun)

Il peut arriver parfois un écran noir (effectuer par des changements du Power Patch Compact Scène) et donc, luminosité à 0, mais qui sera impossible de faire disparaitre. Il faudra réinitialisé manuellement en mettant la valeur = 100.


2) Scène du jeu

RPG maker utilise des scènes que l'on appelle pour organiser le projet. Le statut d'une scène ne disparait pas lors du passage d'une scène à une autre. Il y a les scènes suivantes:
- 0 = Map
- 1 = Menu
- 2 = Combat
- 3 = Magasin
- 4 = Nom de départ
- 5 = Enregistrer/ Charger
- 6 = Ecran titre
- 7 = Game Over
- 8 = Debug (F9)

Par exemple, lors d'un combat en utilisant le PPC sur une map, il peut y avoir un événement stoppant le combat, puis ensuite, on peut y revenir au même moment où l'on s'est arrêté.

 

IV) Installation

Pour utiliser PPC, il faut avoir les fichiers zlib1.dll PPCOMP.EXE dans le répertoire du projet (qui est le répertoire où se trouve le fichier d'exécution (généralement RPG_RT.EXE) et où sont situés les maps du projet). Un patch est utilisé, le fichier est renommé (ex Maker Ultime -> RPG_RT.DAT; Second Sound System -> RPG_RT_REAL.DAT) ou alors
est utilisé dans le dossier d'exécution a renommé manuellement (PPCOMP.CFG: fichier supplémentaire) pouvant être créé dans le nom du fichier qui sera exécuté en temps réel.

Après l'installation, les fonctionnalités du PPC peuvent être testés. Il faut déplacer le fichier RPG_RT.INI avec la souris sur le fichier PPCOMP.EXE.

Des erreurs sont possibles:

- Fichier non trouvé - Le fichier run-time n'a pas été trouvé. Si elle a été renommée, comme décrit ci-dessus, il faut créer un PPCOMP.CFG fichier.

- Pas de données du Finder; RPG runtime a changé - il n'ya pas de fichier disponible FINDER.DAT ou le fichier est invalide. Pour créer ce fichier, le Finder est utilisé - les Programmes sont inclus avec ce paquet. Le fichier doit être démarré Finder.exe doit être ouvert et ensuite le fichier d'exécution puis cliquez sur "Start". Après cela, il faut suivre les instructions à l'écran. Si le fichier run-time a été modifié (par exemple,
remplacé par une version plus récente), il peut arriver que l'erreur "RPG
Runtime a été changé "apparaisse. Dans ce cas, répétez la procédure ci-dessus.