Mikasa Bridge

Mikasa Bridge

Bringing Mikasa to life in Minecraft with ChatGPT.

IMPORTANT: THIS MOD REQUIRES AN ACTIVE CHATGPT PLUS OR PRO SUBSCRIPTION AND THE SEPARATE MIKASA BRIDGE WINDOWS APPLICATION (DOWNLOAD HERE) TO FUNCTION.

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

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.

How to Talk to Mikasa

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

Features

● AI-powered conversations

● Character personality and persistent memory

● Environmental awareness

● In-game interactions and behaviors

● 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

● An eligible ChatGPT Plus or Pro subscription

● The separate Mikasa Bridge companion application (Windows)

How It Works

Mikasa Bridge connects Minecraft to ChatGPT through a separate Windows application, allowing ChatGPT to act as Mikasa's AI-powered mind.

ChatGPT handles conversations, complex reasoning, and decision-making, while Minecraft provides information about the environment and executes Mikasa's actions.

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

The separate Windows companion keeps ChatGPT and Minecraft connected and must remain running for AI-powered features to work.

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. Download the Mikasa Bridge, Fabric API and GeckoLib mod JAR from CurseForge and place it in your Minecraft mods folder.

2. Visit the official Mikasa Bridge GitHub repository.

3. Open the Releases section and download the Windows companion ZIP.

4. Extract the ZIP into a separate folder.

5. Start the companion application using the included Windows launcher.

6. Follow the Sign in with ChatGPT authorization process.

7. Launch Minecraft with Mikasa Bridge installed.

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, or features that need additional work.

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 permission and must be downloaded independently.

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, or Fish Audio.

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