Document new NativeProxyCommandSender.from method

Author: willkroboth

commandapi-documentation-code/src/main/java/dev/jorel/commandapi/examples/java/Examples.java

@@ -1821,6 +1821,27 @@ void nativeSender() {
     })
     .register();
 /* ANCHOR_END: native1 */
+
+/* ANCHOR: native2 */
+new CommandAPICommand("executeAs")
+    .withArguments(
+        new EntitySelectorArgument.OneEntity("target"),
+        new LocationArgument("location"),
+        new WorldArgument("world"),
+        new CommandArgument("command")
+    )
+    .executes((caller, args) -> {
+        CommandSender callee = args.getUnchecked("target");
+        Location location = args.getUnchecked("location");
+        World world = args.getUnchecked("world");
+        CommandResult command = args.getUnchecked("command");
+
+        assert callee != null && location != null && world != null && command != null;
+
+        command.execute(NativeProxyCommandSender.from(caller, callee, location, world));
+    })
+    .register();
+/* ANCHOR_END: native2 */
 }
 
 void normalExecutors() {

commandapi-documentation-code/src/main/kotlin/dev/jorel/commandapi/examples/kotlin/Examples.kt

@@ -1726,6 +1726,25 @@ CommandAPICommand("break")
     })
     .register()
 /* ANCHOR_END: native1 */
+
+/* ANCHOR: native2 */
+CommandAPICommand("executeAs")
+    .withArguments(
+        EntitySelectorArgument.OneEntity("target"),
+        LocationArgument("location"),
+        WorldArgument("world"),
+        CommandArgument("command")
+    )
+    .executes(CommandExecutor { caller, args ->
+        val callee = args["target"] as CommandSender
+        val location = args["location"] as Location
+        val world = args["world"] as World
+        val command = args["command"] as CommandResult
+
+        command.execute(NativeProxyCommandSender.from(caller, callee, location, world))
+    })
+    .register();
+/* ANCHOR_END: native2 */
 }
 
 fun normalExecutors() {

commandapi-documentation-code/src/main/kotlin/dev/jorel/commandapi/examples/kotlin/ExamplesKotlinDSL.kt

@@ -1109,6 +1109,23 @@ commandAPICommand("break") {
     }
 }
 /* ANCHOR_END: native1 */
+
+/* ANCHOR: native1 */
+commandAPICommand("executeAs") {
+    entitySelectorArgumentOneEntity("target")
+    locationArgument("location")
+    worldArgument("world")
+    commandArgument("command")
+    anyExecutor { caller, args ->
+        val callee = args["target"] as CommandSender
+        val location = args["location"] as Location
+        val world = args["world"] as World
+        val command = args["command"] as CommandResult
+
+        command.execute(NativeProxyCommandSender.from(caller, callee, location, world))
+    }
+}
+/* ANCHOR_END: native1 */
 }
 
 fun optional_arguments() {

docssrc/src/native.md

@@ -81,3 +81,29 @@ This can now be used via the following command examples:
 ```
 
 </div>
+
+---
+
+You may also create a `NativeProxyCommandSender` object yourself using the static `from` method:
+
+```java
+public static NativeProxyCommandSender from(CommandSender caller, CommandSender callee, Location location, World world);
+```
+
+This `CommandSender` will work the same as any other `NativeProxyCommandSender` you would get while using `executesNative`. For example, you could use it to make a simple version of `/execute`, like so:
+
+<div class="multi-pre">
+
+```java,Java
+{{#include ../../commandapi-documentation-code/src/main/java/dev/jorel/commandapi/examples/java/Examples.java:native2}}
+```
+
+```kotlin,Kotlin
+{{#include ../../commandapi-documentation-code/src/main/kotlin/dev/jorel/commandapi/examples/kotlin/Examples.kt:native2}}
+```
+
+```kotlin,Kotlin_DSL
+{{#include ../../commandapi-documentation-code/src/main/kotlin/dev/jorel/commandapi/examples/kotlin/ExamplesKotlinDSL.kt:native2}}
+```
+
+</div>

docssrc/src/upgrading.md

@@ -1,5 +1,39 @@
 # Upgrading guide
 
+[//]: # (TODO: Change 9.3.0 to the correct version)
+
+## From 9.3.0 to 10.0.0
+
+### NativeProxyCommandSender changes
+
+`NativeProxyCommandSender` used to be a class, but this version changed it to an interface. Any code compiled against an earlier version that references any method of `NativeProxyCommandSender` may throw the following `IncompatibleClassChangeError` when run using the new version of the API:
+
+```log
+java.lang.IncompatibleClassChangeError: Found interface dev.jorel.commandapi.wrappers.NativeProxyCommandSender, but class was expected
+```
+
+If this happens, the original code simply needs to be recompiled using the new API version.
+
+Additionally, the constructor of `NativeProxyCommandSender` is no longer available. Instead, the static `from` method should be used:
+
+<div class="multi-pre">
+
+```java,9.3.0
+new NativeProxyCommandSender(caller, callee, location, world)
+```
+
+</div>
+
+$$\downarrow$$
+
+<div class="multi-pre">
+
+```java,10.0.0
+NativeProxyCommandSender.from(caller, callee, location, world)
+```
+
+</div>
+
 ## From 9.2.0 to 9.3.0
 
 The `BukkitTooltip.generateAdvenureComponents` methods have now been deprecated in favour of the correctly named `BukkitTooltip.generateAdventureComponents` methods: