EasyRPG Wiki

User Tools

Site Tools

You are here: EasyRPG wiki » Development documentation » RPG Maker technical details » Known patches » Maniac Patch » New commands
development:technical-details:patches:maniac:new-maniac-commands

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
development:technical-details:patches:maniac:new-maniac-commands [2026/10/09 13:48] – carbonaradevelopment:technical-details:patches:maniac:new-maniac-commands [2026/11/09 14:57] (current) – carbonara
Line 9: Line 9:
 ===== Get Save Info ===== ===== Get Save Info =====
  
-//Player status: Supported //✅//; Requesting the name of the first party member is currently not supported and makes the command fail, requesting info from a null or negative save does not work//+//Player status: Supported// ✅//; Requesting the name of the first party member is currently not supported and makes the command fail, requesting info from a null or negative save does not work//
  
 The Get Save Info command (セーブ情報の取得) allows to directly retrieve info from a save file. The Get Save Info command (セーブ情報の取得) allows to directly retrieve info from a save file.
Line 19: Line 19:
   * Level: Variable that should receive the level of the first party member of the save file. If there is no member in the party, the retrieved value will be 0.   * Level: Variable that should receive the level of the first party member of the save file. If there is no member in the party, the retrieved value will be 0.
   * HP: Variable that should receive the current HP of the first party member of the save file. If there is no member in the party, the retrieved value will be 0.   * HP: Variable that should receive the current HP of the first party member of the save file. If there is no member in the party, the retrieved value will be 0.
-  * Name Destination: String variable that should receive the name of the first party member of the save file. ⚠️// This option is not directly accessible through the Maniac editor, and requires using the community plugin, TPC, raw writing or another tool.//+  * Name Destination: String variable that should receive the name of the first party member of the save file. ⚠️ //This option is not directly accessible through the Maniac editor, and requires using the community plugin, TPC, raw writing or another tool.//
   * Picture ID for Face Graphic: Picture IDs that should be used to retrieve the FaceSets of the party members. The IDs to use can either be constants or values of variables. The pictures will be placed at coordinates 0, 0, using an overworld and battle picture layer 7 with a transparency of 100%, with the other parameters being the default picture parameters.   * Picture ID for Face Graphic: Picture IDs that should be used to retrieve the FaceSets of the party members. The IDs to use can either be constants or values of variables. The pictures will be placed at coordinates 0, 0, using an overworld and battle picture layer 7 with a transparency of 100%, with the other parameters being the default picture parameters.
  
Line 59: Line 59:
 ===== Save ===== ===== Save =====
  
-//Player status: Supported //✅//; Inaccuracies: Store Result is not set to 0 when failing, see [[https://github.com/EasyRPG/Player/issues/3056|EasyRPG Player issue #3056]], lack of file output limit//+//Player status: Supported// ✅//; Inaccuracies: Store Result is not set to 0 when failing, see [[https://github.com/EasyRPG/Player/issues/3056|EasyRPG Player issue #3056]], lack of file output limit//
  
 The Save command (セーブの実行) allows to directly save on a requested save slot without using the save menu. The Save command (セーブの実行) allows to directly save on a requested save slot without using the save menu.
Line 85: Line 85:
 ===== Load ===== ===== Load =====
  
-//Player status: Supported //✅//; Inaccuracies: No transition to black is ever displayed, empty and corrupted save files cannot be loaded at all//+//Player status: Supported// ✅//; Inaccuracies: No transition to black is ever displayed, empty and corrupted save files cannot be loaded at all//
  
 The Load command (ロードの実行) allows to directly load a requested save slot without using the load menu. The Load command (ロードの実行) allows to directly load a requested save slot without using the load menu.
Line 92: Line 92:
   * Save Index: Save slot ID that will be used for the save file. The ID to use can either be a constant or the value of a variable. The range of valid save slots is [1;2147483647], attempting to load a save file with a null or negative ID will fail.   * Save Index: Save slot ID that will be used for the save file. The ID to use can either be a constant or the value of a variable. The range of valid save slots is [1;2147483647], attempting to load a save file with a null or negative ID will fail.
   * Disable file check: If this option is ticked, attempting to load an empty save file will give the same result than when trying to load a corrupted save file instead of failing.   * Disable file check: If this option is ticked, attempting to load an empty save file will give the same result than when trying to load a corrupted save file instead of failing.
