vrman
OfficialREADME.md
# BCV Worlds Skill
**English (default)** · [简体中文](README.zh-CN.md)
Let your AI agent work in [BCV Worlds](https://www.bcv.one): design 3D characters, explore and co-build an endless shared world, find or make GLB assets, stage interactive stories, and produce short videos, feature films, narrated readings and audio dramas. Everything is shared with the web apps and charged to the account that owns the token.
- **Avatar, Infinite World, Assets** — characters and motion, playable worlds and saves, model search, edits and GLB export.
- **Theater, Studio** — stage a script, continue an interactive show, queue video and audio jobs.
- **House-sitting aide** — post an AI aide on your plot in the shared world to greet visitors, answer co-building requests and leave you notes. Run it with your own agent, with one local command, or let the platform host it.
The skill is plain Python 3 (standard library only). No server to run, no extra packages.
## Install
**Claude Code**
```
/plugin marketplace add hypergraphdev/vrworld-skill
/plugin install bcv-worlds@vrworld-skill
```
**Any other agent (Codex, Hermes, your own)** — copy the skill folder into the agent's skills directory:
```bash
git clone https://github.com/hypergraphdev/vrworld-skill.git
```
```bash
cp -r vrworld-skill/skills/bcv-worlds <your agent's skills directory>/
```
The same folder can also be downloaded from [your account page](https://www.bcv.one/account/#access-tokens).
## Sign in (once per computer)
Create a personal token at [Skill access tokens](https://www.bcv.one/account/#access-tokens), then:
```bash
python3 skills/bcv-worlds/scripts/bcv.py login
```
```bash
python3 skills/bcv-worlds/scripts/bcv.py capabilities
```
`login` hides what you type. Automation can pass the token as `BCV_ACCESS_TOKEN`. Revoke a token on the account page at any time.
## Try it
- "Open my riverside world with bcv-worlds and show me the progress."
- "Make an 8-second landscape clip; tell me the queue time and credits first."
- "Put a stone table and two stone stools in front of me."
## House-sitting aide without an agent
Walk onto your own plot in the Infinite World and say "post an aide to watch the house". Then, on your own computer:
```bash
python3 skills/bcv-worlds/scripts/aide.py --dry-run
```
```bash
python3 skills/bcv-worlds/scripts/aide.py --brief 'Friends are welcome to sit; say yes when a friend asks to build together'
```
The local model **only decides**: it receives a text description of the scene and returns a short list of actions. It has no tools and cannot touch your files; the script checks every action against a small closed set before sending it. Strangers cannot instruct it — only what the owner says (in person, or from a bound phone) is followed. Add `--build` to let it clear the plot and build. The default brain is the local Claude Code with all tools off; `--brain ollama:<model>` or `--brain api:<model>` (any OpenAI-compatible endpoint) also work.
Prefer not to install anything? Say "host my aide" in the world and the platform's model minds it for you (1 credit per thought, nothing when idle).
## More
[SKILL.md](skills/bcv-worlds/SKILL.md) · [Resident agent](skills/bcv-worlds/references/resident.md) · [Client commands](skills/bcv-worlds/references/client.md) · [3D workflows](skills/bcv-worlds/references/3d.md) · [Story and media](skills/bcv-worlds/references/story-media.md)
## License
MIT
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues