⭐ Ai Hoshino Bot

"Ser uma ídola não é apenas parecer perfeita... é fazer os outros sorrirem." ✨

🚀 Instalação • 📱 Comandos • 💎 Sistema de Economia • 🎭 Brincadeiras • ⚙️ Personalização

🌟 Sobre o Projeto

Ai Hoshino Bot é um bot para WhatsApp inspirado na carismática protagonista de Oshi no Ko. Combinando a personalidade encantadora de Ai com funcionalidades poderosas, este bot traz diversão, entretenimento e interação única para suas conversas!

✨ Destaques

🎭 Personalidade Ai Hoshino

⭐ Respostas carismáticas e encantadoras
💫 Inteligência aguçada e contextual
🌟 Mistério sedutor característico
💕 Genuína empatia com usuários
🎬 Frases icônicas do anime

💎 Sistemas Completos

💰 Sistema de economia com Cristais
🎭 10+ brincadeiras com GIFs
👑 Painel administrativo
🎵 Banco de 10 músicas + playlists
🎬 Database de animes
📊 Sistema de estatísticas

📖 Sobre Ai Hoshino

Protagonista de Oshi no Ko 🌟

Ai Hoshino é uma ídola famosa, encantadora e enigmática que sempre mantém um sorriso perfeito enquanto conquista corações. Este bot captura sua essência única:

Característica	Descrição
🌟 Carisma Natural	Respostas que cativam e encantam cada usuário
💫 Inteligência Aguçada	Compreensão contextual e respostas inteligentes
🎭 Mistério Sedutor	Sempre há mais do que aparenta nas respostas
💕 Genuína Empatia	Se importa verdadeiramente com seus usuários
⭐ Perfeição Calculada	Cada resposta é cuidadosamente elaborada

📦 Requisitos

Requisito	Versão Mínima	Download
Node.js	16.0.0+	nodejs.org
npm	8.0.0+	Incluído com Node.js
WhatsApp	Ativo	No seu celular
Git	Qualquer	git-scm.com

🚀 Instalação

Método 1: Instalação Rápida ⚡

# 1. Clone o repositório
git clone https://github.com/seu-usuario/ai-hoshino-bot.git
cd ai-hoshino-bot

# 2. Instale as dependências
npm install

# 3. Inicie o bot
npm start

# 4. Escaneie o QR Code com WhatsApp
# (Configurações → Aparelhos Conectados → Conectar Aparelho)

# 5. Pronto! Ai Hoshino está online! ⭐

Método 2: Instalação Detalhada 📋

Clique para ver passos detalhados

Passo 1: Clone o Projeto

git clone https://github.com/seu-usuario/ai-hoshino-bot.git

Passo 2: Entre na Pasta

cd ai-hoshino-bot

Passo 3: Instale Dependências

npm install

Passo 4: Configure (Opcional)

# Edite admin.js para adicionar seu número como admin
nano admin.js  # ou use seu editor favorito

Passo 5: Inicie o Bot

npm start

Passo 6: Conecte ao WhatsApp

Abra o WhatsApp no celular
Vá em Configurações → Aparelhos Conectados
Toque em Conectar Aparelho
Escaneie o QR Code que aparece no terminal

🎉 Bot conectado com sucesso!

💬 Primeiros Passos

🎮 Como Começar

# 1. Envie um comando
!ajuda          # Ver todos os comandos

# 2. Converse naturalmente
Oi!             # O bot responde com personalidade

# 3. Aproveite os sistemas
!diario         # Ganhe Cristais diários
!cafune @amigo  # Faça brincadeiras com GIFs
!musicas        # Veja músicas disponíveis
!anime Oshi no Ko  # Busque informações de animes

💡 Dicas Importantes

⭐ Comece com !ajuda para ver todos os comandos
💎 Use !diario todos os dias para ganhar Cristais
🎭 Todas as brincadeiras agora têm GIFs animados!
🎵 Descubra músicas e playlists de anime
👑 Admins têm poderes especiais de moderação

📱 Comandos Disponíveis

📚 Comandos Gerais

Ver comandos gerais (3 comandos)

Comando	Descrição	Exemplo
`!ajuda`	Mostra todos os comandos disponíveis	`!ajuda`
`!quem`	Informações sobre o bot e Ai Hoshino	`!quem`
`!status`	Status do bot e estatísticas	`!status`

🎉 Diversão & Entretenimento

Ver comandos de diversão (3 comandos)

