Mikasa Bridge

Mikasa Bridge

Bringing Mikasa to life in Minecraft with AI — powered by ChatGPT or Groq.

Mikasa Bridge is my fan-made Minecraft project inspired by Attack on Titan, bringing Mikasa Ackerman into your world as an interactive AI-powered companion.

My goal is to make Mikasa more than just a traditional NPC. I want her to be able to hold conversations, remember previous interactions, understand her surroundings, and interact with the Minecraft world.

The project is still under development, and I'm continuing to improve her behavior, interactions, and abilities.

Available AI Providers

Mikasa Bridge now supports two AI providers: ChatGPT and Groq.

Players can choose which provider powers Mikasa's intelligence. Both use the same character systems, memory, and in-game capabilities.

ChatGPT — Paid (Recommended)

Requires an eligible ChatGPT Plus or Pro subscription.

ChatGPT is the recommended option for the most reliable experience with Mikasa Bridge.

Advantages:

• Recommended for more consistent AI interactions.

• Better suited to the project's current complex conversations and structured actions.

• Generally more generous usage availability than Groq's free tier, subject to the applicable plan limits.

Disadvantages:

• Requires a paid ChatGPT subscription.

• Response times may vary depending on the model and service.

Groq — Free Alternative

No ChatGPT Plus or Pro subscription required.

Groq allows players to use Mikasa Bridge with their own Groq account and API key, using its available free tier.

Advantages:

• Free-tier access.

Disadvantages:

• Stricter usage and token limits.

• Some requests may encounter token-limit or structured-response errors.

• The integration is still being improved.

Recommendation: ChatGPT Plus or Pro is currently recommended for a more reliable experience, but Groq is a great alternative for players who want to try Mikasa Bridge without a paid ChatGPT subscription.

How to Talk to Mikasa

To talk to Mikasa, stand in front of her and press R.

Features

• AI-powered conversations with ChatGPT or Groq

• Character personality and persistent memory

• Environmental awareness

• Context-aware autonomy and initiative

• In-game interactions and behaviors

• Procedural movements and gestures

• Item interactions, including picking up and handing over objects

• Custom animations and gameplay mechanics

• Multilingual support

• Optional voice interaction

Some features are experimental and may not always work as expected.

Requirements

• Java 21

• Fabric API 0.116.17 or a newer compatible version

• GeckoLib 4.9.3 or a newer compatible version

• Windows (required for the current Mikasa Bridge companion application)

Mikasa Bridge Windows is a separate companion application (ESSENTIAL FOR BOTH AI PROVIDERS TO FUNCTION) that can now be installed directly through Minecraft with your permission. Manual installation is also available.

How It Works

Mikasa Bridge connects Minecraft to ChatGPT or Groq through a separate Windows companion application, allowing the selected AI provider to act as Mikasa's mind.

The AI handles conversations, reasoning, and decision-making, while Minecraft provides information about the environment and executes validated actions.

The goal is to combine these systems to create a character capable of reasoning, adapting, remembering, and interacting dynamically with the Minecraft world.

The Windows companion manages the AI connection and must be running for AI-powered features to work.

Automatic Companion Installation

Starting with the latest version, installing Mikasa Bridge is easier.

Minecraft can now help you download, install, and manage the separate Mikasa Bridge Windows application.

When the companion is missing, the mod provides an in-game setup screen.

With your permission, Minecraft can:

• Download the official companion application from GitHub.

• Verify the downloaded files before installation.

• Install the application automatically.

• Launch the companion when needed.

• Check compatibility and offer companion updates.

• Replace outdated managed versions without accumulating unnecessary installations.

• Preserve existing accounts, memories, and settings during updates.

Downloads and installations require your consent.

When enabled, automatic update checks contact GitHub once per Minecraft launch. These checks can be disabled.

The companion application is downloaded separately and is not embedded inside the mod JAR.

Manual Installation

If you prefer, you can still download and install the Windows companion manually.

Visit the official Mikasa Bridge GitHub Releases page to find the available versions.

Optional Features

Microphone (Whisper): Uses local speech recognition so you can speak to Mikasa. No API key is required. A one-time model download is needed.

Mikasa's Voice (Fish Audio): Requires a Fish Audio account and API key to enable voice synthesis.

Both features are optional. You can interact with Mikasa through text without enabling voice services.

Installation

1. Install the Mikasa Bridge mod JAR, Fabric API, and GeckoLib in your Minecraft mods folder.

2. Launch Minecraft.

3. Open the Mikasa Bridge setup screen.

4. Follow the in-game instructions to download and install the Windows companion application, or select an existing installation.

5. Choose your preferred AI provider: ChatGPT or Groq.

6. Sign in with ChatGPT or configure your Groq API key.

7. Start interacting with Mikasa.

The Windows companion is still required, but you no longer need to download and extract it manually when using the integrated installer.

For more details, follow the installation instructions in the README.txt file.

Development Status

EXPECT BUGS — UNDER DEVELOPMENT

Mikasa Bridge is currently under active development.

I've implemented many of the systems I originally wanted, but there's still a lot I plan to improve.

You may encounter bugs, inconsistent AI behavior, unfinished interactions, provider usage limits, or features that need additional work.

The Groq integration is relatively new and may occasionally encounter token-limit or JSON response errors. These issues are being investigated and improved.

IMPORTANT: During certain conversations, Mikasa can reflect on her own capabilities, identify potential limitations, and suggest improvements based on the information available to her. These observations are not always accurate or verified.

If Mikasa suggests a useful improvement, feel free to share it in the comments on this project page. Your feedback can help guide future development.

I'll continue working on the project and improving it over time.

Distribution and Licensing

The original code and assets I've developed remain proprietary unless stated otherwise. Third-party components retain their respective licenses and applicable terms.

Modpack Inclusion: Mikasa Bridge may be included in CurseForge modpacks through the official CurseForge manifest system, provided that the original mod files remain unmodified.

This permission does not authorize modification or separate redistribution of the mod's files.

The separate Mikasa Bridge Windows companion application is not covered by this modpack permission. It can be obtained through the in-game installation system or downloaded manually from the official GitHub repository.

The Windows companion includes Sign in with ChatGPT technology. Clarification regarding certain redistribution conditions is still pending with OpenAI.

Disclaimer

Mikasa Bridge is an unofficial fan-made project inspired by Attack on Titan.

This project is not affiliated with, sponsored by, or endorsed by the rights holders of Attack on Titan, Mojang, Microsoft, OpenAI, Groq, or Fish Audio.

All third-party trademarks and intellectual property remain the property of their respective owners.