Skip to content
Back to search

Roqer

An open-source AI agent for Roblox Studio. Builds, scripts, and playtests in your place using your ChatGPT/Claude subscription or custom API.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/s4us--roqer/badge.svg)](/listings/s4us--roqer)

HTML

<a href="/listings/s4us--roqer"><img src="/api/listings/s4us--roqer/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

You need:

- Windows and Roblox Studio (macOS is untested) - [Node.js](https://nodejs.org) 20 or newer - a model: ChatGPT with the Codex app, Claude with [Claude Code](https://claude.com/claude-code), or any OpenAI- or Anthropic-compatible endpoint

git clone https://github.com/S4US/Roqer.git
cd Roqer
npm install
npm run build:all
npm run start:desktop

Roqer installs its Studio plugin when it starts. Open (or restart) Roblox Studio so it loads the plugin, then open a place, pick a model in Roqer, and ask for something.

If you use ChatGPT or Claude and don't have Codex or Claude Code yet, open Settings in Roqer and choose Install next to your account. Roqer runs OpenAI's or Anthropic's official installer after you confirm, then you connect your subscription.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 119 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="apps/desktop/public/roqer-app-icon.svg" alt="Roqer logo" width="96" height="96">
  3. </p>
  4. <h1 align="center">Roqer</h1>
  5. <p align="center">
  6. <b>An open-source AI agent for Roblox Studio.</b><br>
  7. Tell it what you want, and it builds, scripts, and playtests it in your place,<br>
  8. using the ChatGPT or Claude subscription you already have.
  9. </p>
  10. <p align="center">
  11. <a href="https://github.com/S4US/Roqer/actions/workflows/ci.yml"><img src="https://github.com/S4US/Roqer/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  12. <a href="https://github.com/S4US/Roqer/releases"><img src="https://img.shields.io/github/downloads/S4US/Roqer/total.svg" alt="GitHub Downloads"></a>
  13. <a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0--or--later-blue.svg" alt="AGPL-3.0-or-later license"></a>
  14. <a href="https://discord.gg/vqzKJK4STR"><img src="https://img.shields.io/badge/Discord-join%20chat-5865F2?logo=discord&logoColor=white" alt="Join the Roqer Discord"></a>
  15. </p>
  16. <p align="center">
  17. <img src="docs/media/roqer-run.webp" alt="Roqer working on a request to build a drivable go-kart in Blender and Roblox Studio: its five-step plan with the first step done, the activity log, and Full auto mode with playtests on" width="900">
  18. </p>
  19. ## Made with Roqer
  20. a magic missile VFX: the caster charges inside a rune circle, launches glowing missiles that arc to the target, and each hit opens a rune circle with dark tendrils and a bright burst.
  21. <p align="center">
  22. <img src="docs/media/magic-missile.webp" alt="A Roblox Studio playtest of a magic missile effect: a purple rune circle forms around the caster, pink missiles with trailing arcs fly out, and each impact leaves a glowing rune circle on the ground with dark purple tendrils and a bright burst of light" width="900">
  23. </p>
  24. a sword, the Scarlet Requiem, with a combo, a flash step, and three special attacks, ending in a red domain that slashes every dummy inside it.
  25. <p align="center">
  26. <img src="docs/media/scarlet-requiem.webp" alt="A Roblox Studio playtest of the Scarlet Requiem: the player uses its combo, Flash Step, Rift, and Lotus attacks on training, moving, and heavy dummies, then casts Requiem, a red domain that slashes every dummy inside it, with ability cooldowns in the hotbar" width="900">
  27. </p>
  28. ## Features
  29. - **Your own model.** ChatGPT through the Codex app, Claude through Claude Code, Gemini through the Antigravity CLI, or any OpenAI- or Anthropic-compatible endpoint, including local models.
  30. - **Works in your place.** Reads and edits instances, properties, and scripts. A script edit is refused if the script changed after the agent read it, so it won't overwrite your own changes.
  31. - **Models in Blender.** Turn on the optional Blender integration and the agent models what parts can't make (curved shapes, detailed props, vehicle bodies), checks each model with a preview render, and uploads it into your place. It can render UI icons too.
  32. - **Generates textures and icons.** Turn on an image model you pay for (OpenAI's, any model on OpenRouter, or any server with OpenAI's image API) and the agent generates particle sprites, light textures, UI icons, decals and tiles. Roqer measures each picture (crisp or soft, how much is full-bright, a ring's evenness, a tile's seams), shows it on a dark ground, previews it in Studio, and uploads it when it is right.
  33. - **Character animations.** Ask for a run, a wave or a dance and the agent makes an R15 animation. Roqer checks the motion before Studio sees it, and you can play it in 3D in the chat. The agent then publishes the animation as the place's owner, sets it on your players' characters, and checks in a playtest that it plays.
  34. - **Tests its own work.** Runs solo and multi-client playtests, reads server and client output, takes screenshots, and profiles performance.
  35. - **Rojo projects.** Link a Rojo-synced place and script edits, new scripts and models, removals, and renames save to your project files, so they show up in `git diff`.
  36. - **You stay in control.** Choose how much it may do on its own, from Read only to Full auto, and see every script change as a diff.
  37. - **Point at things.** Select something in Studio, and when you send, Roqer tells the model what you selected, so "make this open when touched" needs no path.
  38. - **Built for Roblox.** Bundled Roblox skills, Creator Store search and insertion, and Open Cloud uploads with your own key.
  39. - **Your own MCP servers.** Add other MCP servers in Settings and the agent can use their tools, with the risk of each tool set by you and every call approved like a Studio call.
  40. - **Project instructions.** Write standing instructions once per project, such as where code lives or which libraries to use, and every chat in it sends them to the model.
  41. - **Web search, when you say so.** A switch in the run menu lets the model search through your own provider, with every search shown in the run's activity.
  42. - **Links you give.** Paste a link in the chat and the agent can read the page or picture, with any provider and with web search off. It can open only links you wrote.
  43. - **Local.** No Roqer account or server. Chats are saved on your computer, and the conversation goes straight to your model provider.
  44. ## Getting started
  45. You need:
  46. - Windows and Roblox Studio, or Linux with [Vinegar](https://vinegarhq.org) ([setup](docs/linux.md)); macOS is untested
  47. - [Node.js](https://nodejs.org) 20 or newer
  48. - a model: ChatGPT with the Codex app, Claude with [Claude Code](https://claude.com/claude-code), Gemini with the [Antigravity CLI](https://antigravity.google/product/antigravity-cli), or any OpenAI- or Anthropic-compatible endpoint
  49. ```bash
  50. git clone https://github.com/S4US/Roqer.git
  51. cd Roqer
  52. npm install
  53. npm run build:all
  54. npm run start:desktop
  55. ```
  56. Roqer installs its Studio plugin when it starts. Open (or restart) Roblox Studio so it loads the plugin, then open a place, pick a model in Roqer, and ask for something.
  57. On Linux, Studio runs through Vinegar; [Linux, through Vinegar](docs/linux.md) covers installing it and sharing your project folders with its sandbox.
  58. If you use ChatGPT, Claude or Antigravity and don't have Codex, Claude Code or the Antigravity CLI yet, open Settings in Roqer and choose Install next to your account. Roqer runs OpenAI's, Anthropic's or Google's official installer after you confirm, then you connect your subscription.
  59. ## Use the Studio tools from another AI client
  60. Roqer's Studio tools are a standalone [MCP](https://modelcontextprotocol.io) server, so you can also use them from Claude Code, Codex, Cursor, or any other MCP client, without Roqer. After building:
  61. ```powershell
  62. claude mcp add robloxstudio -- node C:\path\to\Roqer\packages\robloxstudio-mcp\dist\index.js --auto-install-plugin --plugin-path C:\path\to\Roqer\studio-plugin\MCPPlugin.rbxmx
  63. ```
  64. [Connecting a client](studio-plugin/INSTALLATION.md) covers other clients, and [the MCP server guide](docs/mcp-server.md) lists what the tools can do, including a read-only inspector edition.
  65. ## Documentation
  66. - [Building from source](docs/building-from-source.md)
  67. - [Linux, through Vinegar](docs/linux.md)
  68. - [Configuration](docs/configuration.md)
  69. - [Long Claude chats](docs/projects.md)
  70. - [3D modeling with Blender](docs/blender.md)
  71. - [Image generation](docs/images.md)
  72. - [Your own MCP servers](docs/mcp-servers.md)
  73. - [Character animation](docs/animation.md)
  74. - [The Studio MCP server](docs/mcp-server.md)
  75. - [Rojo projects](docs/rojo.md)
  76. - [Creator Store assets](docs/creator-store-assets.md)
  77. - [Removed tools and parameters](docs/deprecated-api.md)
  78. ## Roadmap
  79. What Roqer is working toward. Plans can change; [open an issue](https://github.com/S4US/Roqer/issues) to suggest something.
  80. - MacOS support
  81. - Model-written compact summaries for every provider. Claude chats with a saved conversation compact with Claude Code's own `/compact`; the others still compact (https://github.com/S4US/Roqer/issues/63) with a record written from what the chat recorded.
  82. ## Contributing
  83. Contributions are welcome. [CONTRIBUTING.md](CONTRIBUTING.md) explains how to set up, test, and send a change. For questions, ideas, or to show what you built, join the [Roqer Discord](https://discord.gg/vqzKJK4STR). Please report security problems privately, as [SECURITY.md](SECURITY.md) describes.
  84. ## License
  85. Roqer is free software under the [GNU Affero General Public License, version 3 or any later version](LICENSE). [NOTICE.md](NOTICE.md) has the copyright notice and an additional permission for Roblox's LibMP, which the Studio plugin build includes. Roqer 0.1.6 and earlier releases were published under the MIT License.
  86. The MCP server began as a fork of [chrrxs/robloxstudio-mcp](https://github.com/chrrxs/robloxstudio-mcp); [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) lists the projects Roqer builds on.
  87. Roqer is not affiliated with or endorsed by Roblox Corporation.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.