Comando	Descrição	Exemplo
`!piada`	Ouça uma piada engraçada	`!piada`
`!frases`	Frases motivacionais	`!frases`
`!citacao`	Citações inspiradoras de anime	`!citacao`

🎬 Anime & Oshi no Ko

Ver comandos de anime (12 comandos)

Comandos Gerais de Anime

Comando	Descrição	Exemplo
`!anime <nome>`	Buscar informações detalhadas de um anime	`!anime Death Note`
`!personagem <nome>`	Buscar informações de um personagem	`!personagem Naruto`
`!recomenda`	Recomendações de anime por gênero	`!recomenda`
`!curiosidade`	Curiosidades interessantes sobre anime	`!curiosidade`
`!top`	Top 5 animes do momento	`!top`
`!genero`	Mostrar todos os gêneros de anime	`!genero`

Específicos de Oshi no Ko

Comando	Descrição	Exemplo
`!personagens`	Listar personagens de Oshi no Ko	`!personagens`
`!hino`	Links para assistir Oshi no Ko	`!hino`
`!spoiler`	⚠️ SPOILERS do anime!	`!spoiler`

💎 Sistema de Economia

Ver comandos de economia (6 comandos)

Comando	Descrição	Recompensa
`!saldo`	Ver seu saldo e perfil completo	-
`!diario`	Ganhar recompensa diária	💎 50-100 Cristais
`!loja`	Ver loja de itens exclusivos	-
`!comprar <id>`	Comprar item na loja	Varia
`!inventario`	Ver seus itens comprados	-
`!economia`	Informações sobre o sistema	-

💡 Dica: Use !diario todos os dias para acumular Cristais!

🎭 Brincadeiras & Interações

Ver comandos de brincadeiras (13 comandos)

Ações com GIFs Animados

Comando	Descrição	Tem GIF?
`!cafune [@pessoa]`	Dar um cafuné carinhoso 😊	✅
`!abraco [@pessoa]`	Abraçar alguém 🤗	✅
`!beijo [@pessoa]`	Dar um beijo 😘	✅
`!murro [@pessoa]`	Dar um murro 👊	✅
`!chutar [@pessoa]`	Chutar alguém 🦶	✅
`!socao [@pessoa]`	Dar um socão 💥	✅
`!tapa [@pessoa]`	Dar um tapa 👋	✅
`!puxarcabelo [@pessoa]`	Puxar cabelo 💇	✅
`!amassar [@pessoa]`	Amassar alguém 🍞	✅

Jogos Interativos

Comando	Descrição
`!pergunta`	Receba uma pergunta aleatória
`!verdade`	Jogo Verdade ou Desafio (verdade)
`!desafio`	Jogo Verdade ou Desafio (desafio)
`!brincadeiras`	Listar todas as brincadeiras

✨ Novidade: Todas as brincadeiras agora enviam GIFs animados!

🎵 Sistema de Música

Ver comandos de música (5 comandos)

Comando	Descrição	Exemplo
`!musica <nome>`	Buscar uma música específica	`!musica Idol`
`!musicas`	Listar todas as músicas disponíveis	`!musicas`
`!playlist`	Ver todas as playlists	`!playlist`
`!playlist <id>`	Ver detalhes de uma playlist	`!playlist 1`
`!recomenda-musica`	Obter uma música aleatória	`!recomenda-musica`

🎵 Músicas Disponíveis

10+ músicas de anime catalogadas
3 playlists temáticas
Informações completas (artista, álbum, ano)

👑 Comandos Admin

Ver comandos administrativos (6 comandos)

Comando	Descrição	Permissão
`!warn @pessoa <motivo>`	Dar aviso a um usuário	👑 Admin
`!warns @pessoa`	Ver avisos de alguém	👑 Admin
`!limparwarns @pessoa`	Limpar todos os avisos	👑 Admin
`!promover @pessoa`	Tornar alguém admin	👑 Admin
`!rebaixar @pessoa`	Remover admin	👑 Admin
`!adminhelp`	Ajuda de comandos admin	👑 Admin

⚠️ Sistema de Warns

3 avisos = usuário é removido automaticamente
Histórico completo de infrações
Sistema de logs detalhado

🔐 Configurar Admin: Edite admin.js e adicione seu número em ADMINS_PADRAO

💎 Sistema de Economia

Como Funciona

