EasyRPG Wiki

User Tools

Site Tools

You are here: EasyRPG wiki » Development documentation » RPG Maker technical details » patches » DynRPG
development:technical-details:patches:dynrpg

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
development:technical-details:patches:dynrpg [2026/09/12 11:30] – carbonaradevelopment:technical-details:patches:dynrpg [2026/09/12 17:34] (current) – carbonara
Line 5: Line 5:
 Unfortunately, DynRPG plugins are Windows/RPG_RT-specific (read of dll files, editing of specific RPG_RT values), and as such require to be reimplemented in the EasyRPG Player through high level emulation, with patches needing to be individually analysed and ported. Games can even combine several DynRPG patches or use unique ones not seen anywhere else, making game support harder. Quick patches are also a problem, as they can pollute the code base depending on how they are reimplemented. Unfortunately, DynRPG plugins are Windows/RPG_RT-specific (read of dll files, editing of specific RPG_RT values), and as such require to be reimplemented in the EasyRPG Player through high level emulation, with patches needing to be individually analysed and ported. Games can even combine several DynRPG patches or use unique ones not seen anywhere else, making game support harder. Quick patches are also a problem, as they can pollute the code base depending on how they are reimplemented.
  
-As of version 0.8.1.1, the EasyRPG Player only has support for the DynText plugin, as well as support for some individual commands that should not matter for game compatibility (exclusive EasyRPG commands). They can all be found documented here. A game is recognised as a DynRPG game if a file named dynloader.dll is present in the folder of the game, or if the DynRPG flag is set through the EasyRPG.ini file or through command line.+As of version 0.8.1.1, the EasyRPG Player only has support for the DynText plugin, as well as support for some individual commands that should not matter for game compatibility (exclusive EasyRPG commands). They can all be found documented here. A game is recognised as a DynRPG game if a file named dynloader.dll is present in the folder of the game, or if the DynRPG flag is set through the [[https://easyrpg.org/player/manual/#_easyrpg_ini|EasyRPG.ini]] file or through command line.
  
 The TestGame-2003 includes test cases for the DynRPG patch, which can be used as references if needed: The TestGame-2003 includes test cases for the DynRPG patch, which can be used as references if needed:
-  * [[https://easyrpg.org/play/master/?game=TestGame-2003&start-map-id=14&start-position=9,8|Test online]]+  * [[https://easyrpg.org/play/master/?game=TestGame-2003&start-map-id=14&start-position=5|Test online]]
   * [[https://github.com/EasyRPG/TestGame|TestGame repository]]   * [[https://github.com/EasyRPG/TestGame|TestGame repository]]
  
Line 17: Line 17:
 A command name always starts by a @, and is usually formatted like this: A command name always starts by a @, and is usually formatted like this:
  
-''@CommandName 123, "abc", V456, VV789, N12, NV34, Hello''+<code>@CommandName 123, "abc", V456, VV789, N12, NV34, Hello</code>
  
 @commandName is the name of the command to use which is case insensitive, with all of the info after being parameters of the command, which can be of various natures: @commandName is the name of the command to use which is case insensitive, with all of the info after being parameters of the command, which can be of various natures:
Line 38: Line 38:
 ===== DynText ===== ===== DynText =====
  
-//Current inaccuracy issues: [[https://github.com/EasyRPG/Player/issues/3577|EasyRPG Player issue #3577]]//+//Current implementation issues: [[https://github.com/EasyRPG/Player/issues/3577|EasyRPG Player issue #3577]]//
  
 Patch and testcase: https://rpgmaker.net/engines/rt2k3/utilities/12/ Patch and testcase: https://rpgmaker.net/engines/rt2k3/utilities/12/
Line 64: Line 64:
  
 The command is written as follows: The command is written as follows:
- +<code>@write_text "Test", 160, 120, "Hello World", "fixed", 1, 2</code>
-''@write_text "Test", 160, 120, "Hello World", "fixed", 1, 2''+
  
   * Test corresponds to the string ID that the string will use; Note that the string ID is case-sensitive   * Test corresponds to the string ID that the string will use; Note that the string ID is case-sensitive
Line 83: Line 82:
 The command is written as follows: The command is written as follows:
  
-''@remove_text "Test",''+<code>@remove_text "Test",</code>
  
 Here, it will remove the text that uses the string ID Test. Here, it will remove the text that uses the string ID Test.
Line 93: Line 92:
 The command is written as follows: The command is written as follows:
  
-''@remove_all''+<code>@remove_all</code>
  
 ==== @apppend_text ==== ==== @apppend_text ====
Line 101: Line 100:
 The command is written as follows: The command is written as follows:
  
-''@append_text "Test", "message",''+<code>@append_text "Test", "message",</code>
  
 Here, it will add the text ''message'' to the string ID Test, by adding the new text on the current line. Here, it will add the text ''message'' to the string ID Test, by adding the new text on the current line.
Line 111: Line 110:
 The command is written as follows: The command is written as follows:
  
-''@append_line "Test", "message",''+<code>@append_line "Test", "message",</code>
  
 Here, it will add the text ''message'' to the string ID Test, by adding the new text on a new line. Here, it will add the text ''message'' to the string ID Test, by adding the new text on a new line.
Line 123: Line 122:
 The command is written as follows: The command is written as follows:
  
-''@change_text "Test", "New Text", 10''+<code>@change_text "Test", "New Text", 10</code>
  
 Here, it will change the text of the string ID Test to ''New Text'', by using the colour 10. Here, it will change the text of the string ID Test to ''New Text'', by using the colour 10.
Line 133: Line 132:
 The command is written as follows: The command is written as follows:
  
-''@change_position "Test", 20, 40''+<code>@change_position "Test", 20, 40</code>
  
 Here, it will change the position of the text of the string ID Test to the coordinates 20, 40. Here, it will change the position of the text of the string ID Test to the coordinates 20, 40.
Line 143: Line 142:
 The command is written as follows: The command is written as follows:
  
-''@call command_to_call''+<code>@call command_to_call</code>
  
 For instance, if you want to display the info message Hello World using @call, you can write it as For instance, if you want to display the info message Hello World using @call, you can write it as
  
-''@call easyrpg_output, Info, "Hello World"''+<code>@call easyrpg_output, Info, "Hello World"</code>
  
 ===== Dyn-EasyRPG commands ===== ===== Dyn-EasyRPG commands =====
Line 159: Line 158:
 The command is written as follows: The command is written as follows:
  
-''@easyrpg_add 1, 10, 5''+<code>@easyrpg_add 1, 10, 5</code>
  
 The first parameter corresponds to the variable that will be written (here, variable 1), and parameters after will be added up and then set to the value of variable 1 (here, variable 1 will be set to 10 + 5, so 15). The first parameter corresponds to the variable that will be written (here, variable 1), and parameters after will be added up and then set to the value of variable 1 (here, variable 1 will be set to 10 + 5, so 15).
Line 177: Line 176:
 The command is written as follows: The command is written as follows:
  
-''@easyrpg_output Info, "Hello $1! Variable 5 is $2, Variable 7 is $3 (variable redirection)", WORLD, V5, VV6''+<code>@easyrpg_output Info, "Hello $1! Variable 5 is $2, Variable 7 is $3 (variable redirection)", WORLD, V5, VV6</code>
  
   * ''Info'' corresponds to the token which dictates which message level should be used. It can be set to either ''Debug'', ''Info'', ''Warning'' or ''Error''.   * ''Info'' corresponds to the token which dictates which message level should be used. It can be set to either ''Debug'', ''Info'', ''Warning'' or ''Error''.
development/technical-details/patches/dynrpg.1789212638.txt.gz · Last modified: by carbonara
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki