Digital Twins Minecraft Mod

MVP Implementation - Text-based Twin Interaction

This mod allows you to spawn and interact with digital twins from your web app directly in Minecraft.

Requirements

• Minecraft 1.20.1
• Fabric Loader 0.15.0+
• Fabric API 0.92.0+
• Fabric Language Kotlin 1.10.0+

Installation

1. Install Fabric Loader for Minecraft 1.20.1
2. Download required mods:
   • Fabric API
   • Fabric Language Kotlin
3. Place the Digital Twins mod JAR in your .minecraft/mods folder
4. Launch Minecraft

Commands

/twinimport <url-or-path>

Import a digital twin from the web app.

Examples:

/twinimport https://yourapp.com/api/minecraft/export/user-id-here
/twinimport /path/to/twin-data.json

/twinlist

List all imported twins.

/twinspawn <name>

Spawn a twin NPC in the world.

Example:

/twinspawn Alex

/twin <name> <message>

Send a message to a spawned twin.

Example:

/twin Alex Hey, what's your favorite food?

The twin will respond based on their personality from the web app!

/twinremove <name>

Despawn a twin NPC.

How It Works

1. Twin data is imported from your web app
2. When you spawn a twin, an armor stand NPC appears
3. When you send a message, the mod:
   • Sends your message to the web app API
   • Gets a response generated by Claude AI
   • Displays the response in chat
4. Response time: 3-5 seconds (API processing)

Building from Source

./gradlew build

The JAR will be in build/libs/

Technical Details

• Uses OkHttp for HTTP requests
• Stores twin data in .minecraft/config/digitaltwins/twins.json
• NPCs are armor stands with custom name tags
• Text-only for MVP (voice support coming later)

Troubleshooting

"Twin not found": Run /twinimport first "Connection failed": Check your internet connection "Timeout": API is slow, try again

License

MIT License - See main repository