┌─────────────────────────────────────────┐
│  💰 ECONOMIA DE CRISTAIS                │
├─────────────────────────────────────────┤
│  Começe com: 100 Cristais 💎           │
│  Recompensa diária: 50-100 Cristais ⭐  │
│  Compre itens exclusivos na loja! 🛍️   │
│  Crie sua coleção pessoal! 🏆          │
└─────────────────────────────────────────┘

💰 Como Ganhar Cristais

Ação	Recompensa
🎉 Primeiro registro	100 Cristais
⭐ Recompensa diária	50-100 Cristais
🎮 Completar desafios	25-200 Cristais
🎁 Eventos especiais	Bônus variados

🛍️ Loja de Itens

🎭 Itens Cosméticos - Personalize seu perfil
⭐ Itens Raros - Colecionáveis exclusivos
👑 Itens VIP - Benefícios especiais
🎁 Pacotes - Combos com desconto

📊 Comandos Rápidos

!saldo              # Ver seu saldo atual
!diario             # Coletar recompensa diária
!loja               # Ver itens disponíveis
!comprar 1          # Comprar item ID 1
!inventario         # Ver seus itens

🎭 Sistema de Brincadeiras

✨ Novidade: GIFs Animados!

Todas as brincadeiras agora enviam GIFs animados para tornar a experiência mais divertida!

Categorias de Brincadeiras

💕 Ações Carinhosas

!cafune - Cafuné carinhoso
!abraco - Abraço apertado
!beijo - Beijo apaixonado

💥 Ações Agressivas

!murro - Murro forte
!chutar - Chute potente
!socao - Socão devastador
!tapa - Tapa na cara
!puxarcabelo - Puxão de cabelo

🎮 Jogos Interativos

Verdade ou Desafio - !verdade ou !desafio
Perguntas Aleatórias - !pergunta
Mais jogos em desenvolvimento!

Como Usar

# Com menção
!cafune @amigo      # Fazer cafuné no amigo

# Sem menção
!abraco             # Ai Hoshino te abraça!

# Resultado
[GIF animado] + mensagem personalizada ✨

👑 Sistema Administrativo

Configurar Admin

Abra o arquivo admin.js
Localize a constante ADMINS_PADRAO
Adicione seu número no formato:

const ADMINS_PADRAO = [
  '5511996249700@s.whatsapp.net',
  'seu-numero-aqui@s.whatsapp.net'
];

Salve e reinicie o bot

Funcionalidades Admin

⚠️ Sistema de Warns

!warn @usuario motivo     # Dar aviso
!warns @usuario           # Ver avisos
!limparwarns @usuario     # Limpar avisos

3 avisos = remoção automática
Histórico completo de infrações
Logs detalhados de moderação

👥 Gerenciar Admins

!promover @usuario        # Tornar admin
!rebaixar @usuario        # Remover admin

📊 Estatísticas

!adminhelp               # Ver todos comandos admin

📁 Estrutura do Projeto

ai-hoshino-bot/
│
├── 📄 bot.js                     # Arquivo principal do bot
├── 📄 personalidade.js           # Sistema de personalidade e respostas
├── 📄 economia.js                # Sistema de economia completo
├── 📄 admin.js                   # Sistema admin e brincadeiras
├── 📄 package.json               # Dependências do projeto
├── 📄 package-lock.json          # Lock de dependências
├── 📄 .env                       # Variáveis de ambiente
├── 📄 .gitignore                 # Arquivos ignorados pelo Git
├── 📄 README.md                  # Este arquivo
│
├── 📂 auth_info_baileys/         # Autenticação WhatsApp
│   └── creds.json                # Credenciais (não versionar!)
│
├── 📂 database/                  # Banco de dados
│   ├── usuarios.json             # Dados dos usuários
│   ├── warns.json                # Sistema de avisos
│   └── admins.json               # Lista de administradores
│
├── 📂 assets/                    # Recursos
│   ├── images/                   # Imagens e GIFs
│   └── audio/                    # Áudios (futuro)
│
└── 📂 logs/                      # Logs do sistema
    ├── bot.log                   # Logs gerais
    └── errors.log                # Logs de erros

⚙️ Personalização

🎭 Adicionar Novas Respostas

Edite o arquivo personalidade.js:

// Respostas especiais
const respostasEspeciais = {
  'oi': 'Olá! Como está seu dia? ⭐',
  'tchau': 'Até logo! Volte sempre! ✨',
  'amor': 'Aww, você é fofo! 💕',
  // Adicione mais aqui!
};

// Novas piadas
const piadas = [
  "Por que o livro de matemática se suicidou? Porque tinha muitos problemas! 📚",
  "Sua piada aqui! 🤣",
  // Adicione mais aqui!
];

