fix: fix some typo, add missing page

Author: MC-XiaoHei

docs/en/create-commands/arguments/types/map-arguments.md

@@ -154,7 +154,7 @@ To implement that, we create a command that uses a `MapArgument` and use `Player
 <<< @/../reference-code/src/main/kotlin/createcommands/arguments/types/MapArguments.kt#mapArgumentsExampleDSL
 :::
 
-:::warning Developer's Note:
+:::danger Developer's Note:
 
 The `MapArgument` is very strict and doesn't have room for any errors. A key must always be followed by the delimiter, then a value. One value and the next key must always be separated by the separator. Both keys and values also have the option to be surrounded by quotes.
 

docs/en/create-commands/functions-and-tags/function-wrapper.md

@@ -0,0 +1,64 @@
+---
+order: 3
+authors:
+  - JorelAli
+  - DerEchtePilz
+  - willkroboth
+---
+
+# The FunctionWrapper
+
+The CommandAPI includes the `FunctionWrapper` class which is a wrapper for Minecraft's functions. It allows you to execute the commands that are represented by the respective `.mcfunction` file.
+
+The `FunctionWrapper` class is an extension of the `SimpleFunctionWrapper` class. It is a `SimpleFunctionWrapper` which has been constructed from an existing command sender when a command is used. This means that the command sender has already been "baked into" the `FunctionWrapper` object, allowing you to run it without having to provide a command sender.
+
+## FunctionWrapper methods
+
+The `FunctionWrapper` class has the following methods:
+
+```java
+class FunctionWrapper extends SimpleFunctionWrapper {
+
+    // Methods specific to this class
+    int run();
+    int runAs(Entity e);
+
+    // Methods inherited from SimpleFunctionWrapper
+    static SimpleFunctionWrapper getFunction(NamespacedKey key);
+    static SimpleFunctionWrapper[] getTag(NamespacedKey key);
+    static Set<NamespacedKey> getFunctions();
+    static Set<NamespacedKey> getTags();
+    int run(CommandSender sender);
+    String[] getCommands();
+    NamespacedKey getKey();
+}
+```
+
+These methods allow you to interact with the Minecraft function that this class wraps.
+
+### `run()`
+
+:::warning run() support in 1.20.3+
+
+As of CommandAPI 9.3.0 (compatible with Minecraft versions 1.20.3 and 1.20.4), calling `run()` will always return a value of `1`, regardless of whether the command succeeds, fails, or returns a result.
+
+:::
+
+The `run()` method runs the function. The command executor that runs this function is the command executor that was used to retrieve it. For example, if a player in-game populated this argument, then the player will be filled in for `@p` and the player's location would be used for things such as `~ ~ ~`:
+
+:::tabs
+===Java
+<<< @/../reference-code/src/main/java/createcommands/functionsandtags/FunctionWrapperRef.java#runExample
+===Kotlin
+<<< @/../reference-code/src/main/kotlin/createcommands/functionsandtags/FunctionWrapperRef.kt#runExample
+:::
+
+### `runAs(Entity)`
+
+:::warning runAs(Entity) support in 1.20.3+
+
+As of CommandAPI 9.3.0 (compatible with Minecraft versions 1.20.3 and 1.20.4), calling `runAs(Entity)` will always return a value of `1`, regardless of whether the command succeeds, fails, or returns a result.
+
+:::
+
+The `runAs(Entity)` is the same as the `run()` method, but it allows you to change the command executor to another entity.

docs/en/create-commands/functions-and-tags/simple-function-wrapper.md

@@ -1,5 +1,5 @@
 ---
-order: 3
+order: 2
 authors:
   - JorelAli
 title: SimpleFunctionWrapper class
@@ -50,7 +50,7 @@ The methods `getFunctions()` and `getTags()` simply return a set of `NamespacedK
 
 ### `run(CommandSender)`
 
-:::warning `run(CommandSender)` support in 1.20.3+
+:::danger `run(CommandSender)` support in 1.20.3+
 
 As of CommandAPI 9.3.0 (compatible with Minecraft versions 1.20.3 and 1.20.4), calling `run(CommandSender)` will always return a value of `1`, regardless of whether the command succeeds, fails, or returns a result.
 
@@ -60,7 +60,7 @@ This method simply runs the current `SimpleFunctionWrapper` as the provided comm
 
 ### `getCommands()`
 
-:::warning `getCommands()` support in 1.20.3+
+:::danger `getCommands()` support in 1.20.3+
 
 As of CommandAPI 9.3.0 (compatible with Minecraft versions 1.20.3 and 1.20.4), calling `getCommands()` will always return an empty `String[]`. At the time of writing, it is not possible to extract the function command list in 1.20.3+.
 

docs/en/internal/brigadier-plus-commandapi.md

@@ -10,9 +10,11 @@ authors:
 
 So far, we've been using only the CommandAPI to register commands. As a result, this makes the CommandAPI's features limited by whatever the CommandAPI has implemented. To push past these limits, the CommandAPI includes some extra methods to help with invoking brigadier methods. Of course, to use these methods, brigadier is required. The brigadier dependency's installation instructions can be found [here](https://github.com/Mojang/brigadier#installation).
 
-> **Developer's Note:**
->
-> For those that are unaware, [brigadier](https://github.com/Mojang/brigadier) is Mojang's command parser and dispatching framework. This is what the CommandAPI wraps around and is the main underlying source of its functionality.
+:::info
+
+For those that are unaware, [brigadier](https://github.com/Mojang/brigadier) is Mojang's command parser and dispatching framework. This is what the CommandAPI wraps around and is the main underlying source of its functionality.
+
+:::
 
 The CommandAPI has been designed in such a way that you shouldn't have to access NMS in order to make use of the more "advanced" arguments and features - if you find that NMS is required to do something, [please make a new issue](https://github.com/CommandAPI/CommandAPI/issues/new/choose)!
 

reference-code/src/main/java/createcommands/functionsandtags/FunctionWrapperRef.java

@@ -0,0 +1,21 @@
+package createcommands.functionsandtags;
+
+import dev.jorel.commandapi.CommandAPICommand;
+import dev.jorel.commandapi.arguments.FunctionArgument;
+import dev.jorel.commandapi.wrappers.FunctionWrapper;
+
+class FunctionWrapperRef {
+    {
+        // #region runExample
+        new CommandAPICommand("runfunc")
+            .withArguments(new FunctionArgument("function"))
+            .executes((sender, args) -> {
+                FunctionWrapper[] functions = (FunctionWrapper[]) args.get("function");
+                for (FunctionWrapper function : functions) {
+                    function.run(); // The command executor in this case is 'sender'
+                }
+            })
+            .register();
+        // #endregion runExample
+    }
+}

reference-code/src/main/kotlin/createcommands/functionsandtags/FunctionWrapperRef.kt

@@ -0,0 +1,20 @@
+package createcommands.functionsandtags
+
+import dev.jorel.commandapi.CommandAPICommand
+import dev.jorel.commandapi.arguments.FunctionArgument
+import dev.jorel.commandapi.executors.CommandExecutor
+import dev.jorel.commandapi.wrappers.FunctionWrapper
+
+fun functionWrapper() {
+    // #region runExample
+    CommandAPICommand("runfunc")
+        .withArguments(FunctionArgument("function"))
+        .executes(CommandExecutor { _, args ->
+            val functions = args["function"] as Array<FunctionWrapper>
+            for (function in functions) {
+                function.run() // The command executor in this case is 'sender'
+            }
+        })
+        .register()
+    // #endregion runExample
+}