Redstone is an AI agent system based on Opencode that automates and simplifies the entire Minecraft plugin development process.
Minecraft plugin development is a complex task that involves understanding complex APIs, build configurations, dependency management, and numerous library documentation. Redstone solves these complexities with an AI-based specialized agent system.
npm install -g opencode-redstone
redstoneImportant
Before installing Redstone, make sure Opencode is installed!
Once the Redstone installer is launched, select “Install Redstone” and choose one of the following options.
- Some subordinate agents1 use Opencode’s default free model, while the Orchestrator and agents that inherit the model from the Orchestrator2 can be configured by the user.
- This mode provides results of reasonable quality with efficient token usage. However, some prompts may be used for model training purposes.
- This mode uses closed models such as GPT or Claude for subordinate agents, making it best suited for tasks that require a high level of reliability, including consistency and stability.
- The Orchestrator model and agents that inherit the model from the Orchestrator can still be selected by the user. However, it is recommended to use models from the same provider whenever possible.
- Choose from:
- Codex: Uses OpenAI's Codex models
- Claude: Uses Anthropic's Claude models
- You can specify individual model IDs for each agent
- Use when custom models or fine-grained control is needed
Suggested Models
Orchestrator » (Skip)
Document » (Skip)
Planner » (Skip)
Project Initialization » opencode/grok-code || openai/gpt-5.1-codex-mini
Explore » openai/gpt-5.1-codex-mini
API Search » openai/gpt-5.2-codex
It is recommended to skip the orchestrator, planner, and documentation models during the setup phase. However, internal testing has confirmed that Anthropic's Claude models3 demonstrate the most outstanding performance.
While using the same model provider is generally recommended, it can lead to rapid token consumption. If multiple model providers are available, we recommend using different providers for subordinate agents as shown in Suggested Models. Internal testing has confirmed that OpenAI's Codex model series is optimized for exploration and search tasks.
Tip
While open source models also deliver impressive results, the quality achieved with proprietary models is undeniably compelling.
Redstone consists of the following specialized agents:
| Agent | Role |
|---|---|
| Redstone-Orchestrator | Planning and main plugin development agent |
| Redstone-Document | Project documentation creation and updates |
| Redstone-Planner | Creates and maintains implementation plans |
| Redstone-ProjectInitialization | Plugin project creation and initialization |
| Redstone-Explore | Codebase exploration and feature discovery |
| Redstone-APISearch | API documentation and dependency research |
Thank you for contributing to Redstone! For contribution guidelines and branch naming conventions, please refer to CONTRIBUTING.md.
This project is distributed under the MIT License. See the LICENSE file for more details.
Footnotes
-
The ProjectInitialization, Explore, and APISearch agents use separate models that are different from the orchestrator. ↩
-
The Document and Planner agents inherit their model from the Orchestrator. ↩
-
Among Claude models, most tasks can be successfully completed with Sonnet 4.5. However, if you need to work with larger codebases and require deeper understanding, consider using Opus 4.5. Since this model has higher usage costs, it is recommended to alternate between Sonnet 4.5 and Opus 4.5. ↩