// Novas frases
const frases = [
  "\"A perfeição não existe, mas podemos fingir muito bem.\" - Ai Hoshino ⭐",
  "\"Sua frase aqui!\" - Autor ✨",
  // Adicione mais aqui!
];

💎 Customizar Sistema de Economia

Edite o arquivo economia.js:

// Valores iniciais
const CRISTAIS_INICIAIS = 100;
const RECOMPENSA_DIARIA_MIN = 50;
const RECOMPENSA_DIARIA_MAX = 100;

// Itens da loja
const LOJA_ITENS = [
  {
    id: 1,
    nome: "Seu Item Novo",
    descricao: "Descrição do item",
    preco: 150,
    emoji: "🎁"
  },
  // Adicione mais itens!
];

🎭 Adicionar Novas Brincadeiras

Edite o arquivo admin.js:

// Nova brincadeira com GIF
case '!suabrincadeira':
  if (mentionedJid) {
    const gifUrl = 'https://url-do-seu-gif.gif';
    await sock.sendMessage(from, {
      video: { url: gifUrl },
      gifPlayback: true,
      caption: `@${sender.split('@')[0]} fez algo com @${mentionedJid[0].split('@')[0]}! ✨`
    });
  }
  break;

🐛 Troubleshooting

❌ Bot não conecta

Soluções possíveis

# 1. Verificar Node.js
node --version  # Deve ser 16.x ou superior

# 2. Reinstalar dependências
rm -rf node_modules package-lock.json
npm install

# 3. Limpar autenticação
rm -rf auth_info_baileys/
npm start

# 4. Verificar conexão
# Certifique-se de ter internet estável

❌ Comandos não funcionam

Soluções

Verifique o prefixo: Todos os comandos começam com !
Confira a sintaxe: Use !ajuda para ver comandos corretos
Veja permissões: Alguns comandos são apenas para admins
Cheque os logs: Veja logs/errors.log

❌ GIFs não carregam

Soluções

Verifique conexão: GIFs precisam de boa internet
Aguarde: Alguns GIFs podem demorar
Fallback: O bot envia texto se GIF falhar
URLs: Verifique se as URLs dos GIFs estão válidas

❌ Economia não funciona

Soluções

# 1. Verificar arquivo de usuários
cat database/usuarios.json

# 2. Recriar banco de dados
rm database/usuarios.json
npm start

# 3. Verificar permissões
chmod 644 database/usuarios.json

📝 Git & Versionamento

Comandos Úteis

# Ver histórico de mudanças
git log --oneline --graph

# Ver status dos arquivos
git status

# Fazer um novo commit
git add .
git commit -m "✨ Adiciona: nova funcionalidade"

# Ver diferenças
git diff

# Voltar para commit anterior
git checkout <hash-do-commit>

# Criar nova branch
git checkout -b feature/nova-funcionalidade

Convenções de Commit

Use commits semânticos para melhor organização:

✨ feat: Nova funcionalidade
🐛 fix: Correção de bug
📝 docs: Documentação
♻️ refactor: Refatoração
🎨 style: Estilo/formatação
✅ test: Testes
🔧 chore: Manutenção

⚠️ Avisos Importantes

Privacidade & Segurança

🔐 Credenciais: Nunca compartilhe auth_info_baileys/
📝 Dados: Usuários são armazenados localmente em JSON
🚫 Não versione: .env e auth_info_baileys/ no .gitignore

Termos de Uso

⚖️ WhatsApp TOS: Usar bots pode violar termos de serviço
📚 Uso educacional: Projeto destinado a fins educacionais
🎓 Responsabilidade: Use de forma ética e responsável

Limitações

💬 Histórico: O bot não armazena histórico de conversas
🌐 Internet: Requer conexão estável
📱 WhatsApp: Celular precisa estar conectado à internet

🎬 Sobre "Oshi no Ko"

oshi no ko (推しの子) é um mangá/anime que segue a história de ídolos em Tóquio.

📖 Sinopse

A história acompanha Ai Hoshino, uma ídola brilhante e carismática do grupo B-Komachi, que esconde segredos profundos por trás de seu sorriso perfeito. O anime explora os bastidores obscuros da indústria do entretenimento japonês.

⭐ Personagens Principais

Ai Hoshino - A ídola perfeita (protagonista deste bot!)
Aquamarine Hoshino - Filho de Ai
Ruby Hoshino - Filha de Ai
Kana Arima - Atriz infantil talentosa
Akane Kurokawa - Atriz versátil

