@rpgjs/action-battle 5.0.0-alpha.28

package/dist/server.d.ts

@@ -0,0 +1,93 @@
+import { RpgEvent, RpgPlayer } from '@rpgjs/server';
+import { HitResult, ApplyHitHooks } from './ai.server';
+/**
+ * Default player attack hitboxes offsets for each direction
+ *
+ * These hitboxes define the attack areas relative to the player's position
+ * for each cardinal direction. They are converted to absolute coordinates
+ * when creating the moving hitbox.
+ */
+export declare const DEFAULT_PLAYER_ATTACK_HITBOXES: {
+    up: {
+        offsetX: number;
+        offsetY: number;
+        width: number;
+        height: number;
+    };
+    down: {
+        offsetX: number;
+        offsetY: number;
+        width: number;
+        height: number;
+    };
+    left: {
+        offsetX: number;
+        offsetY: number;
+        width: number;
+        height: number;
+    };
+    right: {
+        offsetX: number;
+        offsetY: number;
+        width: number;
+        height: number;
+    };
+    default: {
+        offsetX: number;
+        offsetY: number;
+        width: number;
+        height: number;
+    };
+};
+/**
+ * Get knockback force from player's equipped weapon
+ *
+ * Retrieves the knockbackForce property from the player's equipped weapon.
+ * Falls back to DEFAULT_KNOCKBACK.force if no weapon or property is set.
+ *
+ * @param player - The player to get weapon knockback from
+ * @returns Knockback force value
+ *
+ * @example
+ * ```ts
+ * // Player with weapon having knockbackForce: 80
+ * const force = getPlayerWeaponKnockbackForce(player); // 80
+ *
+ * // No weapon equipped
+ * const force = getPlayerWeaponKnockbackForce(player); // 50 (default)
+ * ```
+ */
+export declare function getPlayerWeaponKnockbackForce(player: RpgPlayer): number;
+/**
+ * Apply hit from player to target (event with AI)
+ *
+ * Handles damage calculation, knockback based on weapon, and visual effects.
+ * Can be customized using hooks.
+ *
+ * @param player - The attacking player
+ * @param target - The event being hit
+ * @param hooks - Optional hooks for customizing hit behavior
+ * @returns Hit result if AI exists, undefined otherwise
+ *
+ * @example
+ * ```ts
+ * // Basic hit
+ * const result = applyPlayerHitToEvent(player, event);
+ *
+ * // With custom hooks
+ * const result = applyPlayerHitToEvent(player, event, {
+ *   onBeforeHit(result) {
+ *     result.knockbackForce *= 2; // Double knockback
+ *     return result;
+ *   },
+ *   onAfterHit(result) {
+ *     if (result.defeated) {
+ *       player.gold += 10;
+ *     }
+ *   }
+ * });
+ * ```
+ */
+export declare function applyPlayerHitToEvent(player: RpgPlayer, target: RpgEvent, hooks?: ApplyHitHooks): HitResult | undefined;
+declare const _default: any;
+export default _default;

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@rpgjs/action-battle",
+  "version": "5.0.0-alpha.28",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/client/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./client": {
+      "import": "./dist/client/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./server": {
+      "import": "./dist/server/index.js",
+      "types": "./dist/server.d.ts"
+    }
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "description": "RPGJS is a framework for creating RPG/MMORPG games",
+  "peerDependencies": {
+    "@canvasengine/presets": "*",
+    "@rpgjs/client": "5.0.0-alpha.28",
+    "@rpgjs/common": "5.0.0-alpha.28",
+    "@rpgjs/server": "5.0.0-alpha.28",
+    "@rpgjs/vite": "5.0.0-alpha.28",
+    "canvasengine": "*"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@canvasengine/compiler": "^2.0.0-beta.42",
+    "vite": "^7.3.0",
+    "vite-plugin-dts": "^4.5.4"
+  },
+  "type": "module",
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build"
+  }
+}