-  * Disable blackout: If this option is ticked, the screen will not turn black when a save file is loaded. ⚠️// This option is not directly accessible through the Maniac editor, and requires using TPC, raw writing or another tool.//+  * Disable blackout: If this option is ticked, the screen will not turn black when a save file is loaded. ⚠️ //This option is not directly accessible through the Maniac editor, and requires using TPC, raw writing or another tool.//
  
 Notes: Notes:
Line 128: Line 128:
 ===== Get Mouse Position ===== ===== Get Mouse Position =====
  
-//Player status: Supported //✅//; Inaccuracies: Ignore Window Size Ratio not supported, tracking the mouse out of the game window not supported//+//Player status: Supported// ✅//; Inaccuracies: Ignore Window Size Ratio not supported, tracking the mouse out of the game window not supported//
  
 The Get Mouse Position command (マウス座標の取得) allows to retrieve the position of the mouse. The Get Mouse Position command (マウス座標の取得) allows to retrieve the position of the mouse.
Line 135: Line 135:
   * X Coordinate: Variable that should receive the X coordinate of the mouse.   * X Coordinate: Variable that should receive the X coordinate of the mouse.
   * Y Coordinate: Variable that should receive the Y coordinate of the mouse.   * Y Coordinate: Variable that should receive the Y coordinate of the mouse.
-  * Ignore Window Size Ratio: If ticked, the mouse coordinate retrieved will ignore the window size ratio of the game instead of retrieving a position tied to the game screen. ⚠️// This option was added in development versions of the editor, and is as such not available in public versions, in addition to lacking a common TPC writing.//+  * Ignore Window Size Ratio: If ticked, the mouse coordinate retrieved will ignore the window size ratio of the game instead of retrieving a position tied to the game screen. ⚠️ //This option was added in development versions of the editor, and is as such not available in public versions, in addition to lacking a common TPC writing.//
  
 Notes: Notes:
Line 154: Line 154:
 ===== Set Mouse Position ===== ===== Set Mouse Position =====
  
-//Player status: Not supported with no plan to be supported //❌//; System specific, not exposed by SDL//+//Player status: Not supported with no plan to be supported// ❌//; System specific, not exposed by SDL//
  
 The Set Mouse Position command (マウス座標の設定) allows to change the position of the mouse. The Set Mouse Position command (マウス座標の設定) allows to change the position of the mouse.
Line 161: Line 161:
   * X Coordinate: X coordinate of the mouse to use.   * X Coordinate: X coordinate of the mouse to use.
   * Y Coordinate: Y coordinate of the mouse to use.   * Y Coordinate: Y coordinate of the mouse to use.
-  * Ignore Window Size Ratio: If ticked, the mouse coordinate position will be calculated by ignoring the window size ratio of the game. ⚠️// This option was added in development versions of the editor, and is as such not available in public versions, in addition to lacking a common TPC writing.//+  * Ignore Window Size Ratio: If ticked, the mouse coordinate position will be calculated by ignoring the window size ratio of the game. ⚠️ //This option was added in development versions of the editor, and is as such not available in public versions, in addition to lacking a common TPC writing.//
  
 The coordinates to use can be set to either constants or value of variables, with the setting for it being shared for the two coordinates. The coordinates to use can be set to either constants or value of variables, with the setting for it being shared for the two coordinates.
Line 221: Line 221:
 ===== Control Shared Save ===== ===== Control Shared Save =====
  
