@ai-rpg-engine/core

AI RPG 引擎的基础：世界状态、实体、动作、事件、规则、可预测的随机数生成器以及持久化功能。

安装

npm install @ai-rpg-engine/core

包含内容

• 引擎 (Engine)：基于时间步进的模拟循环，具有可重现性。
• 世界状态 (WorldState)：房间、实体、全局标志、时间步计数器。
• 实体状态 (EntityState)：资源、物品栏、状态效果、信仰、记忆。
• 动作流水线 (Action Pipeline)：验证 → 预处理 → 解析 → 后处理 → 提交。
• 事件总线 (Event Bus)：结构化事件，包含类型、源、目标和数据。
• 可预测的随机数生成器 (Seeded RNG)：从单个种子生成可重复的随机数。
• 模块系统 (Module System)：注册/组合模拟模块。
• 测试框架 (Test Harness)：用于确定性模块测试的辅助工具。

快速开始

import { Engine } from '@ai-rpg-engine/core';

const engine = new Engine({
  manifest: {
    id: 'my-game', title: 'My Game',
    version: '1.0.0', engineVersion: '1.0.0',
    ruleset: 'fantasy', modules: [],
    contentPacks: [],
  },
  seed: 42,
  modules: [],
});

const state = engine.getState();

文档

• 手册 (Handbook)：25 章 + 4 个附录
• GitHub

由 MCP Tool Shop 构建。