Release 3.14.0

Documentation

Author: cardillan

CHANGELOG.markdown

@@ -7,7 +7,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 ## 3.14.0 – Unreleased
 
 > [!NOTE]
-> [Atomic code execution](doc/syntax/REMOTE-CALLS.markdown#atomic-code-execution) are only guaranteed to execute correctly in the latest BE version (build 26658 or higher). The latest beta release (v154.3) doesn't provide necessary support for atomic code execution.
+> [Atomic code execution](doc/syntax/REMOTE-CALLS.markdown#atomic-code-execution) are only guaranteed to execute correctly in the latest BE version (build 26658 or later). The latest beta release (v154.3) doesn't provide necessary support for atomic code execution.
 
 > [!NOTE]
 > The new [Mlog Watcher functionality](doc/syntax/TOOLS-MLOG-WATCHER.markdown) available with the tool app requires a new version of the Mlog Watcher mod. The new version has not yet been released, but a Mindustry 8-compatible build is available [here](https://github.com/Sharlottes/MlogWatcher/actions/runs/21562595822). To use that version, the `--watcher-version v1` command line argument must be specified.   
@@ -26,7 +26,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 * Added support for nested atomic sections and atomic function calls from an atomic section. The entire topmost atomic section is executed atomically.
 * Added support [atomic section merging](doc/syntax/REMOTE-CALLS.markdown#atomic-section-merging). The duration limit of a merged section can be specified using the [`atomic-merge-level` compiler option](/doc/syntax/SYNTAX-5-OTHER.markdown#option-atomic-merge-level) (one tick by default).
 * Added a [`atomic-safety-margin` compiler option](/doc/syntax/SYNTAX-5-OTHER.markdown#option-atomic-safety-margin). No safety margin is necessary with the latest Mindustry BE build, though.
-* Added support for the new version of [Mlog Watcher mod](/doc/syntax/TOOLS-MLOG-WATCHER.markdown) in the tool app. To use the new Mlog Watcher mod, the  `--watcher-version v1` command-line argument needs to be specified.
+* Added new tool app functionalities:
+  * Support for the new version of [Mlog Watcher mod](/doc/syntax/TOOLS-MLOG-WATCHER.markdown), providing several useful new ways to send or extract mlog code and schematics to/from a running game. To use the new Mlog Watcher mod, the `--watcher-version v1` command-line argument needs to be specified.
+  * Ability to execute mlog code loaded from a file on the processor emulator and for sending it to the Mlog Watcher. Use the new `pm` or `process-mlog` command-line argument.  
+  * Ability to execute schematics loaded from a file on the processor emulator and for sending it to the new version of the Mlog Watcher. Use the new `ps` or `process-schematic` command-line argument.
 * Added a validation step to the compiler to verify the generated code doesn't exceed the maximum number of instructions. The [`enforce-instruction-limit` compiler option](/doc/syntax/SYNTAX-5-OTHER.markdown#option-enforce-instruction-limit) can be used to control this behavior.
 
 ### Changed
@@ -1080,7 +1083,7 @@ Experimental features may contain bugs, break existing code or produce suboptima
 * Added support for multiple loop variables in [list iteration loops](doc/syntax/SYNTAX-3-STATEMENTS.markdown#list-iteration-loops). Each iteration processes as many elements from the list as there are loop variables.
 * Added an `out` keyword to be used with loop control variables in list iteration loop, allowing [list elements to be modified](doc/syntax/SYNTAX-3-STATEMENTS.markdown#modifications-of-variables-in-the-list).
 * Added a new GUI option to choose an optimization level in the web app when compiling Mindcode or building Schemacode.
-* Added a capability to run the compiled code on an emulated processor, by using a `Compile and Run` button in the web app, or the [`--run` command line option](doc/syntax/TOOLS-CMDLINE.markdown#running-the-compiled-code). The output is shown in a separate control in the web app or written to the log when using the command line tool.
+* Added a capability to run the compiled code on an emulated processor, by using a `Compile and Run` button in the web app, or the [`--run` command line option](doc/syntax/TOOLS-CMDLINE.markdown#running-mlog-code-or-schematics). The output is shown in a separate control in the web app or written to the log when using the command line tool.
 * Added a capability to the command line tool to compile several source files at once using the [`--append` command line argument](doc/syntax/TOOLS-CMDLINE.markdown#additional-input-files).
 * Added new optimization level, `experimental`. When using this setting, the [Data Flow optimizer](doc/syntax/optimizations/DATA-FLOW-OPTIMIZATION.markdown) doesn't assume the assignments to global variables might be changed by editing the compiled code, allowing performing more optimizations on them. Program parameters must be used instead of global variables for program parametrization if this optimization level is used.
 * Added [formattable string literals](doc/syntax/SYNTAX.markdown#formattable-string-literals), which allow formatting outputs of the `print` and `println` functions the same way as `printf` does.
@@ -1634,7 +1637,7 @@ Note: the bug fixed in this release only affects the command line tool. The web
   and in the command line tool, so the change doesn't break existing code.
 * Added support for the reintroduced `ucontrol pathfind` instruction. When issued, navigates the current unit to a given
   location using AI to avoid obstacles. See [`ucontrol`](doc/syntax/FUNCTIONS-71.markdown#instruction-unit-control).
-* Added command line options for [Schematic Decompiler](doc/syntax/TOOLS-CMDLINE.markdown#decompile-schematic-action-help)
+* Added command line options for [Schematic Decompiler](doc/syntax/TOOLS-CMDLINE.markdown#process-schematic-action-help)
   to specify order in which blocks are written to the schematic definition file and when to generate the `facing`
   directive.
 * Added support for [color configuration](doc/syntax/SCHEMACODE.markdown#color-configuration) and

README.markdown

@@ -30,7 +30,7 @@ Mindcode can generate code for several Mindustry versions. The target can be sel
 At this moment, target `8` (or `8.1`) is also fully compatible with the latest Mindustry versions (154.3 Beta or BE build 26613).
 
 > [!NOTE]
-> The [atomic code blocks](doc/syntax/REMOTE-CALLS.markdown#atomic-code-execution) are only guaranteed to execute correctly in the latest BE version (build 26609 or higher). The latest beta release (v154.3) doesn't provide necessary support for atomic code blocks. 
+> The [atomic code blocks](doc/syntax/REMOTE-CALLS.markdown#atomic-code-execution) are only guaranteed to execute correctly in the latest BE version (build 26658 or later). The latest beta release (v154.3) doesn't provide necessary support for atomic code blocks. 
 
 [Here](/doc/syntax/MINDUSTRY-8.markdown#new-functionality-in-mindustry-8) is a summary of the new Logic content and corresponding Mindcode functionality in Mindustry 8.
 
@@ -54,7 +54,7 @@ The most important recent changes to Mindcode include:
 
 * Mindustry Logic 8
   * Complete support for [the latest Mindustry 8 pre-release](/doc/syntax/MINDUSTRY-8.markdown).
-  * [Atomic code blocks](doc/syntax/REMOTE-CALLS.markdown#atomic-code-execution) guaranteed to be executed atomically – without interruption.
+  * [Atomic code sections](doc/syntax/REMOTE-CALLS.markdown#atomic-code-execution) guaranteed to be executed atomically – without interruption.
   * Full support for [remote functions and variables](doc/syntax/REMOTE-CALLS.markdown).
   * [Array implementations](/doc/syntax/optimizations/ARRAY-OPTIMIZATION.markdown) using the Mindustry 8 Logic capabilities. 
   * New string/character-based instructions and character literals.
@@ -98,7 +98,7 @@ The [Mlog Assertions mod](https://github.com/cardillan/MlogAssertions), availabl
 
 To learn more about Mindustry Logic, you can find more information about it here:
 
-* Yruei's [Mlog Documentation](https://yrueii.github.io/MlogDocs/) (last updated December 2025)
+* Yruei's [Mlog Documentation](https://yrueii.github.io/MlogDocs/) (last updated January 2026)
 
 You can also get help on these Discord servers:
 

doc/syntax/TOOLS-CMDLINE.markdown

@@ -10,9 +10,9 @@ After building the project, an executable jar file is created at `compiler\targe
 The command line tool supports three different actions. The action is specified by the first command line argument, which must be one of the following:
 
 * `cm` or `compile-mindcode`: compiles a Mindcode source to mlog.
-* `dm` or `decompile-mlog`: partially decompiles an mlog code into Mindcode. The resulting code needs to be manually edited to create loops and conditions present in the original mlog.
+* `pm` or `process-mlog`: loads mlog code from a file or an in-game processor for further processing (partially decompiling into a Mindcode source, running on the internal emulator or sending to an in-game processor). In the case of decompilation, the resulting code needs to be manually edited to create loops and conditions present in the original mlog.
 * `cs` or `compile-schematic`: builds a schematic from a Schemacode source into a binary `.msch` file.
-* `ds` or `decompile-schematic`: decompiles a binary `.msch` file to a Schemacode source.
+* `ps` or `process-schematic`: loads schematic from a binary `.msch` file or the in-game Schematics Library for further processing (decompiling into a Schemacode definition file, running on the internal emulator or sending to the in-game library).
 
 Command-line arguments (e.g., `--remarks`) are case-sensitive. Values of command-line options (e.g., `none`) are generally case-insensitive. It is possible to use both `--remarks none` and `--remarks NONE`, although the lower-case specification is preferred. All multi-word command-ine options use _kebab-case_ convention. 
 
@@ -38,7 +38,7 @@ The `-l` argument can be used to specify a log file, a file which receives messa
 
 ## Mlog Watcher integration
 
-The command-line tool can send the compiled code directly into a processor in a running Mindustry game through the Mlog Watcher mod. See [Mlog Watcher](TOOLS-MLOG-WATCHER.markdown) for details.
+The command-line tool can send the compiled code or schematic directly into a processor in a running Mindustry game through the Mlog Watcher mod. See [Mlog Watcher](TOOLS-MLOG-WATCHER.markdown) for details.
 
 ## Clipboard integration
 
@@ -47,15 +47,15 @@ When compiling Mindcode or building a schematic, the `-c` or `--clipboard` argum
 * _Compile Mindcode_ action: clipboard contains mlog instructions which can be pasted into a processor on the processor configuration screen, by using **Edit/Import from clipboard** command.
 * _Compile Schematic_ action: clipboard contains a schematic encoded into Mindustry Schematic string, which can be pasted as a new schematic on the Schematics screen, by using **Import schematic.../Import from clipboard** command. 
 
-## Running the compiled code
+## Running mlog code or schematics
 
-When performing the _Compile Mindcode_ action, it is possible to use the `--run` command line option to run the resulting mlog code on an emulated processor. The processor is much faster than Mindustry Logic processors but supports only very few operations that interact with the Mindustry World.
+It is possible to use the `--run` command line option to run mlog code or schematic on a built-in processor/schematic emulator. The processor is much faster than Mindustry Logic processors but supports only very few operations that interact with the Mindustry World.
 
 The behavior of the processor emulator can be further modified through the execution flags. For more details, refer to the [processor emulator](TOOLS-PROCESSOR-EMULATOR.markdown) documentation.
 
 ## Compiler options
 
-Compiler options, such as target Mindustry Logic version and compiler optimizations, can be specified for _Compile Mindcode_ and _Compile schema_ actions. See the command line help for more details.
+Compiler options, such as target Mindustry Logic version and compiler optimizations, can be specified for the [Compile Mindcode](#compile-mindcode-action-help) and [Compile schematic](#compile-schematic-action-help) actions. See the command line help for more details.
 
 # Command line help
 
@@ -425,7 +425,7 @@ Emulator options:
                          stop execution when a compiler-generated runtime check fails.
 ```
 
-## Decompile Mlog action help
+## Process Mlog action help
 
 ```
 usage: mindcode pm [-h] [--output-mlog [OUTPUT_MLOG]] [--output-decompiled [OUTPUT_DECOMPILED]]
@@ -870,7 +870,7 @@ Emulator options:
                          stop execution when a compiler-generated runtime check fails.
 ```
 
-## Decompile Schematic action help
+## Process Schematic action help
 
 ```
 usage: mindcode ps [-h] [--output-msch [OUTPUT_MSCH]] [--output-decompiled [OUTPUT_DECOMPILED]]

pom.xml

@@ -24,7 +24,7 @@
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <spring.version>6.2.0</spring.version>
-        <revision>3.13.0</revision>
+        <revision>3.14.0</revision>
     </properties>
 
     <dependencies>

toolapp/src/main/java/info/teksol/mindcode/cmdline/ActionHandler.java

@@ -125,7 +125,7 @@ invoke an specific Mlog Watcher operation on the compiled mlog code (default: up
                         upgrade-all      send it to processors with the same or lower version on the active map
                         force-update-all send it to processors matching program ID (regardless of the version)""";
 
-            case DECOMPILE_MLOG -> """
+            case PROCESS_MLOG -> """
                     use Mlog Watcher to obtain or send the mlog code from/to the game (default: update).
                         extract     load code from the selected processor in the game
                         update      send code loaded from a file to the selected processor""";
@@ -135,7 +135,7 @@ invoke an specific Mlog Watcher operation on the created schematic (default: upd
                         update      update the schematic with the same name in the schematics library
                         add         add a new copy of the schematic to the schematics library""";
 
-            case DECOMPILE_SCHEMA -> """
+            case PROCESS_SCHEMA -> """
                     use Mlog Watcher to obtain or send the schematic from/to the game (default: update).
                         extract     load schematic from the schematic shown on the info screen in-game
                         update      update the schematic with the same name in the schematics library

toolapp/src/main/java/info/teksol/mindcode/cmdline/ProcessMlogAction.java

@@ -36,7 +36,7 @@ public class ProcessMlogAction extends ActionHandler {
     Subparser appendSubparser(Subparsers subparsers, FileArgumentType inputFileType, CompilerProfile defaults) {
         Map<Enum<?>, CompilerOptionValue<?>> options = defaults.getOptions();
 
-        Subparser subparser = subparsers.addParser(ToolAppAction.DECOMPILE_MLOG.getShortcut())
+        Subparser subparser = subparsers.addParser(ToolAppAction.PROCESS_MLOG.getShortcut())
                 .aliases("process-mlog", "dm", "decompile-mlog")
                 .description("Load mlog code from a file or an in-game processor for further processing (partially decompiling " +
                         "into a Mindcode source, running on the internal emulator or sending to an in-game processor).")
@@ -59,7 +59,7 @@ Subparser appendSubparser(Subparsers subparsers, FileArgumentType inputFileType,
 
         addOutputDirectoryOption(files);
 
-        addMlogWatcherOptions(files, ToolAppAction.DECOMPILE_MLOG);
+        addMlogWatcherOptions(files, ToolAppAction.PROCESS_MLOG);
 
         addAllCompilerOptions(subparser, options, OptionCategory.EMULATOR);
         return subparser;

toolapp/src/main/java/info/teksol/mindcode/cmdline/ProcessSchemacodeAction.java

@@ -49,7 +49,7 @@ protected Argument createArgument(ArgumentContainer container, String optionName
     Subparser appendSubparser(Subparsers subparsers, FileArgumentType inputFileType, CompilerProfile defaults) {
         Map<Enum<?>, CompilerOptionValue<?>> options = defaults.getOptions();
 
-        Subparser subparser = subparsers.addParser(ToolAppAction.DECOMPILE_SCHEMA.getShortcut())
+        Subparser subparser = subparsers.addParser(ToolAppAction.PROCESS_SCHEMA.getShortcut())
                 .aliases("process-schematic", "ds", "decompile-schematic")
                 .description("Load schematic from a binary msch file or the in-game Schematics Library for further processing (decompiling " +
                         "into a Schemacode definition file, running on the internal emulator or sending to the in-game library)")
@@ -72,7 +72,7 @@ Subparser appendSubparser(Subparsers subparsers, FileArgumentType inputFileType,
 
         addOutputDirectoryOption(files);
 
-        addMlogWatcherOptions(files, ToolAppAction.DECOMPILE_SCHEMA);
+        addMlogWatcherOptions(files, ToolAppAction.PROCESS_SCHEMA);
 
         ArgumentGroup decompilation = subparser.addArgumentGroup("Decompilation options");
 

toolapp/src/main/java/info/teksol/mindcode/cmdline/ToolAppAction.java

@@ -8,9 +8,9 @@
 
 public enum ToolAppAction {
     COMPILE_MINDCODE("cm", new CompileMindcodeAction()),
-    DECOMPILE_MLOG("pm", new ProcessMlogAction()),
+    PROCESS_MLOG("pm", new ProcessMlogAction()),
     COMPILE_SCHEMA("cs", new CompileSchemacodeAction()),
-    DECOMPILE_SCHEMA("ps", new ProcessSchemacodeAction()),
+    PROCESS_SCHEMA("ps", new ProcessSchemacodeAction()),
     ;
 
     private final String shortcut;

toolapp/src/main/java/info/teksol/mindcode/cmdline/mlogwatcher/MlogWatcherCommand.java

@@ -7,15 +7,15 @@
 import static info.teksol.mindcode.cmdline.ToolAppAction.*;
 
 public enum MlogWatcherCommand {
-    UPDATE              (COMPILE_MINDCODE, DECOMPILE_MLOG, COMPILE_SCHEMA, DECOMPILE_SCHEMA),
+    UPDATE              (COMPILE_MINDCODE, PROCESS_MLOG, COMPILE_SCHEMA, PROCESS_SCHEMA),
 
-    UPDATE_ALL          (COMPILE_MINDCODE, DECOMPILE_MLOG),
-    UPGRADE_ALL         (COMPILE_MINDCODE, DECOMPILE_MLOG),
-    FORCE_UPDATE_ALL    (COMPILE_MINDCODE, DECOMPILE_MLOG),
+    UPDATE_ALL          (COMPILE_MINDCODE, PROCESS_MLOG),
+    UPGRADE_ALL         (COMPILE_MINDCODE, PROCESS_MLOG),
+    FORCE_UPDATE_ALL    (COMPILE_MINDCODE, PROCESS_MLOG),
 
-    EXTRACT             (DECOMPILE_MLOG, DECOMPILE_SCHEMA),
+    EXTRACT             (PROCESS_MLOG, PROCESS_SCHEMA),
 
-    ADD                 (COMPILE_SCHEMA, DECOMPILE_SCHEMA),
+    ADD                 (COMPILE_SCHEMA, PROCESS_SCHEMA),
     ;
 
     private final Set<ToolAppAction> supportedActions;

toolapp/src/test/java/info/teksol/mindcode/cmdline/ProcessSchemacodeActionTest.java

@@ -15,7 +15,7 @@
 
 @NullMarked
 class ProcessSchemacodeActionTest {
-    private final ToolAppAction action = ToolAppAction.DECOMPILE_SCHEMA;
+    private final ToolAppAction action = ToolAppAction.PROCESS_SCHEMA;
 
     protected Namespace parseCommandLine(String commandLine) throws ArgumentParserException {
         ArgumentParser parser = Main.createArgumentParser(Arguments.fileType(), 79);