████████╗██╗██████╗ ██╗ █████╗ ██╗    ██╗ █████╗ ██╗   ██╗ █████╗ ██╗
╚══██╔══╝██║██╔══██╗██║██╔══██╗██║    ██║██╔══██╗╚██╗ ██╔╝██╔══██╗██║
   ██║   ██║██████╔╝██║███████║██║ █╗ ██║███████║ ╚████╔╝ ███████║██║
   ██║   ██║██╔══██╗██║██╔══██║██║███╗██║██╔══██║  ╚██╔╝  ██╔══██║██║
   ██║   ██║██████╔╝██║██║  ██║╚███╔███╔╝██║  ██║   ██║   ██║  ██║██║
   ╚═╝   ╚═╝╚═════╝ ╚═╝╚═╝  ╚═╝ ╚══╝╚══╝ ╚═╝  ╚═╝   ╚═╝   ╚═╝  ╚═╝╚═╝

         ⚔  Your path through Tibia, powered by AI  ⚔

TibiaWayAI es un asistente de IA para jugadores de Tibia. Sugiere hunting spots, calcula profit/waste/exp, recomienda quests, organiza sets e imbuements, explica mecánicas de bosses, lleva un diario de progreso y analiza screenshots.

Funciona como CLI standalone (Anthropic o Ollama) y como plugin de OpenCode (sin API key extra).

Instalación

Un solo comando — el instalador te pregunta qué modo querés usar:

npx tibiaway-ai

El instalador ofrece tres opciones:

| Opción | Requisito | Descripción | |---|---|---| | Anthropic Claude | API key de Anthropic | Mejor calidad de respuestas | | Ollama (local) | Ollama instalado | Completamente gratis, sin internet | | Plugin de OpenCode | OpenCode | Sin API key extra, usa el modelo de OpenCode |

Instalación global

npm install -g tibiaway-ai
tibiaway setup

Requisitos

• Node.js >= 18.0.0
• Según el modo elegido:
  • Anthropic: API key de console.anthropic.com
  • Ollama: ollama.com con al menos un modelo descargado (ollama pull llama3.2)
  • OpenCode: OpenCode instalado

Demo

$ tibiaway hunt

⚔  HUNT ADVISOR

? ¿Cuál es tu objetivo principal? Máxima experiencia (exp/h)
? ¿Vas solo o en party? Solo
? ¿Tienes cuenta Premium? Yes

──────────────────────────────────────────────────────────

Para Draken Fireblade (Elder Druid, level 347 en Antica) cazando solo
con objetivo de máxima exp/h, te recomiendo estos spots:

1. ASURAS (Isle of Strife) ★★★★★
   Criaturas: Asura Mirror, Asura Phantom, Asura Spectre
   Exp/h: 4.5M - 6M xp/h (con prey activo)
   Profit: +200k - +500k gold/h
   Requisito: Quest "The Dream Courts" completada
   ...

Comandos CLI

| Comando | Descripción | |---|---| | tibiaway hunt | Sugiere hunting spots para tu vocación y level | | tibiaway profit | Calcula profit, waste y exp/hora | | tibiaway quest | Recomienda quests según tus objetivos | | tibiaway set | Arma tu equipment con imbuements | | tibiaway boss <nombre> | Mecánicas y estrategia de cualquier boss | | tibiaway diary | Diario de progreso | | tibiaway diary add | Agrega una entrada al diario | | tibiaway diary show | Muestra el historial | | tibiaway diary summary | Resumen de progreso con IA | | tibiaway analyze <archivo> | Analiza screenshots o notas (.png, .jpg, .txt) | | tibiaway sync | Actualiza tu perfil desde tibiadata.com | | tibiaway setup | Reconfigurar proveedor de IA o personaje | | tibiaway help | Muestra todos los comandos |

Plugin para OpenCode

TibiaWayAI se instala como agente y comandos en OpenCode con el mismo comando de siempre:

npx tibiaway-ai
# → elige "Plugin OpenCode"

