Added part of docs

docs/en/reference/APPLICATION.md

@@ -0,0 +1,154 @@
+# APPLICATION
+
+The application object — the top of the script hierarchy. Declared in [`Application.def`](../engine/scripts.md#entry-point) as the first object; lists the episodes and points to the one to start with.
+
+## Fields
+
+### EPISODES
+
+```
+STRING EPISODES
+```
+
+The list of episode names ([`EPISODE`](EPISODE.md)) that make up the application, separated by commas. The analysed games typically contain a single entry.
+
+### PATH
+
+```
+STRING PATH
+```
+
+Path relative to the `dane` directory where the application's files live. Used by the engine when locating the `.CNV` file bound to the application (see [Loading subsequent files](../engine/scripts.md#loading-subsequent-files)).
+
+### STARTWITH
+
+```
+STRING STARTWITH
+```
+
+Name of the episode the engine will start the game with.
+
+### Metadata
+
+The following fields are stored in the script as metadata and do not directly affect engine behaviour:
+
+- `AUTHOR` — file author.
+- `BLOOMOO_VERSION` — BlooMoo engine version.
+- `CREATIONTIME` — file creation date.
+- `DESCRIPTION` — application description.
+- `LASTMODIFYTIME` — file last-modification date.
+- `VERSION` — application version.
+
+## Methods
+
+### EXIT
+
+```
+void EXIT()
+```
+
+Terminates the application.
+
+**Examples**
+
+```
+GAME^EXIT();
+```
+
+### GETLANGUAGE
+
+```
+STRING GETLANGUAGE()
+```
+
+Returns the application's currently selected language. Defaults to `"POL"`.
+
+**Returns**: the language code.
+
+**Examples**
+
+```
+UFO^GETLANGUAGE();
+```
+
+### RUN
+
+```
+mixed RUN(STRING varName, STRING methodName, [mixed param1, ..., mixed paramN])
+```
+
+Invokes the method `methodName` on the variable `varName`, forwarding the remaining arguments. The return value is whatever the called method returns. This is the engine's dynamic-dispatch mechanism — both the target variable and the method can be selected at runtime.
+
+**Parameters**
+
+- `varName` — name of the target variable.
+- `methodName` — name of the method to invoke.
+- `param1, …, paramN` — (optional) arguments forwarded to the call.
+
+**Returns**: the value returned by the invoked method.
+
+**Examples**
+
+```
+UFO^RUN(VARSTRINGTEMP, "SETASBUTTON", FALSE, FALSE);
+UFO^RUN(VARSTRINGTEMP, "HIDE");
+UFO^RUN(["ANIMO"+$1], "HIDE");
+UFO^RUN($1, "PLAY", $2);
+UFO^RUN(ARRCARS^GET(VARPLAYER), "SETPRIORITY", ARRPRIORITY^GET(VARPLAYER));
+```
+
+### RUNENV
+
+```
+mixed RUNENV(STRING sceneName, STRING behaviourName)
+```
+
+Calls the procedure `behaviourName`, but only when the currently active scene has the name `sceneName`. Otherwise the method has no effect. Useful for procedures that only make sense in a particular scene context.
+
+**Parameters**
+
+- `sceneName` — name of the scene in which the procedure must run.
+- `behaviourName` — name of the procedure to call.
+
+**Returns**: the value returned by the procedure, or `NULL` if the scene guard was not satisfied.
+
+**Examples**
+
+```
+GAME^RUNENV(SCENENAME, "__HELPSTART__");
+GAME^RUNENV(SCENENAME, "B_PAUSE_START");
+GAME^RUNENV(SCENENAME, "__CUTINIT__");
+```
+
+### SETLANGUAGE
+
+```
+void SETLANGUAGE(STRING languageCode)
+```
+
+Sets the application's language code. The engine maps the passed Windows LCID code to an internal language identifier per the table below:
+
+| LCID | Language | Internal ID | Subfolder |
+|---|---|---|---|
+| `0415` | Polish | `1` | `POL` |
+| `0405` | Czech | `2` | `CZE` |
+| `0402` | Bulgarian | `3` | `BUL` |
+| `0418` | Romanian | `4` | `ROM` |
+| `0419` | Russian | `5` | `RUS` |
+| `040E` | Hungarian | `6` | `HUN` |
+| `041B` | Slovak | `7` | `SLO` |
+| `0422` | Ukrainian | `8` | `UKR` |
+
+The selected identifier determines the localised-assets subfolder the engine consults when loading game files (see [Loading subsequent files](../engine/scripts.md#loading-subsequent-files)). Identifiers `9`, `10`, and `11` (set through paths other than `SETLANGUAGE`) all map to the `NIEM` subfolder — the German-language build. Any identifier outside the listed range yields an empty subfolder. Setting the language also re-initialises the keyboard layout.
+
+**Parameters**
+
+- `languageCode` — the LCID as a four-digit hexadecimal number.
+
+**Examples**
+
+```
+UFO^SETLANGUAGE("0415");
+UFO^SETLANGUAGE("040E");
+UFO^SETLANGUAGE("0419");
+```