-FIXME+//Player status: Supported// ✅//; Global save status is set to be opened on boot if it exists, no file output limit.// 
 + 
 +The Control Shared Save command (共有セーブの操作, known as Control Global Save in previous versions) allows to save switches and variables in a file named ''Save.lgs'', that will be able to be read and written while playing from any save file. 
 + 
 +When using the command, there are two different global save locations that need to be distinguished: 
 +  * The **global save**, which consists of the area where the data is temporarily written in memory and altered by the various functions of the command. 
 +  * The ''Save.lgs'' file, which is the actual file written in the game folder that can be read and written on. It will always be referred as ''Save.lgs'' in the documentation of this command to avoid confusion with the global save. 
 + 
 +Additionally, the global save can have two statuses, opened and closed: 
 +  * If set to opened, and that the game is closed either by the user or by using the Exit Game command, the content of the global save will be copied to the ''Save.lgs'' file. 
 +    * The ''Save.lgs'' file will not be updated if the game is forcefully closed by e.g. the Task Manager, or if a major game crash occurs (simple error messages from the engine properly write data). 
 +  * If set to closed, exiting the game will not alter the ''Save.lgs'' file. 
 + 
 +Notes: 
 +  * The file ''Save.lgs'' is stored at the root of the game folder. 
 +  * Upon game boot or game reset, the content of the ''Save.lgs'' file is copied to the global save, and the global save status is set to closed. 
 +  * The output ''Save.lgs'' file is subject to the file output limit of the patch (not more than ~3 file writing per second): if the file output limit is reached, the [[modified-maniac-commands#file-output-is-available|Conditional Branch: File output is available]] will be reported as false until it becomes possible again to write files. 
 + 
 +==== Open ==== 
 + 
 +By using **Open**, the global save status will be set to opened. 
 + 
 +Common TPC syntax: <code>@gsave.open</code> 
 + 
 +Raw writing: <code>3016, "", 0</code> 
 + 
 +==== Close ==== 
 + 
 +By using **Close**, the content of the ''Save.lgs'' file will be copied to the global save, and the global save status will be set to closed. 
 + 
 +Common TPC syntax: <code>@gsave.close</code> 
 + 
 +Raw writing: <code>3016, "", 1</code> 
 + 
 +==== Save ==== 
 + 
 +By using **Save**, the content of the global save will be written on the ''Save.lgs'' file. 
 + 
 +Notes: 
 +  * The opened/closed status of the global save does not matter for saving. 
 + 
 +Common TPC syntax: <code>@gsave.save</code> 
 + 
 +Raw writing: <code>3016, "", 2</code> 
 + 
 +==== Save then Close ==== 
 + 
 +By using **Save then Close**, the content of the global save will be written on the ''Save.lgs'' file, and the global save status will be set to closed. 
 + 
 +Notes: 
 +  * The opened/closed status of the global save does not matter for saving. 
 + 
 +Common TPC syntax: <code>@gsave.saveAndClose</code> 
 + 
 +Raw writing: <code>3016, "", 3</code> 
 + 
 +==== Copy from Global Save ==== 
 + 
 +**Copy from Global Save** allows to copy values from the global save to switches and variables. 
 + 
 +The command has the following fields: 
 +  * Type: Whether switches or variables should be copied. 
 +  * Current Save Data: Position of the first switch or variable ID should receive the values from the global save, with the possility to use a constant or variable for the ID. 
 +  * Global Save Data: Position of the first switch or variable in the global save that should be copied, with the possility to use a constant or variable for the ID. 
 +  * Size: How many values should be copied, with the possibility to use a constant, variable or variable redirection. 
 + 
 +Notes: 
 +  * Switches and variables do not share their slot allocations, so you can use the same slot numbers without conflict. 
 +  * Using the command will set the global save status to opened. 
 +  * Using a null or negative size will not copy any value. 
 + 
 +Common TPC syntax for switches: <code>gs[2].copyTo s[1], 3</code> 
 +Common TPC syntax for variables: <code>gv[2].copyTo v[1], 3</code> 
 + 
 +Where: 
 +  * ''1'' corresponds to the position of the wanted value in the game data, with the possibility to use a constant or variable. 
 +  * ''2'' corresponds to the position of the wanted value in the global save, with the possibility to use a constant or variable. 
 +  * ''3'' corresponds to the size of the array, with the possibility to use a constant, variable or variable redirection. 
 + 
 +Raw writing: <code>3016, "", 4, b, c, d, e, f</code> 
 +  * ''3016'': Command code 
 +  * ''b'': Defines if the values to use are constants, variables or variable redirections: 
 +    * ''+1'' if the current game data position to use should be a variable. 
 +    * ''+16'' if the global save position to use should be a variable. 
 +    * ''+256'' if the size to use should be a variable. 
 +    * ''+512'' if the size to use should be a variable redirection. 
 +  * ''c'': Whether the type to use should be switches (0) or variables (1). 
 +  * ''d'': Value to use for the current game data position. 
 +  * ''e'': Value to use for the global save position. 
 +  * ''f'': Value to use for the size. 
 + 
 +==== Copy to Global Save ==== 
 + 
 +**Copy to Global Save** allows to copy switches and variables to the global save. 
 + 
 +The command has the following fields: 
 +  * Type: Whether switches or variables should be copied. 
 +  * Current Save Data: Position of the first switch or variable ID that should be copied to the global save, with the possility to use a constant or variable for the ID. 
 +  * Global Save Data: Position of the first switch or variable in the global save that should be written to, with the possility to use a constant or variable for the ID. 
 +  * Size: How many values should be copied, with the possibility to use a constant, variable or variable redirection. 
 + 
 +Notes: 
 +  * Switches and variables do not share their slot allocations, so you can use the same slot numbers without conflict. 
 +  * Using the command will set the global save status to opened. 
 +  * Using a null or negative size will not copy any value. 
 + 
 +Common TPC syntax for switches: <code>gs[2].copyFrom s[1], 3</code> 
 +Common TPC syntax for variables: <code>gv[2].copyFrom v[1], 3</code> 
 + 
 +Where: 
 +  * ''1'' corresponds to the position of the wanted value in the game data, with the possibility to use a constant or variable. 
 +  * ''2'' corresponds to the position of the wanted value in the global save, with the possibility to use a constant or variable. 
 +  * ''3'' corresponds to the size of the array, with the possibility to use a constant, variable or variable redirection. 
 + 
 +Raw writing: <code>3016, "", 5, b, c, d, e, f</code> 
 +  * ''3016'': Command code 
 +  * ''b'': Defines if the values to use are constants, variables or variable redirections: 
 +    * ''+1'' if the current game data position to use should be a variable. 
 +    * ''+16'' if the global save position to use should be a variable. 
 +    * ''+256'' if the size to use should be a variable. 
 +    * ''+512'' if the size to use should be a variable redirection. 
 +  * ''c'': Whether the type to use should be switches (0) or variables (1). 
 +  * ''d'': Value to use for the current game data position. 
 +  * ''e'': Value to use for the global save position. 
 +  * ''f'': Value to use for the size.
  
 ===== Set Picture ID ===== ===== Set Picture ID =====
Line 235: Line 359:
 ==== Behavior when Inactive ==== ==== Behavior when Inactive ====
  
-//Player status: Supported //✅//; This option is linked to the EasyRPG Player setting Pause when focus lost, and as such does not use the value set in a save file.//+//Player status: Supported// ✅//; This option is linked to the EasyRPG Player setting Pause when focus lost, and as such does not use the value set in a save file.//
  
 **Behavior when Inactive** defines if the window of the game should be put on hold (Wait) if put in the background or if it should stay active (Run). This info is stored in the save file, and the default mode is Wait. **Behavior when Inactive** defines if the window of the game should be put on hold (Wait) if put in the background or if it should stay active (Run). This info is stored in the save file, and the default mode is Wait.
Line 249: Line 373:
 ==== Fatal Mix ==== ==== Fatal Mix ====
  
-//Player status: Supported //✅//; The FPS range is capped on the [10;500] range; FPS and Right Shift key are not kept if a save file is loaded or if the game is reset.//+//Player status: Supported// ✅//; The FPS range is capped on the [10;500] range; FPS and Right Shift key are not kept if a save file is loaded or if the game is reset.//
  
 **Fatal Mix** allows to change the speed of the game, change the TestPlay mode and adjust the behaviour of the Right Shift key. **Fatal Mix** allows to change the speed of the game, change the TestPlay mode and adjust the behaviour of the Right Shift key.
Line 282: Line 406:
 ==== Maximum Number of Pictures ==== ==== Maximum Number of Pictures ====
  
-//Player status: Unsupported //❌//; The Player dynamically handles picture limits so it does not need it as much as Maniac does for optimisation.//+//Player status: Unsupported// ❌//; The Player dynamically handles picture limits so it does not need it as much as Maniac does for optimisation.//
  
 **Maximum Number of Pictures** defines the maximum picture ID that can be used, with the default value being 1000. **Maximum Number of Pictures** defines the maximum picture ID that can be used, with the default value being 1000.
Line 329: Line 453:
 ==== Mouse Text Window Operation ==== ==== Mouse Text Window Operation ====
  
-//Player status: Partially supported //ℹ️//; The right mouse button is not mapped, and the left mouse button behaves like a regular interaction key for text boxes//+//Player status: Partially supported// ℹ️//; The right mouse button is not mapped, and the left mouse button behaves like a regular interaction key for text boxes//
  
-⚠️// This option is not directly accessible through the Maniac editor, and requires using TPC, raw writing or another tool.//+⚠️ //This option is not directly accessible through the Maniac editor, and requires using TPC, raw writing or another tool.//
  
 If **Mouse Text Window Operation** is enabled, the mouse will be able to be used in text boxes. If **Mouse Text Window Operation** is enabled, the mouse will be able to be used in text boxes.
Line 350: Line 474:
 //Player status: Unsupported// ❌ //Player status: Unsupported// ❌
  
-⚠️// This option is not directly accessible through the Maniac editor, and requires using TPC, raw writing or another tool.//+⚠️ //This option is not directly accessible through the Maniac editor, and requires using TPC, raw writing or another tool.//
  
 **Position of Battle Screen** defines where the interface should be displayed on the screen during battles. **Position of Battle Screen** defines where the interface should be displayed on the screen during battles.
Line 388: Line 512:
 //Player status: Unsupported// ❌ //Player status: Unsupported// ❌
  
-⚠️// This option is not directly accessible through the Maniac editor, and requires using TPC, raw writing or another tool.//+⚠️ //This option is not directly accessible through the Maniac editor, and requires using TPC, raw writing or another tool.//
  
 **Maximum Number of Animations** defines the maximum animation ID that can be used. **Maximum Number of Animations** defines the maximum animation ID that can be used.
Line 405: Line 529:
 //Player status: Unsupported// ❌ //Player status: Unsupported// ❌
  
-⚠️// This option is not directly accessible through the Maniac editor, and requires using TPC, raw writing or another tool.//+⚠️ //This option is not directly accessible through the Maniac editor, and requires using TPC, raw writing or another tool.//
  
 **Face Size** defines which size should be used for FaceSets displayed in message boxes. **Face Size** defines which size should be used for FaceSets displayed in message boxes.
Line 438: Line 562:
 ===== Control String Variables ===== ===== Control String Variables =====
  
-⚠️// This command is not directly accessible through the Maniac editor, and requires using the community plugin, TPC, raw writing or another tool.//+⚠️ //This command is not directly accessible through the Maniac editor, and requires using the community plugin, TPC, raw writing or another tool.//
  
 FIXME FIXME
Line 466: Line 590:
 ==== Tile IDs ==== ==== Tile IDs ====
  
-⚠️// While this command is accessible through the Maniac editor and can be written, assigning a value to be a variable or variable redirection is incorrectly done and incorrectly displayed in the list. Use TPC, raw writing or another tool to properly write the command.//+⚠️ //While this command is accessible through the Maniac editor and can be written, assigning a value to be a variable or variable redirection is incorrectly done and incorrectly displayed in the list. Use TPC, raw writing or another tool to properly write the command.//
  
 //Player status: Supported// ✅ //Player status: Supported// ✅
Line 529: Line 653:
 ==== Game Screen Pixels ==== ==== Game Screen Pixels ====
  
-⚠️// While this command is accessible through the Maniac editor and can be written, assigning a value to be a variable or variable redirection is incorrectly done and incorrectly displayed in the list. Use TPC, raw writing or another tool to properly write the command.//+⚠️ //While this command is accessible through the Maniac editor and can be written, assigning a value to be a variable or variable redirection is incorrectly done and incorrectly displayed in the list. Use TPC, raw writing or another tool to properly write the command.//
  
-//Player status: Supported //✅//; Colours retrieved can be slightly off due to the different rendering.//+//Player status: Supported// ✅//; Colours retrieved can be slightly off due to the different rendering.//
  
 **Game Screen Pixels** allows to retrieve the colour of pixels displayed on the screen. **Game Screen Pixels** allows to retrieve the colour of pixels displayed on the screen.
Line 578: Line 702:
 ==== Command Interpreter State ==== ==== Command Interpreter State ====
  
-//Player status: Partially supported //ℹ️//; Battle events do not have all their values retrieved correctly yet, battle common event types are not supported, type of execution for Player Touch and Event Touch can be inaccurate, see [[https://github.com/EasyRPG/Player/issues/3689|EasyRPG Player issue #3689]]//+//Player status: Partially supported// ℹ️//; Battle events do not have all their values retrieved correctly yet, battle common event types are not supported, type of execution for Player Touch and Event Touch can be inaccurate, see [[https://github.com/EasyRPG/Player/issues/3689|EasyRPG Player issue #3689]]//
  
 **Command Interpreter State** allows to retrieve the position in the code where the command was used. **Command Interpreter State** allows to retrieve the position in the code where the command was used.
Line 623: Line 747:
 ==== Actor Face Graphic ==== ==== Actor Face Graphic ====
  
-//Player status: Supported //✅//; The empty message box index quirk is not supported.//+//Player status: Supported// ✅//; The empty message box index quirk is not supported.//
  
 ''Actor Face Graphic'' allows to retrieve the FaceSet of a hero or of the message box. ''Actor Face Graphic'' allows to retrieve the FaceSet of a hero or of the message box.
Line 658: Line 782:
 ==== Actor Body Graphic ==== ==== Actor Body Graphic ====
  
-//Player status: Supported //✅//; Requesting the dynamic sprite of a vehicle also receives sprites set through the Set Move Route command.//+//Player status: Supported// ✅//; Requesting the dynamic sprite of a vehicle also receives sprites set through the Set Move Route command.//
  
 **Actor Body Graphic** allows to retrieve the CharSet of a hero or of an event. **Actor Body Graphic** allows to retrieve the CharSet of a hero or of an event.
Line 694: Line 818:
 ==== Camera Position ==== ==== Camera Position ====
  
-//Player status: Supported //✅//; Coordinates on looping maps for the edges are incorrectly reported, see [[https://github.com/EasyRPG/Player/issues/3665|EasyRPG Player issue #3665]]//+//Player status: Supported// ✅//; Coordinates on looping maps for the edges are incorrectly reported, see [[https://github.com/EasyRPG/Player/issues/3665|EasyRPG Player issue #3665]]//
  
 **Camera Position** allows to retrieve the position of the camera. The position of the camera retrieved corresponds to the top-left corner pixel of the screen compared to the map placement. **Camera Position** allows to retrieve the position of the camera. The position of the camera retrieved corresponds to the top-left corner pixel of the screen compared to the map placement.
Line 713: Line 837:
 ==== Screen Shake Value ==== ==== Screen Shake Value ====
  
-//Player status: Supported //✅+//Player status: Supported// ✅
  
 **Screen Shake Value** allows to retrieve by how many pixels the screen was shifted on the left by the Shake Screen command. **Screen Shake Value** allows to retrieve by how many pixels the screen was shifted on the left by the Shake Screen command.
Line 727: Line 851:
 ==== Current BGM ==== ==== Current BGM ====
  
-//Player status: Supported //✅+//Player status: Supported// ✅
  
 **Current BGM** allows to retrieve the infos of the current music. **Current BGM** allows to retrieve the infos of the current music.
Line 755: Line 879:
 ===== Output Image ===== ===== Output Image =====
  
-//Player status: Supported //✅//; Appending the .png in the filename does not add it as part of the filename, outputting with an invalid character displays a warning, Show Picture loads the new file when used so no overwriting shenanigan, file output limit not supported/detected; See other sections for individual compatibility.// +//Player status: Supported// ✅//; Appending the .png in the filename does not add it as part of the filename, outputting with an invalid character displays a warning, Show Picture loads the new file when used so no overwriting shenanigan, file output limit not supported/detected; See other sections for individual compatibility.// 
  
 The Output Image command (画像の出力) allows to output a screenshot of the game or a displayed picture and write it in the folder of the game. The Output Image command (画像の出力) allows to output a screenshot of the game or a displayed picture and write it in the folder of the game.
Line 772: Line 896:
 ==== Game Screen ==== ==== Game Screen ====
  
-//Player status: Supported //✅//; The first colour in the index is not set to a transparent colour// +//Player status: Supported// ✅//; The first colour in the index is not set to a transparent colour// 
  
 By specifying **Game Screen**, a screenshot of the game will be taken and be output in the requested location. By specifying **Game Screen**, a screenshot of the game will be taken and be output in the requested location.
Line 791: Line 915:
 ==== Picture ==== ==== Picture ====
  
-//Player status: Supported //✅//; Outputting a picture that does not exist writes a 1x1 black pixel// +//Player status: Supported// ✅//; Outputting a picture that does not exist writes a 1x1 black pixel// 
  
 By specifying **Picture**, a copy of the picture in the selected picture ID will be output in the requested location. By specifying **Picture**, a copy of the picture in the selected picture ID will be output in the requested location.
Line 846: Line 970:
 //Player status: Unsupported// ❌ //Player status: Unsupported// ❌
  
-FIXME+The Script command (スクリプト) allows to execute JavaScript code. 
 + 
 +The Maniac Patch executable comes bundled with [[https://bellard.org/quickjs/|QuickJS Javascript Engine]] to be able to execute JavaScript code, and as such follows its [[https://bellard.org/quickjs/quickjs.pdf|syntax and features]]. Note that the os and std functions are not present in the Maniac Patch implementation of QuickJS, due to their potential dangerous use. 
 + 
 +Additionally, the following JavaScript commands can be used to alter switches, variables and string variables: 
 +  * <code>s[123] = 1</code> to alter the status of a switch (here, 123), with 0 to set it OFF and 1 to set it ON. The switch ID can be replaced by a variable (''s[v[123]]''). 
 +  * <code>v[123] = 456</code> to change the value of a variable (here, 123 being set to 456). The variable ID can be replaced by a variable (''v[v[123]]''). 
 +  * <code>t[123] = 'hello'</code> to change the text of a string variable (here, 123 being set to hello). The string variable ID can be replaced by a variable (''t[v[123]]''). 
 + 
 +The command has the following fields: 
 +  * Source Text: Code to execute, with the possibility to have it come from the command, from a string variable or from a string variable redirection. 
 +  * Variable that receive return value: Switches, switch redirections, variables, variable redirections, string variables and/or string variable redirections that should receive output values from the executed code, with as many output values as wanted. For instance, if you only execute the code ''[1, "a", 2]'' and that you set the output to be switch 10, string variable 20 and variable 30, the switch 10 will receive the value ON, the string variable 20 the value a and the variable 30 the value 2. 
 + 
 +FIXME //Provide more examples and info on using JavaScript and making it communicate with the engine.// 
 + 
 +Notes: 
 +  * If a command with an incorrect syntax is executed, the console will be opened and will display an error highlighting the syntax issue. This does not halt the game. 
 + 
 +Internally, the command comes with two different command codes, ''3030'' and ''3031'', with ''3030'' used for the first line of a script and ''3031'' used for the next lines of a same script. This is similar to the Show Text and Comment commands, where their first line and their other lines use different command codes. Using ''3031'' commands without starting with a ''3030'' command first will not do anything. 
 + 
 +TPC only offers editing the first command code: the second command code is impossible to edit through the Maniac Patch or TPC, and can only be deleted. 
 + 
 +TPC syntax of the first command code: <code>@js [s[1], s[v[2]], v[3], v[v[4]], t[5], t[v[[6]]] .run "code"</code> 
 + 
 +Where: 
 +  * ''code'' corresponds to the JS code to execute, with the possibility to replace it by a string variable or string variable redirection. 
 +  * <code>''[s[1], s[v[2]], v[3], v[v[4]], t[5], t[v[[6]]]</code> corresponds to the variables that should receive any output values. It is possible to set none by removing the brackets entirely. 
 + 
 +Raw writing for the command code 3030: <code>3030, "code", a, b, 0, 0, e, f, g</code> 
 +  * ''code'': If the code is set to come from the command, code to execute. 
 +  * ''a'': Whether the code to use should come directly from the command (0), from a string variable (1) or from a redirection of string variable (2). 
 +  * ''b'': If the code does not come from the command, value to use for the code. 
 +  * ''e'': How many values should be set as outputs. 
 +  * ''f'': Type of the selected output: 
 +    * ''0'': Switch 
 +    * ''1'': Switch redirection 
 +    * ''2'': Variable 
 +    * ''3'': Variable redirection 
 +    * ''4'': String variable 
 +    * ''5'': String variable redirection 
 +  * ''g'': Value to use for the selected output. 
 + 
 +The values ''f'' and ''g'' are repeated up until the number of selected outputs. 
 + 
 +Raw writing for the command code 3031: <code>3031, "code"</code> 
 +  * ''3031'': Command code 
 +  * ''code'': JavaScript code to execute.
  
 ===== Zoom Screen ===== ===== Zoom Screen =====
  
-//Player status: Not yet supported ❌; A work-in-progress pull request to implement the command exists: [[https://github.com/EasyRPG/Player/pull/3499|EasyRPG Player pull request #3499]]//+//Player status: Not yet supported// ❌//; A work-in-progress pull request to implement the command exists: [[https://github.com/EasyRPG/Player/pull/3499|EasyRPG Player pull request #3499]]//
  
 The Zoom Screen command (画面のズーム) allows to zoom in on the screen while in the overworld. The Zoom Screen command (画面のズーム) allows to zoom in on the screen while in the overworld.
Line 878: Line 1048:
   * Setting the Scale to a value above 24000 will not do any zoom.   * Setting the Scale to a value above 24000 will not do any zoom.
   * If the layer is set to a value not on the [1;10] range, no zoom will occur.   * If the layer is set to a value not on the [1;10] range, no zoom will occur.
 +  * The zoom only affects the overworld, it does not affect battles and menus.
   * The zoom properties are kept in the save file.   * The zoom properties are kept in the save file.
  
Line 1066: Line 1237:
 ===== Control Self Variable ===== ===== Control Self Variable =====
  
-⚠️// This command was added in development versions of the editor, and is as such not available in public versions, in addition to lacking a common TPC writing.//+⚠️ //This command was added in development versions of the editor, and is as such not available in public versions, in addition to lacking a common TPC writing.//
  
 //Player status: Unsupported// ❌ //Player status: Unsupported// ❌
Line 1074: Line 1245:
 ===== Change Troop Member ===== ===== Change Troop Member =====
  
-⚠️// This command was added in development versions of the editor, and is as such not available in public versions, in addition to lacking a common TPC writing.//+⚠️ //This command was added in development versions of the editor, and is as such not available in public versions, in addition to lacking a common TPC writing.//
  
 FIXME FIXME
Line 1080: Line 1251:
 ===== Control Media Option ===== ===== Control Media Option =====
  
-⚠️// This command was added in development versions of the editor, and is as such not available in public versions, in addition to lacking a common TPC writing.//+⚠️ //This command was added in development versions of the editor, and is as such not available in public versions, in addition to lacking a common TPC writing.//
  
 //Player status: Unsupported// ❌ //Player status: Unsupported// ❌
Line 1095: Line 1266:
     * Window - Use interpolation: In window mode, whether interpolation should not be used (0) or if it should be used (1).     * Window - Use interpolation: In window mode, whether interpolation should not be used (0) or if it should be used (1).
     * Window - Keep size within display: In window mode, whether the size of the window should not be kept within display (0) or if should be kept within display (1).     * Window - Keep size within display: In window mode, whether the size of the window should not be kept within display (0) or if should be kept within display (1).
-    * Fullscreen - Allow uneven pixel size: In fullscreen mode, whether having an uneven pixel size should be disallowed (0) or allowed (1). ⚠️// The option that needs to be set in the Maniac editor to assign this parameter is Fullscreen - Ignore aspect ratio for stretching, not Fullscreen - Allow uneven pixel size.// +    * Fullscreen - Allow uneven pixel size: In fullscreen mode, whether having an uneven pixel size should be disallowed (0) or allowed (1). ⚠️ //The option that needs to be set in the Maniac editor to assign this parameter is Fullscreen - Ignore aspect ratio for stretching, not Fullscreen - Allow uneven pixel size.// 
-    * Fullscreen - Ignore aspect ratio for stretching: In fullscreen mode, whether the aspect ratio for stretching should not be ignored (0) or if it should be ignored (1). ⚠️// The option that needs to be set in the Maniac editor to assign this parameter is Fullscreen - Use interpolation, not Fullscreen - Ignore aspect ratio for stretching.// +    * Fullscreen - Ignore aspect ratio for stretching: In fullscreen mode, whether the aspect ratio for stretching should not be ignored (0) or if it should be ignored (1). ⚠️ //The option that needs to be set in the Maniac editor to assign this parameter is Fullscreen - Use interpolation, not Fullscreen - Ignore aspect ratio for stretching.// 
-    * Fullscreen - Use interpolation: In fullscreen mode, whether interpolation should not be used (0) or if it should be used (1). ⚠️// The option that needs to be set in the Maniac editor to assign this parameter is Fullscreen - Allow uneven pixel size, not Fullscreen - Use interpolation.//+    * Fullscreen - Use interpolation: In fullscreen mode, whether interpolation should not be used (0) or if it should be used (1). ⚠️ //The option that needs to be set in the Maniac editor to assign this parameter is Fullscreen - Allow uneven pixel size, not Fullscreen - Use interpolation.//
     * Audio - Volume: Volume of the engine. The range of value accepted is [0;100].     * Audio - Volume: Volume of the engine. The range of value accepted is [0;100].
     * Show FPS: Whether FPS should not be shown (0) or if they should be shown (1).     * Show FPS: Whether FPS should not be shown (0) or if they should be shown (1).
development/technical-details/patches/maniac/new-maniac-commands.1791553720.txt.gz · Last modified: by carbonara