Esto copia el agente y los comandos a ~/.config/opencode/ (o .opencode/ local) y vincula tu personaje automáticamente.

Comandos disponibles en OpenCode

/hunt     → Busca spots de caza
/profit   → Calcula profit de sesión
/quest    → Recomienda quests
/set      → Arma tu equipment
/boss     → Mecánicas de boss
/diary    → Gestiona el diario
/analyze  → Analiza screenshots
/sync     → Refresca el perfil del agente

Sincronización de personaje en OpenCode

El agente lee ~/.tibiaway/config.json al inicio de cada sesión y detecta tu personaje automáticamente. Para refrescar el contexto durante una conversación:

/sync

¿Cómo funciona el sync de personaje?

TibiaWayAI se conecta a la API pública de TibiaData — sin IA, sin API key:

1. Se ingresa el nombre del personaje
2. Se consulta https://api.tibiadata.com/v4/character/[nombre]
3. Se muestran los datos: nombre, vocación, level, world y guild
4. Se confirma y se guarda en ~/.tibiaway/config.json

Actualizar tu perfil:

tibiaway sync
# ✓ Perfil actualizado: Draken Fireblade | Level 347 | Elder Druid

Estructura del archivo de configuración (~/.tibiaway/config.json):

{
  "provider": "anthropic",
  "anthropic_api_key": "sk-ant-...",
  "character": {
    "name": "Draken Fireblade",
    "vocation": "Elder Druid",
    "level": 347,
    "world": "Antica",
    "guild": "The Tibia Gods"
  },
  "diary": [],
  "last_sync": "2025-05-17T12:00:00.000Z"
}

Para Ollama, en lugar de anthropic_api_key se guardan ollama_model y ollama_url.

Estructura del proyecto

tibiaway-ai/
├── bin/
│   └── tibiaway.js           # Punto de entrada CLI
├── src/
│   ├── installer.js          # Instalación interactiva (3 modos)
│   ├── standalone.js         # Router de comandos CLI
│   ├── commands/
│   │   ├── hunt.js
│   │   ├── profit.js
│   │   ├── quest.js
│   │   ├── set.js
│   │   ├── boss.js
│   │   ├── diary.js
│   │   ├── analyze.js
│   │   ├── sync.js
│   │   └── setup-opencode.js # Setup del plugin OpenCode
│   └── utils/
│       ├── banner.js         # Banner ASCII y helpers de UI
│       ├── config.js         # Config en ~/.tibiaway/config.json
│       ├── character.js      # Gestión del perfil de personaje
│       └── api.js            # Wrapper Anthropic + Ollama
├── agents/
│   └── tibiaway.md           # Definición del agente OpenCode
├── commands/                 # Slash commands para OpenCode
│   ├── hunt.md
│   ├── profit.md
│   ├── quest.md
│   ├── set.md
│   ├── boss.md
│   ├── diary.md
│   ├── analyze.md
│   └── sync.md
├── web/
│   └── index.html            # Landing page
├── package.json
└── README.md

Variables de entorno

| Variable | Descripción | |---|---| | ANTHROPIC_API_KEY | API key de Anthropic (alternativa a la configuración guardada) | | DEBUG | Si está definida, muestra errores detallados |

Contributing

Las contribuciones son bienvenidas. Por favor:

1. Haz fork del repositorio
2. Crea una rama descriptiva: git checkout -b feat/nuevo-comando
3. Haz tus cambios con commits claros
4. Abre un Pull Request describiendo los cambios

Áreas donde puedes contribuir

• Nuevos comandos: bestiary tracker, exp party calculator, imbuement price checker
• Mejor base de conocimiento: actualizar datos de vocaciones, spots y bosses
• Integración TibiaWiki: link automático a páginas de TibiaWiki
• Export de datos: exportar diario a CSV o Markdown
• Tests: añadir tests unitarios e integración

Licencia

MIT © TibiaWayAI

TibiaWayAI no está afiliado con CipSoft GmbH ni con Tibia oficialmente.
Tibia® es una marca registrada de CipSoft GmbH.