t1k:cocos:playable:editor-tools
| Field | Value |
|---|---|
| Module | playable |
| Version | 0.5.6 |
| Effort | high |
| Tools | — |
Keywords: ads, cocos, ConfigWatcher, editor tools, extension, parameter JSON, playable
How to invoke
Section titled “How to invoke”/t1k:cocos:playable:editor-toolsEditor Tools — ConfigWatcher & Package Manager Extension
Section titled “Editor Tools — ConfigWatcher & Package Manager Extension”Two distinct editor tools: ConfigWatcher (auto-generates dashboard JSON) and package-manager extension (CPM registry UI). Also includes Cocos MCP Server (23 action tools for AI-assisted editor control). See also: t1k-cocos-playable-parameter (PlayableConfig that ConfigWatcher reads), t1k-cocos-playable-sdk-core.
Quick Reference
Section titled “Quick Reference”| Tool | File | Purpose |
|---|---|---|
| ConfigWatcher | assets/PlayableParamterTool/json-generate/ConfigWatcher.ts | Auto-generates playable-config.json and parameter-assets.json |
| Package Manager | extensions/package-manager/ | CPM registry UI — install/sync PlayableLabs packages |
| Cocos MCP Server | extensions/cocos-mcp-server/ | 23 MCP tools for AI-assisted editor control |
Details
Section titled “Details”- ConfigWatcher internals, hash detection, file writing, asset tracking
- Package Manager architecture, NpmService, SyncService, auth
- Cocos MCP Server tools: manage_settings, manage_code_analysis, manage_asset
Common Mistakes
Section titled “Common Mistakes”- Editing files in
ParameterToolBuild/— they are overwritten by ConfigWatcher. - Calling
require('fs')in non-editor scripts — crashes at runtime; always guard withif (!EDITOR) return. - Forgetting
@executeInEditMode(true)on a component that needs editor-only behavior. - Package Manager extension source is TypeScript in
source/— compiled output is indist/. Edit source, not dist. SyncServiceusesfs-extra(not nativefs) forensureDir,copy,remove— ensurefs-extrais in the extension’snode_modules.Editor.Message.requestis async — alwaysawaitit inside anasyncfunction.
Gotchas
Section titled “Gotchas”- Editor scripts run in a different process —
cc.directoris undefined — never share runtime singletons across editor/runtime. - Editor menu items are registered once at launch — code changes need an editor restart, not an editor reload.