Added part of docs

docs/en/reference/RAND.md

@@ -0,0 +1,52 @@
+# RAND
+
+The built-in pseudo-random number generator. Available under the global name `RAND` from any context, and also under the alias `RANDOM` (see [Built-in objects](../engine/globals.md#built-in-objects)).
+
+## Methods
+
+### GET
+
+```
+INTEGER GET(INTEGER range)
+INTEGER GET(INTEGER offset, INTEGER range)
+```
+
+Returns a pseudo-random number.
+
+- The one-argument form returns a value from `[0, range)`.
+- The two-argument form returns a value from `[offset, offset + range)`.
+
+If `range` is less than or equal to `0`, `offset` is returned (or `0` in the one-argument form).
+
+**Parameters**
+
+- `offset` — start of the range (inclusive), default `0`.
+- `range` — size of the range (the upper bound is exclusive).
+
+**Returns**: the generated random value.
+
+**Examples**
+
+```
+RANDOM^GET(100);
+RANDOM^GET(VARI_TMP3);
+RANDOM^GET(0, 3);
+```
+
+### GETPLENTY
+
+```
+void GETPLENTY(STRING arrayName, INTEGER count, INTEGER offset, INTEGER range, BOOL onlyUnique)
+```
+
+Generates `count` pseudo-random integers from the range `[offset, offset + range)` and appends them to the array named `arrayName`. The array is not cleared before appending.
+
+If `onlyUnique` is `TRUE`, every generated value must be different from the previously generated ones; if the requested number of unique values exceeds the range size (`count > range`), the method leaves the array unchanged. For `count` less than `1`, the method also has no effect.
+
+**Parameters**
+
+- `arrayName` — name of the target [`ARRAY`](ARRAY.md) variable.
+- `count` — number of elements to generate.
+- `offset` — start of the range (inclusive).
+- `range` — size of the range (the upper bound is exclusive).
+- `onlyUnique` — `TRUE` to enforce uniqueness among the generated values.