@fps-games/vfx 0.3.8 → 0.3.10

package/dist/effects/mining-hit/index.js

@@ -0,0 +1,232 @@
+import { Mesh } from "@babylonjs/core/Meshes/mesh";
+import { ParticleSystem } from "@babylonjs/core/Particles/particleSystem";
+import { DynamicTexture } from "@babylonjs/core/Materials/Textures/dynamicTexture";
+import { Color4 } from "@babylonjs/core/Maths/math.color";
+import { Vector3, Matrix } from "@babylonjs/core/Maths/math.vector";
+import { SceneLoader } from "@babylonjs/core/Loading/sceneLoader";
+import "@babylonjs/loaders/glTF/2.0/glTFLoader";
+import { F as FlyerPool, m as makeBurstPS } from "../../chunks/space-shared-BXV1hc0k.js";
+import { s as smokeUrl, r as rockModelUrl } from "../../chunks/smoke22-B_WJKB0y.js";
+const DEFAULT_PARAMS = {
+  flashCount: 14,
+  flashSize: 0.9,
+  flashLength: 0.9,
+  flashBright: 2.1,
+  flashColor: { r: 1, g: 0.9, b: 0.46 },
+  height: 0,
+  debrisCount: 12,
+  debrisSize: 0.32,
+  debrisRadius: 1.35,
+  debrisSpeed: 0.9,
+  debrisHorizontalSpeed: 0.95,
+  debrisUpSpeed: 0.85,
+  debrisDirectionX: 0,
+  debrisDirectionY: 0,
+  debrisDirectionZ: 0,
+  debrisGravity: 8,
+  debrisLifetime: 1.15,
+  smokeCount: 14,
+  smokeSize: 0.95,
+  smokeRise: 1.1
+};
+const flashTextureCache = /* @__PURE__ */ new WeakMap();
+function getFlashTexture(scene) {
+  const cached = flashTextureCache.get(scene);
+  if (cached) return cached;
+  const glow = new DynamicTexture("vfx_mining_hit_glow", 128, scene, false);
+  glow.hasAlpha = true;
+  const ctx = glow.getContext();
+  ctx.clearRect(0, 0, 128, 128);
+  const gradient = ctx.createRadialGradient(64, 64, 0, 64, 64, 64);
+  gradient.addColorStop(0, "rgba(255,255,255,1)");
+  gradient.addColorStop(0.85, "rgba(255,255,255,0.9)");
+  gradient.addColorStop(1, "rgba(255,255,255,0)");
+  ctx.fillStyle = gradient;
+  ctx.beginPath();
+  ctx.arc(64, 64, 64, 0, Math.PI * 2);
+  ctx.fill();
+  glow.update();
+  flashTextureCache.set(scene, glow);
+  return glow;
+}
+const cachedRockTemplates = /* @__PURE__ */ new WeakMap();
+function loadRockTemplates(scene) {
+  const existing = cachedRockTemplates.get(scene);
+  if (existing) return existing;
+  const isDataUri = rockModelUrl.startsWith("data:");
+  const lastSlash = isDataUri ? -1 : rockModelUrl.lastIndexOf("/");
+  const rootUrl = lastSlash >= 0 ? rockModelUrl.slice(0, lastSlash + 1) : "";
+  const fileName = lastSlash >= 0 ? rockModelUrl.slice(lastSlash + 1) : rockModelUrl;
+  const promise = SceneLoader.ImportMeshAsync("", rootUrl, fileName, scene, void 0, ".glb").then((res) => {
+    const templates = res.meshes.filter((mesh) => mesh instanceof Mesh && mesh.getTotalVertices() > 0);
+    for (const template of templates) {
+      template.setParent(null);
+      const center = template.getBoundingInfo().boundingBox.centerWorld.clone();
+      template.bakeTransformIntoVertices(Matrix.Translation(-center.x, -center.y, -center.z));
+      template.position.set(0, 0, 0);
+      template.setEnabled(false);
+      template.isPickable = false;
+    }
+    return templates;
+  }).catch((error) => {
+    cachedRockTemplates.delete(scene);
+    throw error;
+  });
+  cachedRockTemplates.set(scene, promise);
+  return promise;
+}
+function c4(color, multiplier = 1, alpha = 1) {
+  return new Color4(color.r * multiplier, color.g * multiplier, color.b * multiplier, alpha);
+}
+function averageScale(scale) {
+  return Math.max(1e-4, (Math.abs(scale.x) + Math.abs(scale.y) + Math.abs(scale.z)) / 3);
+}
+const miningHitEffectPackage = {
+  id: "mining-hit",
+  nameZh: "采矿受击",
+  placement: "world",
+  debugAnchor: "playerRight",
+  defaultParams: DEFAULT_PARAMS,
+  debugParams: [
+    { key: "flashCount", label: "闪光·数量", kind: "number", min: 0, max: 40, step: 1 },
+    { key: "flashSize", label: "闪光·尺寸", kind: "scale", min: 0.2, max: 3, step: 0.05 },
+    { key: "flashLength", label: "闪光·拉伸", kind: "scale", min: 0.2, max: 3, step: 0.05 },
+    { key: "flashBright", label: "闪光·亮度", kind: "number", min: 0.5, max: 5, step: 0.05 },
+    { key: "flashColor", label: "闪光·颜色", kind: "color" },
+    { key: "height", label: "高度", kind: "number", min: -2, max: 3, step: 0.05 },
+    { key: "debrisCount", label: "碎石·数量", kind: "number", min: 0, max: 30, step: 1 },
+    { key: "debrisSize", label: "碎石·大小", kind: "number", min: 0.1, max: 1, step: 0.01 },
+    { key: "debrisRadius", label: "碎石·范围", kind: "scale", min: 0.5, max: 5, step: 0.1 },
+    { key: "debrisSpeed", label: "碎石·整体速度", kind: "number", min: 0, max: 5, step: 0.05 },
+    { key: "debrisHorizontalSpeed", label: "碎石·横向速度", kind: "number", min: 0, max: 5, step: 0.05 },
+    { key: "debrisUpSpeed", label: "碎石·上抛速度", kind: "number", min: 0, max: 5, step: 0.05 },
+    { key: "debrisDirectionX", label: "碎石·方向 X", kind: "number", min: -1, max: 1, step: 0.01 },
+    { key: "debrisDirectionY", label: "碎石·方向 Y", kind: "number", min: -1, max: 1, step: 0.01 },
+    { key: "debrisDirectionZ", label: "碎石·方向 Z", kind: "number", min: -1, max: 1, step: 0.01 },
+    { key: "debrisGravity", label: "碎石·下落重力", kind: "number", min: 0, max: 20, step: 0.1 },
+    { key: "debrisLifetime", label: "碎石·可见时长", kind: "lifetime", min: 0.2, max: 4, step: 0.05 },
+    { key: "smokeCount", label: "烟雾·数量", kind: "number", min: 0, max: 40, step: 1 },
+    { key: "smokeSize", label: "烟雾·尺寸", kind: "scale", min: 0.2, max: 3, step: 0.05 },
+    { key: "smokeRise", label: "烟雾·上浮", kind: "number", min: 0, max: 4, step: 0.05 }
+  ],
+  create({ scene, root, position, params, scale }) {
+    root.position.copyFrom(position);
+    const spawnScale = averageScale(scale);
+    const origin = position.clone();
+    origin.y += params.height * spawnScale;
+    const flash = createFlashBurst(scene, origin, params, spawnScale);
+    const smoke = createSmokeBurst(scene, origin, params, spawnScale);
+    const debrisPool = new FlyerPool(scene);
+    let disposed = false;
+    const ready = (params.debrisCount > 0 ? loadRockTemplates(scene) : Promise.resolve([])).then((templates) => {
+      if (disposed || templates.length === 0) return;
+      const count = Math.round(params.debrisCount);
+      const radius = params.debrisRadius * spawnScale;
+      for (let i = 0; i < count; i += 1) {
+        const template = templates[Math.random() * templates.length | 0];
+        const debris = template.clone("vfx_mining_hit_debris", null, false);
+        if (!debris) continue;
+        debris.setEnabled(true);
+        debris.isPickable = false;
+        debris.normalizeToUnitCube();
+        debris.scaling.scaleInPlace(radius * params.debrisSize * (0.5 + Math.random() * 0.8));
+        debrisPool.spawn(debris, origin, makeDebrisVelocity(params, spawnScale), params.debrisGravity, params.debrisLifetime);
+      }
+    }).catch((error) => {
+      console.warn("[VFX] mining-hit load failed", error);
+    });
+    let elapsed = 0;
+    let flashStopped = false;
+    const observer = scene.onBeforeRenderObservable.add(() => {
+      elapsed += scene.getEngine().getDeltaTime();
+      if (!flashStopped && elapsed >= 180) {
+        flash.stop();
+        flashStopped = true;
+      }
+    });
+    const disposeDelay = Math.max(2200, params.debrisLifetime * 1e3 + 1e3);
+    const disposeTimer = window.setTimeout(() => disposeAll(), disposeDelay);
+    function disposeAll() {
+      if (disposed) return;
+      disposed = true;
+      window.clearTimeout(disposeTimer);
+      scene.onBeforeRenderObservable.remove(observer);
+      debrisPool.dispose();
+      flash.dispose(false);
+      smoke.dispose();
+      root.dispose();
+    }
+    return { root, ready, dispose() {
+      disposeAll();
+    } };
+  }
+};
+function createFlashBurst(scene, origin, params, spawnScale) {
+  const flash = new ParticleSystem("vfx_mining_hit_flash", 120, scene);
+  flash.emitter = origin.clone();
+  flash.minEmitBox = new Vector3(0, 0, 0);
+  flash.maxEmitBox = new Vector3(0, 0, 0);
+  flash.billboardMode = ParticleSystem.BILLBOARDMODE_STRETCHED;
+  flash.minLifeTime = 0.12;
+  flash.maxLifeTime = 0.25;
+  flash.minEmitPower = 9.1 * spawnScale;
+  flash.maxEmitPower = 15.6 * spawnScale;
+  flash.direction1 = new Vector3(-1, 0.05, -1);
+  flash.direction2 = new Vector3(1, 0.15, 1);
+  flash.gravity = new Vector3(0, 0, 0);
+  flash.emitRate = 0;
+  flash.blendMode = ParticleSystem.BLENDMODE_ADD;
+  flash.particleTexture = getFlashTexture(scene);
+  flash.minSize = 0.78 * params.flashSize * spawnScale;
+  flash.maxSize = 1.3 * params.flashSize * spawnScale;
+  flash.minScaleY = 3.38 * params.flashLength;
+  flash.maxScaleY = 5.46 * params.flashLength;
+  flash.minScaleX = 0.18 * params.flashSize;
+  flash.maxScaleX = 0.36 * params.flashSize;
+  flash.addColorGradient(0, c4(params.flashColor, params.flashBright, 1));
+  flash.addColorGradient(0.5, c4(params.flashColor, params.flashBright * 0.75, 1));
+  flash.addColorGradient(1, c4(params.flashColor, params.flashBright * 0.5, 0));
+  flash.manualEmitCount = Math.round(params.flashCount);
+  flash.start();
+  return flash;
+}
+function createSmokeBurst(scene, origin, params, spawnScale) {
+  const smoke = makeBurstPS("vfx_mining_hit_smoke", scene, smokeUrl, {
+    cap: 120,
+    size: [2.2 * spawnScale, 4.5 * spawnScale],
+    life: [0.9, 1.6],
+    power: [1.5 * spawnScale, 4 * spawnScale],
+    gravity: new Vector3(0, params.smokeRise, 0),
+    blend: ParticleSystem.BLENDMODE_STANDARD,
+    c1: new Color4(0.5, 0.45, 0.42, 0.65),
+    c2: new Color4(0.32, 0.3, 0.3, 0.5),
+    cd: new Color4(0.2, 0.2, 0.2, 0)
+  });
+  smoke.minSize *= params.smokeSize;
+  smoke.maxSize *= params.smokeSize;
+  smoke.emitter.copyFrom(origin);
+  smoke.manualEmitCount += Math.round(params.smokeCount);
+  return smoke;
+}
+function makeDebrisVelocity(params, spawnScale) {
+  const velocity = new Vector3(
+    (Math.random() - 0.5) * 13 * params.debrisHorizontalSpeed,
+    (Math.random() * 6.75 + 2.25) * params.debrisUpSpeed,
+    (Math.random() - 0.5) * 13 * params.debrisHorizontalSpeed
+  );
+  const direction = new Vector3(params.debrisDirectionX, params.debrisDirectionY, params.debrisDirectionZ);
+  const directionLength = direction.length();
+  if (directionLength > 1e-4) {
+    direction.scaleInPlace(1 / directionLength);
+    const directionSpeed = 6.5 * Math.min(directionLength, 1);
+    velocity.addInPlace(new Vector3(
+      direction.x * directionSpeed * params.debrisHorizontalSpeed,
+      direction.y * directionSpeed * params.debrisUpSpeed,
+      direction.z * directionSpeed * params.debrisHorizontalSpeed
+    ));
+  }
+  return velocity.scaleInPlace(params.debrisSpeed * spawnScale);
+}
+export {
+  miningHitEffectPackage
+};

