@debuffjp/juice

中文文档
0.33.0发布于 2026/11/11MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 8900

Tweens, easing, particles and game-feel effects for debuff

原始使用文档

@debuffjp/juice

Game-feel building blocks: tweens, easing, pooled particles, trails and squash-and-stretch. No dependencies, and each export can be used on its own.

import { Particles, squash, Tweens } from "@debuffjp/juice";

const tweens = new Tweens();
const particles = new Particles(() => game.random.next()); // seeded, so captures are reproducible

// on impact
squash(tweens, player, 0.35);
particles.emit({ x, y, count: 16, colors: ["#ffd166", "#ef476f"], gravity: 200 });
game.camera.shake(0.3);
game.freeze(0.06); // hit-stop

// every step
tweens.update(dt);
particles.update(dt);

API

  • Tweens: to(target, props, { duration, ease, delay, yoyo, repeat, onComplete }) → { done, cancel(), finished }, kill(target), update(dt)
  • ease: linear, in/out/inOutQuad, in/out/inOutCubic, outBack, outElastic, outBounce
  • Particles: emit({ x, y, count, speed, angle, spread, life, size, sizeEnd, colors, gravity, drag, shape, additive }), update(dt), draw(draw), clear()
  • Trail: push(x, y), draw(draw), clear()
  • squash(tweens, target, amount?, duration?): replaces only the scale tweens on target, so a move or fade on it keeps running. Before 0.8 it stopped every tween on the target.

版本与发布记录

@debuffjp/juice 共发布 56 个版本,首次发布于 2026/10/16;过去 12 个月发布了 56 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.33.0latest2026/11/11今天
0.32.02026/11/074 天前
0.31.12026/11/065 天前
0.31.02026/11/065 天前
0.30.02026/11/056 天前
0.29.22026/11/056 天前

关于 @debuffjp/juice 的常见问题

@debuffjp/juice 是什么?

Tweens, easing, particles and game-feel effects for debuff

如何安装 @debuffjp/juice?

在项目目录运行 npm install @debuffjp/juice,或使用 pnpm add / yarn add / bun add。

@debuffjp/juice 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@debuffjp/juice 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@debuffjp/juice 可以商用吗?

@debuffjp/juice 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@debuffjp/juice 的下载量有多少?

根据 npm 官方下载统计,@debuffjp/juice 在 2026/10/12 – 2026/11/10 这 30 天内被下载 8,900 次,日均约 297 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@debuffjp/juice 还在维护吗?

最新版本 0.33.0 发布于 2026/11/11(今天);至今共发布 56 个版本,其中过去 12 个月发布了 56 个;首次发布于 2026/10/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。