🎵 Músicas Icônicas

"IDOL" - Tema de abertura por YOASOBI
Trilha sonora emocionante por diversos artistas

📚 Recursos Úteis

Documentação Oficial

📖 Baileys - Biblioteca WhatsApp
📖 Node.js - Runtime JavaScript
📖 Oshi no Ko Wiki - Informações do anime

Comunidade

💬 Grupo WhatsApp - Suporte oficial
🐛 GitHub Issues - Reportar bugs
💡 Discussions - Sugestões

🤝 Contribuindo

Contribuições são bem-vindas! Aqui está como ajudar:

Como Contribuir

🍴 Fork o projeto
🌿 Crie uma branch (git checkout -b feature/MinhaFeature)
✏️ Commit suas mudanças (git commit -m '✨ Adiciona MinhaFeature')
📤 Push para a branch (git push origin feature/MinhaFeature)
🔀 Abra um Pull Request

Diretrizes

✅ Siga o estilo de código existente
✅ Adicione comentários explicativos
✅ Teste antes de enviar
✅ Atualize a documentação
✅ Seja respeitoso com outros contribuidores

📊 Estatísticas do Projeto

⭐ Desenvolvido com 💫 por fãs de Oshi no Ko "A perfeição é uma mentira... mas uma mentira bonita." — Ai Hoshino

⭐ Se este projeto te ajudou, deixe uma estrela! ⭐

Name		Name	Last commit message	Last commit date
.gitignore		.gitignore
README.md		README.md
admin.js		admin.js
basicos.js		basicos.js
bot.js		bot.js
bot_backup.js		bot_backup.js
economia.js		economia.js
midia.js		midia.js
musica.js		musica.js
package-lock.json		package-lock.json
package.json		package.json
personalidade.js		personalidade.js

Latest commit

History

Folders and files

Repository files navigation

⭐ Ai Hoshino Bot

"Ser uma ídola não é apenas parecer perfeita... é fazer os outros sorrirem." ✨

🌟 Sobre o Projeto

✨ Destaques

🎭 Personalidade Ai Hoshino

💎 Sistemas Completos

📖 Sobre Ai Hoshino

📦 Requisitos

🚀 Instalação

Método 1: Instalação Rápida ⚡

Método 2: Instalação Detalhada 📋

Passo 1: Clone o Projeto

Passo 2: Entre na Pasta

Passo 3: Instale Dependências

Passo 4: Configure (Opcional)

Passo 5: Inicie o Bot

Passo 6: Conecte ao WhatsApp

💬 Primeiros Passos

🎮 Como Começar

💡 Dicas Importantes

📱 Comandos Disponíveis

📚 Comandos Gerais

🎉 Diversão & Entretenimento

🎬 Anime & Oshi no Ko

Comandos Gerais de Anime

Específicos de Oshi no Ko

💎 Sistema de Economia

🎭 Brincadeiras & Interações

Ações com GIFs Animados

Jogos Interativos

🎵 Sistema de Música

🎵 Músicas Disponíveis

👑 Comandos Admin

⚠️ Sistema de Warns

💎 Sistema de Economia

Como Funciona

💰 Como Ganhar Cristais

🛍️ Loja de Itens

📊 Comandos Rápidos

🎭 Sistema de Brincadeiras

✨ Novidade: GIFs Animados!

Categorias de Brincadeiras

💕 Ações Carinhosas

💥 Ações Agressivas

🎮 Jogos Interativos

Como Usar

👑 Sistema Administrativo

Configurar Admin

Funcionalidades Admin

⚠️ Sistema de Warns

👥 Gerenciar Admins

📊 Estatísticas

📁 Estrutura do Projeto

⚙️ Personalização

🎭 Adicionar Novas Respostas

💎 Customizar Sistema de Economia

🎭 Adicionar Novas Brincadeiras

🐛 Troubleshooting

❌ Bot não conecta

❌ Comandos não funcionam

❌ GIFs não carregam

❌ Economia não funciona

📝 Git & Versionamento

Comandos Úteis

Convenções de Commit

⚠️ Avisos Importantes

Privacidade & Segurança

Termos de Uso

Limitações

🎬 Sobre "Oshi no Ko"

📖 Sinopse

⭐ Personagens Principais

🎵 Músicas Icônicas

📚 Recursos Úteis

Documentação Oficial

Comunidade