opencode-redstone

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.

🇺🇸 English | 🇰🇷 한국어 | 🇯🇵 日本語

Getting Started

npm install -g opencode-redstone
redstone

[!IMPORTANT] Before installing Redstone, make sure Opencode is installed!

[!IMPORTANT] For plugin development, you must have:

• JDK version matching your target Minecraft version installed
• Gradle for building the project

[!IMPORTANT] If you choose Kotlin as your development language, you must also have:

• Kotlin installed (the Kotlin Gradle plugin will handle compilation, but a working Kotlin installation is required)

Once the Redstone installer is launched, select “Install Redstone” and choose one of the following options.

1. Balanced Mode

• Some subordinate agents¹ use Opencode’s default free model, while the Orchestrator and agents that inherit the model from the Orchestrator² 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.

2. Professional Mode

• 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

3. Manual Mode

• 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 » openai/gpt-5.4-mini
Explore » openai/gpt-5.4-mini
API Search » openai/gpt-5.4

It is recommended to skip the orchestrator, planner, and documentation models during the setup phase. However, internal testing has confirmed that Anthropic's Claude models³ 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.

Agent Architecture

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

[!TIP] Do not push the model to complete the entire plugin in a single pass. Implement features step by step for the most stable process and best outcomes.

Contributing

Thank you for contributing to Redstone! For contribution guidelines and branch naming conventions, please refer to CONTRIBUTING.md.

License

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.6. However, if you need to work with larger codebases and require deeper understanding, consider using Opus 4.6. Since this model has higher usage costs, it is recommended to alternate between Sonnet 4.6 and Opus 4.6. ↩