Skip to content
nkanf-devPublic

About

OpenAllay is a modern Minecraft Agent built for modpacks. Ask naturally: it can understand the task, explore the game data available in your current instance, work through several steps, and turn the result into a useful in-game answer.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

1,411 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenAllay

简体中文

Your AI companion for exploring modpacks, finding answers, and building in Minecraft.

Ask in plain language. OpenAllay uses the game data available in your instance to work through the task and bring useful answers back into the game.

OpenAllay — your AI companion in Minecraft. Explore, build, and create.

Download on GitHub · Quick start · 0.4.4 release notes · Community · Mature Forge backport verification · Stock Forge integrated-client validation

Make it part of your game
Explore Find recipes, compare gear, check ingredients, and understand your modpack.
Build Shape terrain, create structures, and reuse templates in your single-player world.
Skills Add workflows and knowledge for the way you play.
Extensions Connect more mods, game data, actions, and native result views.

Quick start

OpenAllay 0.4.4 supports 27 Minecraft versions: Forge on 1.12.2, 1.16.5, 1.18.2, and 1.19.2, plus Fabric and NeoForge on 1.20.1 through 26.3. Choose the file for your exact Minecraft version and loader from GitHub Releases. Fabric also needs the matching Fabric API.

Minecraft version Java version Installation
1.12.2 8 Forge 14.23.5.2864 JAR; install in mods
1.16.5 17 Forge 36.2.42 JAR; install in mods
1.18.2, 1.19.2 and 1.20.1–1.20.4 17 Matching loader JAR
1.20.5–1.20.6 and 1.21–1.21.11 21 Matching loader JAR
26.1, 26.1.1, 26.1.2, 26.2, 26.3 25 Matching loader JAR

The 0.4.4 download catalog contains 35 JARs for Minecraft 1.12.2 through 26.3, covering 50 version/loader pairs. Both GitHub and Modrinth use these same JAR families. GitHub also includes SHA256SUMS, for 36 release assets in total. Some JARs cover several versions. See the release compatibility table and Forge runtime setup. Minecraft 26.2 / Java 25 remains the development mainline. For Minecraft 1.12.2, install Forge 14.23.5.2864, select Java 8, and put openallay-forge-1.12.2-0.4.4.jar in mods. Minecraft Builder is included.

  1. Put the matching JAR in your instance's mods folder and start Minecraft.
  2. Enter a world and press K, or run /guide.
  3. Select the gear button, open Models, and add a model profile.
  4. Choose OpenAI-compatible Chat Completions or Anthropic Messages. Enter your provider URL, model ID, and API key.
  5. Review the context window and maximum output. Matching models fill these in automatically; enter them yourself if the provider or catalog has no values.
  6. Save, select the profile in the conversation header, and ask your first question.

Try: “How do I make this item, and do I have the ingredients?”

For Minecraft 26.2 Fabric modpacks with Architectury, use 21.0.4 for working text input. Versions 21.0.2 and earlier prevent text input in the OpenAllay screen. Architectury is not required.

Explore your modpack

Spend less time switching between wikis, recipe screens, and guide books. OpenAllay can connect recipes, items, inventory, installed mods, settings, and nearby game observations in one conversation. It can compare a whole collection at once rather than looking up one item per model turn.

  • “Which sword in this modpack has the highest base damage?”
  • “Compare the foods from Farmer's Delight by nutrition.”
  • “How do I make apple cider? Do I have enough ingredients?”
  • “Search my installed guide books for magical crops.”
  • “Which resource packs are active, and what are my current video settings?”

Answers can include item icons, ingredient slots, recipe layouts, tables, and expandable details. Tool cards show a compact summary of each operation. Open a card's details to inspect complete results when datasets are large.

Optional integrations include JEI, REI, Patchouli, and recipe-rich mods such as Farmer's Delight. The available data depends on your installed mods and their integrations; none of these mods is required to use OpenAllay.

Build in your world

The Minecraft Builder Extension comes with each OpenAllay download. Describe what you want to build, then use geometry, terrain tools, available building presets, and saved templates in your active single-player world. Templates support rotation and mirroring. Block undo preserves later edits and reports conflicts.

  1. Open a single-player world and select a client-configured model profile.
  2. In Settings → Extensions, enable Minecraft Builder.
  3. Ask for a build, for example: “Build a small stone tower beside me.”

Enabling Builder includes its building operations in ordinary JavaScript mode. The Enable full-access JavaScript switch can stay off. Builder works in survival and creative single-player worlds. Undo restores matching recorded block changes.

Preset availability follows the game's native materials:

Minecraft Available building workflows
1.12.2 Geometry, terrain, templates, cancellation, and undo with native block-state readback
1.16.5 Geometry, decoration, terrain, templates, house, cottage, windmill, farm, and dock

On 1.16.5, choose one of the five presets listed above; the skyscraper preset requires a lightning rod.

Builder is developed independently in OpenAllay Extensions.

Create your own Skills

Teach OpenAllay how you play. Skills are reusable instructions and reference material for a mod, a task, or a play style. OpenAllay loads relevant guidance when it needs it.

