mudlet-ai-client/README.md

MUDlet AI Client

Un client MUD moderno con integrazione LLM per automazione del gameplay, sviluppato con Electron + React + TypeScript.

Features

Core

• Connessione Telnet - Supporto completo per protocollo Telnet con parsing ANSI colors
• Game Window - Display in tempo reale con input commands
• Connection Panel - Gestione connessioni con host/porta configurabili

Autoplayer LLM

• Ollama Integration - Connessione a server Ollama remoto (ollama.solarpi.net)
• Decision Engine - Sistema AI che analizza l'output del gioco e genera comandi
• System Prompt - Personalizzazione del comportamento del bot
• Model Selection - Supporto per modelli multipli (llama3.2, mistral, etc.)
• Action Queue - Coda azioni per revisione manuale o auto-send

UI/UX

• React + TypeScript - Codice type-safe con React 18
• Tailwind CSS - Styling moderno e responsive
• Navigation - Pannelli Connection/Game/Autoplayer

Quick Start

# Clona e installa dipendenze
cd mudlet-ai-client
npm install

# Avvia dev server (necessario per Electron)
npm run dev

# Avvia Electron (in terminale separato)
npm start

Connessione

Server LPMUD preconfigurato:

• Host: 172.24.19.225
• Porta: 6666

Server Ollama:

• URL: http://ollama.solarpi.net

Stack Tecnologico

Layer	Tecnologie
Framework	Electron 28, React 18, TypeScript 5
UI	Tailwind CSS, shadcn/ui
Telnet	telnet-client, ansicolor
LLM	Ollama (HTTP API)
Build	Vite 5, electron-vite

Struttura Progetto

mudlet-ai-client/
├── src/
│   ├── main/                    # Electron main process
│   │   ├── index.ts             # App entry point, IPC handlers
│   │   └── services/
│   │       ├── TelnetService.ts # Connessione Telnet
│   │       ├── OllamaService.ts # Client HTTP Ollama
│   │       └── AutoplayerService.ts # Decision engine
│   ├── renderer/                # React UI
│   │   ├── App.tsx              # Root component
│   │   ├── main.tsx             # Entry point
│   │   └── components/
│   │       ├── GameWindow.tsx   # Game display + input
│   │       ├── ConnectionPanel.tsx
│   │       └── AutoplayerPanel.tsx
│   └── preload/
│       └── index.js             # Context bridge
├── package.json
├── vite.config.ts
└── tsconfig.json

Workflow Autoplayer

1. OBSERVE  → TelnetService riceve output
2. PARSE    → AutoplayerService analizza stato
3. THINK    → Ollama genera decisione
4. ACT      → Azione eseguita o messa in coda

Roadmap

• Fase 1: Client MUD Base
• Fase 2: Integrazione Ollama
• Fase 3: Autoplayer miglioramenti (mapper 2D, trigger system)
• Fase 4: Sistema Plugin
• Fase 5: Funzionalità avanzate (persistence SQLite)

Documentazione

• Architettura
• Workflow di Sviluppo
• API IPC
• Piano Progetto

License

MIT