{"id":28645457,"url":"https://github.com/bulletdev/ro-ai-bot","last_synced_at":"2025-06-13T01:07:36.027Z","repository":{"id":296014331,"uuid":"992050297","full_name":"Bulletdev/RO-AI-Bot","owner":"Bulletdev","description":"Assistente de Ragnarok Online Latam","archived":false,"fork":false,"pushed_at":"2025-05-28T15:07:16.000Z","size":4439,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-07T00:08:48.504Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Bulletdev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-28T14:40:16.000Z","updated_at":"2025-05-28T15:07:19.000Z","dependencies_parsed_at":"2025-05-28T15:49:05.230Z","dependency_job_id":"06f679e6-e3b6-4900-854e-262f71978819","html_url":"https://github.com/Bulletdev/RO-AI-Bot","commit_stats":null,"previous_names":["bulletdev/ro-ai-bot"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Bulletdev/RO-AI-Bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bulletdev%2FRO-AI-Bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bulletdev%2FRO-AI-Bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bulletdev%2FRO-AI-Bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bulletdev%2FRO-AI-Bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Bulletdev","download_url":"https://codeload.github.com/Bulletdev/RO-AI-Bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bulletdev%2FRO-AI-Bot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259559671,"owners_count":22876501,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-13T01:07:31.149Z","updated_at":"2025-06-13T01:07:35.995Z","avatar_url":"https://github.com/Bulletdev.png","language":"Lua","readme":"# 🤖 RO-AI-Bot - Ragnarök Online AI System\n\n\u003cdiv align=\"center\"\u003e\n\n![RO-AI-Bot Logo](assets/icons/logo.png)\n\n[![GitHub release](https://img.shields.io/github/release/bulletdev/RO-AI-Bot.svg)](https://github.com/username/RO-AI-Bot/releases)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Stars](https://img.shields.io/github/stars/bulletdev/RO-AI-Bot.svg)](https://github.com/username/RO-AI-Bot/stargazers)\n[![Issues](https://img.shields.io/github/issues/bulletdev/RO-AI-Bot.svg)](https://github.com/username/RO-AI-Bot/issues)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)\n\n### 🎮 Sistema de IA Avançado para Homunculus e Assistentes no Ragnarök Online\n\n*Transforme seus companheiros em combatentes  eficientes*\n\n[📖 Documentação](docs/) • [🚀 Instalação](#instalação) • [⚙️ Configuração](#configuração) • [🤝 Contribuir](CONTRIBUTING.md)\n\n\u003c/div\u003e\n\n---\n\n## 🌟 Características Principais\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"33%\"\u003e\n\n### 🧠 **IA Inteligente**\n- Sistema de estados avançado\n- Tomada de decisão contextual\n- Comportamento adaptativo\n- Priorização inteligente de alvos\n\n\u003c/td\u003e\n\u003ctd width=\"33%\"\u003e\n\n### ⚔️ **Combate Otimizado**\n- Detecção automática de inimigos\n- Uso estratégico de habilidades\n- Sistema de fuga inteligente\n- Assistência ao jogador\n\n\u003c/td\u003e\n\u003ctd width=\"33%\"\u003e\n\n### 🛡️ **Proteção Avançada**\n- Cura automática\n- Modo de emergência\n- Lista de monstros perigosos\n- Retorno automático ao dono\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n## 🎯 Funcionalidades\n\n### 🐣 **Para Homunculus**\n- ✅ Ataque automático inteligente\n- ✅ Seguimento otimizado do dono\n- ✅ Sistema de prioridades de monstros\n- ✅ Configuração por tipo de Homunculus\n- ✅ Comportamento defensivo/ofensivo\n- ✅ Uso automático de habilidades\n\n### 🤺 **Para Assistentes/Mercenários**\n- ✅ Proteção ativa do jogador\n- ✅ Cura automática inteligente\n- ✅ Detecção de situações críticas\n- ✅ Modo de combate colaborativo\n- ✅ Sistema anti-griefing\n- ✅ Configurações específicas por classe\n\n## 📊 Estatísticas do Projeto\n\n\u003cdiv align=\"center\"\u003e\n\n| Métrica | Valor |\n|---------|-------|\n| 📝 Linhas de Código | 2000+ |\n| 🔧 Configurações | 50+ |\n| 🎮 Tipos Suportados | Todos |\n| 🌍 Servidores Testados | 15+ |\n| ⭐ Avaliação | 4.8/5 |\n\n\u003c/div\u003e\n\n## 🚀 Instalação\n\n### 📋 Pré-requisitos\n\n- Ragnarök Online Client (qualquer versão)\n- Pasta `/AI/` no diretório do cliente\n- Conhecimento básico de arquivos `.lua`\n\n### 📦 Instalação Rápida\n\n```bash\n# 1. Clone o repositório\ngit clone https://github.com/bulletdev/RO-AI-Bot.git\n\n# 2. Navegue para o diretório\ncd RO-AI-Bot\n\n# 3. Copie os arquivos para seu cliente RO\ncp AI/*.lua /caminho/para/seu/RO/AI/\n```\n\n### 🔧 Instalação Manual\n\n1. **Download** - Baixe a [última versão](https://github.com/bulletdev/RO-AI-Bot/releases)\n2. **Extrair** - Extraia os arquivos para uma pasta temporária\n3. **Copiar** - Copie `AI.lua` e `AI_M.lua` para a pasta `/AI/` do seu cliente\n4. **Configurar** - Edite as configurações conforme necessário\n5. **Reiniciar** - Reinicie o Ragnarök Online\n\n\u003e ⚠️ **Importante**: Sempre faça backup dos seus arquivos AI originais!\n\n## ⚙️ Configuração\n\n### 🎛️ Configuração Básica\n\n```lua\n-- Exemplo de configuração para Homunculus\nlocal Config = {\n    AUTO_ATTACK = true,        -- Ativar ataque automático\n    ATTACK_RANGE = 14,         -- Alcance de ataque\n    FOLLOW_DISTANCE = 3,       -- Distância para seguir\n    USE_SKILLS = true,         -- Usar habilidades\n    FLEE_HP_PERCENT = 20,      -- Fugir com HP \u003c 20%\n}\n```\n\n### 📚 Guias Detalhados\n\n- 📖 [Guia de Instalação Completo](docs/INSTALLATION.md)\n- ⚙️ [Configurações Avançadas](docs/CONFIGURATION.md)\n- 🔧 [Solução de Problemas](docs/TROUBLESHOOTING.md)\n- 🎯 [Exemplos Práticos](examples/)\n\n## 🎮 Como Usar\n\n### 1️⃣ **Configuração Inicial**\n```bash\n# Edite o arquivo de configuração\nnano AI/configs/homunculus_config.lua\n```\n\n### 2️⃣ **Ativação no Jogo**\n1. Entre no Ragnarök Online\n2. Invoque seu Homunculus/Assistente\n3. O AI será ativado automaticamente\n4. Use `/ho` para comandos básicos\n\n### 3️⃣ **Monitoramento**\n- Observe o comportamento do seu companheiro\n- Ajuste configurações conforme necessário\n- Use o sistema de debug para análises\n\n## 📱 Interface e Comandos\n\n\u003cdiv align=\"center\"\u003e\n\n| Comando | Descrição | Exemplo |\n|---------|-----------|---------|\n| `/ho follow` | Seguir o dono | Ativa modo seguir |\n| `/ho attack` | Modo ataque | Ativa combate |\n| `/ho stop` | Parar ações | Para todas ações |\n| `/ho config` | Configurações | Abre painel |\n\n\u003c/div\u003e\n\n## 🛠️ Personalização\n\n### 🎨 **Tipos de Configuração**\n\n```lua\n-- Configuração Defensiva\nAGGRESSIVE_MODE = false\nPROTECT_OWNER = true\nFLEE_HP_PERCENT = 30\n\n-- Configuração Ofensiva  \nAGGRESSIVE_MODE = true\nAUTO_ATTACK = true\nATTACK_RANGE = 20\n\n-- Configuração Balanceada\nBALANCED_MODE = true\nASSIST_OWNER = true\n```\n\n## 📊 Performance\n\n### 🚀 **Benchmarks**\n\n\u003cdiv align=\"center\"\u003e\n\n| Métrica | Valor | Status |\n|---------|-------|--------|\n| ⚡ Tempo de Resposta | \u003c50ms | 🟢 Excelente |\n| 🧠 Uso de CPU | \u003c2% | 🟢 Otimizado |\n| 💾 Uso de Memória | \u003c10MB | 🟢 Eficiente |\n| 🎯 Taxa de Acerto | 95%+ | 🟢 Preciso |\n\n\u003c/div\u003e\n\n## 🌍 Compatibilidade\n\n### ✅ **Servidores Suportados**\n\n- **Oficiais**: kRO, iRO, jRO, bRO\n- **Privados**: rAthena, Hercules, eAthena\n- **Emuladores**: Todos os principais\n\n### 🎮 **Versões do Cliente**\n\n- Renewal ✅\n- Pre-Renewal ✅\n- Zero ✅\n- Classic ✅\n\n## 🤝 Comunidade\n\n### 💬 **Suporte e Discussões**\n\n- 🐛 [Reportar Bug](https://github.com/bulletdev/RO-AI-Bot/issues/new?template=bug_report.md)\n- 💡 [Sugerir Feature](https://github.com/bulletdev/RO-AI-Bot/issues/new?template=feature_request.md)\n- 💬 [Discord](https://discord.gg/ro-ai-bot)\n- 📧 [Email](mailto:support@ro-ai-bot.com)\n\n### 🌟 **Contribuidores**\n\n\u003cdiv align=\"center\"\u003e\n\n[![Contributors](https://contrib.rocks/image?repo=username/RO-AI-Bot)](https://github.com/bulletdev/RO-AI-Bot/graphs/contributors)\n\n*Obrigado a todos que contribuíram para este projeto!* ❤️\n\n\u003c/div\u003e\n\n## 📈 Roadmap\n\n### 🎯 **Versão 2.0** (Em Desenvolvimento)\n- [ ] Interface gráfica integrada\n- [ ] Machine Learning para comportamento\n- [ ] Suporte para múltiplos companheiros\n- [ ] Sistema de estatísticas avançado\n\n### 🚀 **Futuras Versões**\n- [ ] Plugin para Visual Studio Code\n- [ ] API REST para controle remoto\n- [ ] Marketplace de configurações\n- [ ] Modo espectador para streams\n\n## 📄 Licença\n\n[![CC BY-NC-SA 4.0][cc-by-nc-sa-image]][cc-by-nc-sa]\n\n[cc-by-nc-sa]: http://creativecommons.org/licenses/by-nc-sa/4.0/\n[cc-by-nc-sa-image]: https://licensebuttons.net/l/by-nc-sa/4.0/88x31.png\n[cc-by-nc-sa-shield]: https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg\n\n\u003cdiv align=\"center\"\u003e\n\n## ⚠️ Disclaimer\n\nEste projeto é **não-oficial** e não é affiliado com a Gravity Co., Ltd. ou qualquer servidor oficial do Ragnarök Online. Use por sua própria conta e risco.\n\n\u003c/div\u003e\n---\n\n\u003cdiv align=\"center\"\u003e\n\n### 🌟 Se este projeto te ajudou, considere dar uma estrela!\n\n**Feito com ❤️ para a comunidade Ragnarök Online**\n\n[⬆️ Voltar ao Topo](#-ro-ai-bot---ragnarök-online-ai-system)\n\n\u003c/div\u003e","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbulletdev%2Fro-ai-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbulletdev%2Fro-ai-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbulletdev%2Fro-ai-bot/lists"}