ResoLoop 0.1.0-preview.13

English｜日本語

resoloop

resoloop is a CLI for controlling Resonite worlds from AI agents such as Codex and Claude Code.

Tell the AI what you want to create, and it will inspect the current world, describe the Slot and Component structure in files, and apply and verify the result through ResoniteLink. Because the work is stored as files, you can apply the same structure repeatedly and track changes with Git.

resoloop automatically adds FrooxEngine.AI_GeneratedContent to the root of the content it generates and records the running tool's name and version in Source (for example, [resoloop 0.1.0-preview.9]). The same tag is also added to portable and equippable roots within the declaration tree.

Installation

Requirements:

• Windows 10 or 11
• .NET 10 SDK
• Resonite
• An AI coding agent such as Codex or Claude Code

Install resoloop in PowerShell:

dotnet tool install --global ResoLoop --version 0.1.0-preview.13
resoloop --version

If resoloop is already installed, update it with the following command:

dotnet tool update --global ResoLoop --version 0.1.0-preview.13

Usage

1. Create a project

Create a dedicated project for each thing you want to build in Resonite.

resoloop init MyResoniteProject
Set-Location MyResoniteProject

2. Configure ResoniteLink

1. Start Resonite and open the world you want to edit.
2. Open the Settings tab on the Dashboard's Session page.
3. Select Enable ResoniteLink in the lower-left corner.
4. Once ResoniteLink running on port: ... appears, ResoniteLink is ready.

The AI can then use resoloop to find the port and connect automatically.

You can also set the connection yourself using an environment variable, but this is optional.

For example, if the displayed port is 12449:

$env:RESONITE_LINK_URL="ws://localhost:12449"
resoloop doctor

The setup is complete when ready appears at the end.

3. Ask the AI to work on your project

Open the project you created in an AI agent. If you have continued using the same AI session since creating the project, reopen the session once so that the agent can discover the generated Skill.

Then describe what you want to build in Resonite using ordinary language. For example:

Create a teleporter gun in Resonite. Make it an equippable item shaped like a gun. When fired, it should launch a projectile in an arc and teleport me to the point where the projectile lands.

Blender modeling

When you ask for a complex model, resoloop may use Blender.

If Blender is installed on your PC, resoloop detects and uses it automatically.

You do not need to have Blender open.

Learn more

• Detailed documentation — commands, architecture, declaration format, Flux-SDK, and limitations
• Quick start — detailed steps including applying, verifying, and using ProtoFlux
• Declaration format — specification for content/*.json
• Roadmap

License

AGPL-3.0-or-later