package/index.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "vfx-index/1.0",
-  "count": 37,
+  "count": 39,
   "effects": [
     {
       "id": "build.particle.lumber_debris_scatter",
@@ -217,6 +217,26 @@
       "media": {},
       "path": "packages/effects/lumber-cart-suction"
     },
+    {
+      "id": "magnet-suction",
+      "dir": "magnet-suction",
+      "nameZh": "磁铁吸入线",
+      "kind": "code",
+      "category": "magnet-suction",
+      "tags": [],
+      "media": {},
+      "path": "packages/effects/magnet-suction"
+    },
+    {
+      "id": "mining-hit",
+      "dir": "mining-hit",
+      "nameZh": "采矿受击",
+      "kind": "code",
+      "category": "mining-hit",
+      "tags": [],
+      "media": {},
+      "path": "packages/effects/mining-hit"
+    },
     {
       "id": "monster-hit",
       "dir": "monster-hit",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fps-games/vfx",
-  "version": "0.3.8",
+  "version": "0.3.10",
   "type": "module",
   "description": "Shared VFX library for Playable projects: engine-injected effect packages + runtime. Project-pure (no imports of host project code).",
   "publishConfig": {

package/packages/effects/magnet-suction/vfx-params.json

@@ -0,0 +1,36 @@
+{
+  "lifetimeMode": "infinite",
+  "lifetime": 2.5,
+  "scale": 1.15,
+  "initialHeight": 0,
+  "color": {
+    "r": 0.82,
+    "g": 0.95,
+    "b": 1
+  },
+  "opacity": 1,
+  "intensity": 1,
+  "forwardOffset": 0,
+  "suctionLength": 2.25,
+  "startRadius": 0.7,
+  "spreadY": 0.34,
+  "endRadius": 0.08,
+  "mouthPadding": 0.18,
+  "fadeDistance": 0.58,
+  "spawnFade": 0.45,
+  "suctionSpeed": 1.65,
+  "lineCount": 32,
+  "lineLength": 0.46,
+  "lineWidth": 0.045,
+  "lineOpacity": 1,
+  "lineSpread": 1,
+  "lineTwist": 0,
+  "particleCount": 14,
+  "particleSize": 0.032,
+  "particleSpeed": 2.15,
+  "particleDrift": 0,
+  "particleOuterOffset": 0,
+  "particleOpacity": 0.55,
+  "directionX": 0,
+  "directionZ": -1
+}

package/packages/effects/mining-hit/vfx-params.json

@@ -0,0 +1,5 @@
+{
+  "schemaVersion": "vfx-params/1.0",
+  "effectId": "mining-hit",
+  "params": {}
+}