Merge pull request #63 from xiaoxustudio/main

feat: update random function docs

Author: MakinoharaShoko

src/en/webgal-script/variable.md

@@ -20,9 +20,26 @@ To set a random number, use `random()`
 setVar:a=random();
 ```
 
-The random number is between 0 and 1, if you want to specify a range, you need to do some math. For example, if you want a random number between 5 and 10, you need to do:
+`random([lower=0], [upper=1], [floating])` Random number is a **built-in function** that supports multiple parameters:
+
+**Parameter** :
+1. [lower=0] (number): indicates the lower limit.
+2. [upper=1] (number): indicates the upper limit.
+3. [floating] (boolean): Specifies whether to return a floating-point number.
+
+Instead of writing arguments, it generates a floating-point number in the range 0-1
+```ws
+setVar:a=random();
+```
+
+Of course, we can also specify **Range**. For example, if you want a random number between 5 and 10, You can write:
+```ws
+SetVar: a = the random (5, 10);
+```
+
+Of course you want it to use ranges to generate values that also have decimals, then specify a third argument:
 ```ws
-setVar:a=5+a*5;
+SetVar: a = the random (5, 10, true); # will generate a floating point number between 5 and 10
 ```
 
 You can also use previously defined variables when setting variables.

src/ja/webgal-script/variable.md

@@ -20,9 +20,26 @@ setVar:a=キャラクター名 // 文字列を設定可能
 setVar:a=random();
 ```
 
-乱数は0から1までの数字になります。乱数の範囲を指定したい場合は、算術演算を行う必要があります。例えば、5から10までの乱数を設定したい場合は、次のように演算する必要があります。
+` random([lower=0]、[upper=1]、[floating])`乱数は、複数の参照をサポートする**内蔵関数**です。
+
+**パラメータ**：
+1. [lower=0] (number): 下限。
+2. [upper=1] (number): 上限。
+3. [floating] (boolean): 浮動小数点数を返すかどうかを指定します。
+
+パラメータを書かずに0-1区間の浮動小数点数ですを生成します
+```ws
+setVar:a=random();
+```
+
+もちろん、私たちは**範囲**を指定することもできます。たとえば、5～10の間の乱数が必要な場合は、書くことができます：
+```ws
+setVar:a=random(5,10);
+```
+
+もちろん、範囲を使用して生成したい数値にも小数があるので、3番目のパラメータを指定することができます。
 ```ws
-setVar:a=5+a*5;
+setVar:a=random(5,10,true); # 5～10の浮動小数点数が生成されます
 ```
 
 以前に他の変数を定義している場合は、変数を設定する際にそれらを使用することもできます。

src/webgal-script/variable.md

@@ -20,9 +20,26 @@ setVar:a=人物名称 // 可以设置字符串
 setVar:a=random();
 ```
 
-随机数是一个0-1区间的数字，如果你需要指定随机数范围，你需要进行一些算数运算。比如，你想要5-10之间的随机数，你需要进行如下运算：
+`random([lower=0], [upper=1], [floating])` 随机数是一个**内置函数**，它支持多个传参：
+
+**参数**：
+1. [lower=0] (number): 下限。
+2. [upper=1] (number): 上限。
+3. [floating] (boolean): 指定是否返回浮点数。
+
+不写参数，它会生成一个是一个0-1区间的浮点数
+```ws
+setVar:a=random();
+```
+
+当然，我们也可以指定**范围**。比如，你想要5-10之间的随机数，你可以写成：
+```ws
+setVar:a=random(5,10);
+```
+
+当然你想要它使用范围生成的数值也有小数，那么可指定第三个参数：
 ```ws
-setVar:a=5+a*5;
+setVar:a=random(5,10,true); # 将会生成5-10之间的浮点数
 ```
 
 如果先前你定义过其他变量，也可以在设置变量时使用。