player impulse (JaylyDev#173)

Author: jayly-bot

scripts/player-impulse/README.md

@@ -0,0 +1,17 @@
+# player-impulse
+
+## Description
+
+Remake `setVelocity` for players.
+
+## Usage
+
+```js
+import { applyImpulse } from "./index";
+
+applyImpulse(player, vector);
+```
+
+## Credits
+
+This script is made by [SI Silicon](https://github.com/SIsilicon), updated by Remember M9#8416 and Usernam#2058

scripts/player-impulse/index.ts

@@ -0,0 +1,19 @@
+// Script example for ScriptAPI
+// Author: Usernam#2058 <Jayly Discord>
+//         Remember M9#8416 <Bedrock Add-Ons>
+//         SI Silicon <https://github.com/SIsilicon>
+// Project: https://github.com/JaylyDev/ScriptAPI
+
+import { Player, Vector3 } from "@minecraft/server";
+
+/**
+ * Workaround to apply impulse vector to the current velocity of the player.
+ * @param player Only Player class, not Entity.
+ * @param vector 
+ */
+export function applyImpulse(player: Player, vector: Vector3) {
+  const { x, y, z } = vector;
+  const horizontal = Math.sqrt(x * x + z * z) * 2.0;
+  const vertical = y < 0.0 ? 0.5 * y : y;
+  player.applyKnockback(x, z, horizontal, vertical);
+}

scripts/player-impulse/tests.ts

@@ -0,0 +1,13 @@
+// Script example for ScriptAPI
+// Author: Usernam#2058 <Jayly Discord>
+// Project: https://github.com/JaylyDev/ScriptAPI
+
+import { applyImpulse } from "./index";
+import { Vector3, world } from "@minecraft/server";
+
+const armorStand = [...world.getDimension("overworld").getEntities({ type: 'minecraft:armor_stand' })][0];
+const player = world.getAllPlayers()[0];
+const vector: Vector3 = { x: 0, y: 2, z: 0 };
+
+armorStand.applyImpulse(vector);
+applyImpulse(player, vector);