Bundled Skills cover recipes, machines, guide books, progression, and game diagnosis. In Settings → Skills → Community, refresh the catalog and browse packages compatible with your Minecraft version. Install or update a workflow, or import a local Skill package. You can write and share your own modpack guides and workflows through OpenAllay Skills.

Add Extensions

Extensions connect new game data, reusable JavaScript modules, mod integrations, actions, and native result views. Open Settings → Extensions to see what is connected, browse compatible community packages, or import a local Extension JAR. Universal Extension JARs install under config/openallay/extensions/. Legacy loader-mod Extensions use mods/. Restart Minecraft after installation.

Want to connect your own mod? Start with the examples and authoring guide in OpenAllay Extensions.

Inside Minecraft

Fullscreen conversation Native recipe details
OpenAllay 0.4.0 conversation screen OpenAllay 0.4.0 tool details and native recipe
Gameplay HUD Full HUD reader
OpenAllay 0.4.0 gameplay HUD OpenAllay 0.4.0 HUD reader

Captured from OpenAllay 0.4.0 in an isolated demonstration world. The example conversation uses a local deterministic demo endpoint.

Keep separate conversations for different projects, return to saved history, copy answers, or export a session. The screen does not pause the game.

  • Enter sends; Shift+Enter adds a line.

  • Stop cancels the request; Retry starts it again.

  • Escape closes the screen without stopping the answer.

  • Branch sessions (Fork): create an independent conversation from a completed task without re-running Tools.

  • Follow-up & Steer: choose Follow-up to run after the current task releases its resources, or Steer to add guidance at the next operation boundary. Steer does not interrupt a model call.

  • World observation: the Agent can read live focus and request world or game-UI images as needed. Image requests need an image-capable model. Open tool details to inspect the actual capture.

  • Input references: focus and associated frames support your question. Refresh or remove them, or attach a current world frame. These references save the frame and focus at the time of your input; refresh them when you need the latest state.

  • Image inputs: paste images with Ctrl/Cmd+V when using an image-capable model.

  • Manual compaction: when the conversation is idle, enter /compact to summarize older context with your client-configured model. Server models do not support this command yet. Use // to send a literal /.

  • Open tool details to inspect results. Debug mode also shows the submitted JavaScript and full input/output.

  • HUD and appearance: enable the gameplay HUD in Settings → UI. Press F8 by default to open its reader; existing custom key bindings stay unchanged. Adjust HUD placement, text size, density, and theme to suit your screen.

  • Push-to-talk: enable and configure Settings → Voice, then bind its key in Minecraft Controls. Native recognition needs a downloaded or imported model; an HTTP transcription backend is also available. Gameplay/HUD speech defaults to Send, with Draft available. Fullscreen dictation stays editable before sending.

Appearance settings Voice settings
OpenAllay 0.4.0 appearance settings OpenAllay 0.4.0 voice settings
General settings About OpenAllay
OpenAllay 0.4.0 general settings OpenAllay 0.4.0 About screen

Choose your model

Use a compatible hosted service or local endpoint. Save several profiles and switch between them in the conversation. A client-configured profile can use a remote provider or a model running on your computer.

In Settings → Models:

  • Context window and maximum output: use matched provider metadata or the built-in model catalog, or enter your own values. Clear a field to return to automatic values.
  • Reasoning effort: leave Auto · provider default selected, or request an explicit effort (supported levels depend on the selected model and provider).
  • Reference prices: compare published reference token rates and pricing tiers. Your provider's actual billing may vary.

The chat footer shows the context estimate and budget, cumulative session cost, and cache hit rate when available. Session totals include actual model and automatic summary calls, including restored request history. Use the estimate to track session costs; your provider supplies the final bill. Missing usage or pricing stays unknown or partial. Provider rates and unreported extra charges can change the amount you pay.

OpenAllay is free and open source. Model providers may charge for API use.

Single-player and multiplayer

Setup What to expect
Single-player Explore your instance and build with Minecraft Builder enabled.
Ordinary multiplayer server Install OpenAllay on your client only. Ask about the game data visible to your client; the server does not need OpenAllay. Builder world edits are not available here.
Server with OpenAllay The server may offer a shared model and additional server-side capabilities. Shared models appear automatically in Models, separately from your own profiles.

Optional experimental game commands can be enabled in Settings → Extensions. They use your normal Minecraft identity and command permissions, including available mod commands. Full-access JavaScript includes commands and enabled Extension operations. Minecraft server rules and permissions still apply.

Community and development

  • OpenAllay Skills — share workflows, modpack knowledge, and reference material.
  • OpenAllay Extensions — build integrations and new capabilities.
  • Issues — report a bug or suggest an improvement. Include your Minecraft version, loader, and steps to reproduce.
  • Development guide — build from source, contribute, and explore architecture and development guidelines.

OpenAllay is licensed under the MIT License. It is an independent project, not affiliated with or endorsed by Mojang Studios or Microsoft.

About

OpenAllay is a modern Minecraft Agent built for modpacks. Ask naturally: it can understand the task, explore the game data available in your current instance, work through several steps, and turn the result into a useful in-game answer.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages