MCPcopy Index your code
hub / github.com/YunYouJun/advjs

github.com/YunYouJun/advjs @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
2,137 symbols 5,373 edges 811 files 411 documented · 19%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

ADV.JS

ADV.JS CI

FE(Front-End of Future?) AVG Engine

面向未来与前端的 ADV 文字冒险游戏引擎。

🧪 Working in Progress

像写小说一样制作 ADV,愿能在未来的冒险中,与你相遇。 进度(咕咕咕)一览

Usage

# todo
pnpm create adv your-adv
cd your-adv
adv your.adv.md
# dev your game

docs | 文档

GitHub deployments

MonoRepo

目前使用 monorepo 的方式进行管理。

计划的施工模块。

advjs 核心模块

  • 状态:开发中
  • 包括默认的 UI 样式与解析文本生成演出内容
  • Todo: 划分 @advjs/theme-default@advjs/core

create-adv 脚手架

  • 状态:Todo
  • 目标:生成基础的 ADV 项目脚手架

@advjs/editor | 編輯器

@advjs/vrm VRM 模型在线编辑器

Netlify Status

@advjs/parser | 剧本解析器

GitHub deployments

  • 状态:开发中
  • 目标:使用 markdown 及扩展语法进行脚本的编写。语法树基于 unifiedremark实现。
  • 预览:https://parser.advjs.org
  • 编辑 Markdown 并在线预览解析的语法树

@advjs/vscode VSCode 插件

  • 状态:Todo
  • 目标:实现 VS Code 中对 .adv.md 文件的语法高亮与提示。

FAQ

为什么我打开示例,却一片空白!

因为 ADV 和广告(advertisement)的缩写很像,而本站点开发的类名都在 adv 命名空间下,所以页面会被 AdBlock 之类的广告屏蔽插件给屏蔽掉。

快关闭本页面的广告拦截以正常显示本页面吧!

等待

Thanks

Extension points exported contracts — how you extend this code

IFileSystem (Interface)
(no doc) [3 implementers]
apps/studio/src/utils/fs/types.ts
Window (Interface)
(no doc)
packages/shims.d.ts
Window (Interface)
(no doc)
packages/client/shims.d.ts
AdvFeatureFlags (Interface)
(no doc)
packages/types/src/types.ts
Options (Interface)
(no doc)
packages/advjs/node/markdown/types.ts
SceneValidationResult (Interface)
(no doc)
packages/parser/src/scene.ts
BranchNode (Interface)
(no doc)
packages/core/src/engine/branches.ts
AdvAIChapter (Interface)
(no doc)
packages/ai/src/types/config.ts

Core symbols most depended-on inside this repo

t
called by 291
packages/advjs/node/cli/i18n/index.ts
get
called by 163
packages/core/src/engine/session.ts
parse
called by 50
packages/parser/src/Serialize.ts
delete
called by 37
packages/core/src/engine/session.ts
parseCharacterMd
called by 36
packages/parser/src/character.ts
text
called by 33
packages/parser/src/Serialize.ts
pushAttributeLine
called by 31
packages/parser/src/character.ts
line
called by 27
apps/studio/src/utils/promptBuilder.ts

Shape

Function 1,461
Interface 472
Method 155
Class 48
Enum 1

Languages

TypeScript100%

Modules by API surface

packages/types/src/ast/md.ts41 symbols
packages/types/src/ast/index.ts30 symbols
apps/studio/src/stores/useGroupChatStore.ts29 symbols
packages/core/src/engine/runtime.ts27 symbols
apps/studio/src/utils/db.ts26 symbols
apps/studio/src/stores/useCharacterChatStore.ts26 symbols
apps/studio/src/utils/y-cloudbase.ts25 symbols
apps/studio/src/utils/projectGenerator.ts25 symbols
apps/studio/src/utils/fs/MemoryFsAdapter.ts25 symbols
apps/studio/src/utils/projectGenerator/schemas.ts24 symbols
packages/core/src/engine/branches.ts23 symbols
apps/studio/src/utils/sourceParser.ts22 symbols

For agents

$ claude mcp add advjs \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact