{"id":28069597,"url":"https://github.com/hiudyy/nazuna","last_synced_at":"2025-05-12T19:10:49.733Z","repository":{"id":276471511,"uuid":"929206532","full_name":"hiudyy/nazuna","owner":"hiudyy","description":"A 100% editable, decrypted and free whatsapp bot.","archived":false,"fork":false,"pushed_at":"2025-05-12T03:36:08.000Z","size":2744,"stargazers_count":6,"open_issues_count":0,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-12T03:39:57.085Z","etag":null,"topics":["baileys","baileys-api","baileys-bot","baileys-lib","baileys-md","bot","chat","chatbot","wabot","wabot-md","wabot-termux","whatsapp","whatsapp-bot","whatsapp-web"],"latest_commit_sha":null,"homepage":"https://whatsapp.com/channel/0029Vb6bZMrEQIaq4jzEPv40","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hiudyy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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},"funding":{"github":null,"patreon":"hiudyy","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2025-02-08T02:30:33.000Z","updated_at":"2025-05-12T03:36:11.000Z","dependencies_parsed_at":"2025-03-04T00:25:44.293Z","dependency_job_id":"37623038-1f7c-4609-a518-13aef18f91ad","html_url":"https://github.com/hiudyy/nazuna","commit_stats":null,"previous_names":["hiudyy/nazuninha-bot","hiudyy/nazuna"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiudyy%2Fnazuna","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiudyy%2Fnazuna/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiudyy%2Fnazuna/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiudyy%2Fnazuna/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hiudyy","download_url":"https://codeload.github.com/hiudyy/nazuna/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253805860,"owners_count":21967053,"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":["baileys","baileys-api","baileys-bot","baileys-lib","baileys-md","bot","chat","chatbot","wabot","wabot-md","wabot-termux","whatsapp","whatsapp-bot","whatsapp-web"],"created_at":"2025-05-12T19:10:46.665Z","updated_at":"2025-05-12T19:10:49.725Z","avatar_url":"https://github.com/hiudyy.png","language":"JavaScript","funding_links":["https://patreon.com/hiudyy"],"categories":[],"sub_categories":[],"readme":"# **nazuna Bot 🤖🚀**\n\n \n---\n\n## 🌐 **Escolha Seu Idioma**\n\nClique no idioma para expandir as instruções completas e personalizadas:\n\n- 🇺🇸 [English](#-english)\n- 🇧🇷 [Português (Brasil)](#-portugues-brasil)\n- 🇪🇸 [Español](#-espanol)\n- 🇮🇩 [Bahasa Indonesia](#-bahasa-indonesia)\n- 🇫🇷 [Français](#-francais)\n\n---\n\n## 🇧🇷 **Português (Brasil)**\n\n\u003cdetails\u003e\n\u003csummary\u003e💻 Clique para Expandir Instruções em Português\u003c/summary\u003e\n\n### 📊 **Estatísticas do Projeto**\n\nMétricas em tempo real do **nazuna Bot**, com o que cada uma significa:\n\n| Ícone | Badge | Descrição |\n|-------|-------|-----------|\n| 🕒 | ![Última Atualização](https://img.shields.io/github/last-commit/hiudyy/nazuna?color=blue\u0026style=flat-square) | **Última Atualização**: Quando o projeto foi atualizado pela última vez. |\n| ⭐ | ![Estrelas](https://img.shields.io/github/stars/hiudyy/nazuna?color=yellow\u0026label=Favoritos\u0026style=flat-square) | **Favoritos**: Quantas pessoas deram estrela no GitHub. |\n| 🍴 | ![Forks](https://img.shields.io/github/forks/hiudyy/nazuna?color=green\u0026style=flat-square) | **Forks**: Cópias do projeto feitas por outros devs. |\n| 🐞 | ![Issues](https://img.shields.io/github/issues/hiudyy/nazuna?color=red\u0026style=flat-square) | **Issues**: Bugs ou sugestões reportados pela comunidade. |\n| 📝 | ![Commits](https://img.shields.io/github/commit-activity/m/hiudyy/nazuna?color=purple\u0026style=flat-square) | **Commits**: Frequência de updates no código. |\n| 💾 | ![Tamanho do Repo](https://img.shields.io/github/repo-size/hiudyy/nazuna?color=orange\u0026style=flat-square) | **Tamanho do Repo**: Espaço ocupado no GitHub. |\n| 👥 | ![Contribuidores](https://img.shields.io/github/contributors/hiudyy/nazuna?color=cyan\u0026style=flat-square) | **Contribuidores**: Pessoas que ajudaram no bot. |\n| 📥 | ![Downloads](https://img.shields.io/github/downloads/hiudyy/nazuna/total?color=pink\u0026style=flat-square) | **Downloads**: Total de downloads do projeto. |\n| 🌐 | ![Linguagens](https://img.shields.io/github/languages/top/hiudyy/nazuna?color=teal\u0026style=flat-square) | **Linguagens**: Principais linguagens do projeto. |\n| 🔄 | ![PRs](https://img.shields.io/github/issues-pr/hiudyy/nazuna?color=brightgreen\u0026style=flat-square) | **Pull Requests**: Propostas de melhorias enviadas. |\n| ⏱️ | ![Tempo de Resposta](https://img.shields.io/github/issues-closed-raw/hiudyy/nazuna?color=blueviolet\u0026style=flat-square) | **Tempo de Resposta**: Média pra resolver issues. |\n| 📜 | ![Licença](https://img.shields.io/badge/licença-Copyright-red?style=flat-square) | **Licença**: Projeto protegido por copyright. |\n| ✅ | ![Status](https://img.shields.io/badge/STATUS-ATIVO-success?style=flat-square) | **Status**: Projeto ativo e em desenvolvimento. |\n\n📈 **Visitas Totais**:  \n![Contador de Visitas](https://count.getloli.com/@nazuninha-bot?name=nazuninha-bot\u0026theme=booru-lewd\u0026padding=8\u0026offset=0\u0026align=top\u0026scale=2\u0026pixelated=1\u0026darkmode=1)  \n*Quantas pessoas visitaram o projeto.*\n\n---\n\n### 📢 **Canal Oficial no WhatsApp**\n\nFique por dentro de novidades, dicas exclusivas e updates!  \n[![Canal WhatsApp](https://img.shields.io/badge/Entrar-WhatsApp-25D366?style=flat-square\u0026logo=whatsapp)](https://whatsapp.com/channel/0029Vb6Ezk6LI8YXPgZPUJ2b)  \n*Junte-se ao canal pra suporte e conteúdos exclusivos.*\n\n---\n\n### 🤖 **O que é o nazuna Bot?**\n\nO **nazuna Bot** é um bot foda pro WhatsApp, feito com **Node.js** e **Baileys**. Ele é um assistente completo: automatiza tarefas, gerencia grupos, e tem comandos pra tudo, desde administração até diversão. Perfeito pra iniciantes e altamente customizável pra quem manja de código.\n\n\u003e ⚠️ **Aviso Sério**: O nazuna Bot é **protegido por copyright**. Tirar créditos, vender ou distribuir versões modificadas sem permissão é crime e pode te meter em encrenca legal.\n\n### 🎉 **Por que o nazuna Bot é Incrível?**\n\n- **Configuração Fácil**: Conecta com QR code ou código de pareamento em minutos.\n- **Super Versátil**: Gerencia grupos, traz utilitários e anima com comandos divertidos.\n- **Roda em Tudo**: Windows, Linux, macOS, Android (Termux) ou servidores como Pterodactyl.\n- **Sempre Atualizado**: Novas features e correções chegam com frequência.\n- **Seguro e Estável**: Usa o modo multi-dispositivos do WhatsApp pra rodar liso e seguro.\n\n\u003e 💡 **Curioso?** Após configurar, digite `/menu` no WhatsApp pra explorar os comandos!\n\n---\n\n### 📜 **Índice**\n\n1. [🚀 Primeiros Passos](#-primeiros-passos)\n2. [📋 Pré-requisitos](#-pré-requisitos)\n3. [📥 Instalação](#-instalação)\n4. [🚀 Rodando o Bot](#-rodando-o-bot)\n5. [🔌 Conectando ao WhatsApp](#-conectando-ao-whatsapp)\n6. [🔄 Atualizando o Bot](#-atualizando-o-bot)\n7. [💻 Tutoriais por Plataforma](#-tutoriais-por-plataforma)\n   - [🖥️ Windows](#-windows)\n   - [🐧 Linux](#-linux)\n   - [📱 Termux (Android)](#-termux-android)\n   - [☁️ Pterodactyl](#-pterodactyl)\n8. [❓ Resolvendo Problemas](#-resolvendo-problemas)\n9. [💖 Apoie o Projeto](#-apoie-o-projeto)\n10. [📜 Licença](#-licença)\n11. [👤 Sobre o Criador](#-sobre-o-criador)\n12. [❔ FAQ Avançado](#-faq-avançado)\n\n---\n\n#### 🚀 **Primeiros Passos**\n\nNovo no **nazuna Bot**? Comece com esses passos simples:\n\n1. **Prepare o ambiente**: Instale Node.js e Git (veja [Pré-requisitos](#-pré-requisitos)).\n2. **Baixe o bot**: Clone o repositório do GitHub.\n3. **Conecte ao WhatsApp**: Use um número secundário pra evitar riscos.\n4. **Explore os comandos**: Digite `/menu` no WhatsApp pra ver o que o bot faz.\n\n\u003e 💡 **Dica de Iniciante**: Parece complicado? Relaxa, cada seção explica tudo passo a passo!\n\n---\n\n#### 📋 **Pré-requisitos**\n\nVocê vai precisar de:\n\n| **Item**            | **Descrição**                                                                 |\n|---------------------|-------------------------------------------------------------------------------|\n| **Node.js**         | Versão 18 ou superior. Baixe em [nodejs.org](https://nodejs.org).             |\n| **Git**             | Pra clonar o repositório. Pega em [git-scm.com](https://git-scm.com).        |\n| **WhatsApp**        | Um número dedicado pro bot (evite o principal pra não levar ban).             |\n| **Internet Estável**| Necessária pra configuração e funcionamento.                                  |\n| **Dispositivo**     | PC (Windows, Linux, macOS), Android com Termux, ou servidor (Pterodactyl).    |\n| **Recursos Mínimos**| 512MB de RAM e 512MB de armazenamento (1GB RAM e 2GB disco recomendados).     |\n\n\u003e ⚠️ **Atenção**: Use um número secundário pro bot pra proteger sua conta principal do WhatsApp.\n\n---\n\n#### 📥 **Instalação**\n\nBora botar o **nazuna Bot** pra rodar:\n\n1. **Clonar o Repositório**  \n   Abra o terminal (Prompt de Comando, PowerShell ou Termux) e execute:  \n   ```bash\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   ```\n\n2. **Instalar Dependências**  \n   Rode esses comandos, um por vez:  \n   ```bash\n   npm run config\n   npm run config:install\n   ```  \n   Isso baixa todas as bibliotecas necessárias.\n\n   \u003e **Deu Erro?**: Confirme se o Node.js tá instalado (`node -v`). Se continuar, tente `npm install`.\n\n---\n\n#### 🚀 **Rodando o Bot**\n\nPra ligar o **nazuna Bot**:  \n```bash\nnpm start\n```\n\nEle vai te guiar pra conectar ao WhatsApp (próxima seção).\n\n\u003e 💡 **Primeira Vez**: Você precisa autenticar com QR code ou código de pareamento. Depois, reconecta sozinho.\n\n---\n\n#### 🔌 **Conectando ao WhatsApp**\n\nO **nazuna Bot** usa o **modo multi-dispositivos** do WhatsApp, então o celular não precisa ficar ligado após a configuração. Escolha um método:\n\n1. **QR Code**  \n   - O terminal mostra um QR code (quadrado com padrões).  \n   - No celular, abra o WhatsApp:  \n     1. Vá em **Configurações** \u003e **Aparelhos Conectados**.  \n     2. Clique em **Conectar um Aparelho**.  \n     3. Escaneie o QR code com a câmera.  \n   - Conectado na moral!  \n\n2. **Código de Pareamento**  \n   - Perfeito pra dispositivos sem câmera.  \n   - Digite o número do bot (ex.: `+5511999999999`).  \n   - O terminal dá um código (ex.: `1234-5678`).  \n   - No WhatsApp:  \n     1. Vá em **Configurações** \u003e **Aparelhos Conectados**.  \n     2. Clique em **Conectar com Número de Telefone**.  \n     3. Insira o código.  \n   - Tô dentro!\n\n\u003e ⚠️ **Cuidado**:  \n\u003e - Use número secundário pra evitar ban.  \n\u003e - QR code expirou? Rode `npm start` de novo.  \n\u003e - A sessão é salva, então reconexões são automáticas, exceto se deslogar.\n\n---\n\n#### 🔄 **Atualizando o Bot**\n\nPra manter na última versão:  \n```bash\nnpm run update\n```\n\nAtualiza sem mexer nas configs ou chats.\n\n\u003e ✅ **Tranquilo**: Updates são seguros e não apagam nada.\n\n---\n\n#### 💻 **Tutoriais por Plataforma**\n\n**Onde tá rodando o bot?** Escolha sua plataforma:\n\n##### 🖥️ **Windows**\n\n1. **Pré-requisitos**  \n   - Baixe e instale o [Node.js](https://nodejs.org) (LTS recomendado).  \n   - Instale o [Git](https://git-scm.com/downloads) pro Windows.  \n   - Verifique:  \n     ```bash\n     node -v\n     git --version\n     ```\n\n2. **Clonar e Instalar**  \n   Abra o Prompt de Comando ou PowerShell:  \n   ```bash\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   npm run config\n   npm run config:install\n   ```\n\n3. **Rodar o Bot**  \n   ```bash\n   npm start\n   ```\n\n4. **Manter Online**  \n   - Use o [NSSM](https://nssm.cc/) pra rodar 24/7:  \n     ```bash\n     nssm install nazuna \"C:\\caminho\\para\\node.exe\" \"C:\\caminho\\para\\nazuna\\app.js\"\n     ```\n   - Ou deixe o Prompt aberto (não feche!).\n\n\u003e 💡 **Dica**: Bot parou? Cheque a conexão ou rode `npm start` novamente.\n\n##### 🐧 **Linux**\n\n1. **Pré-requisitos**  \n   Atualize e instale:  \n   ```bash\n   sudo apt update \u0026\u0026 sudo apt install -y nodejs git\n   ```  \n   Verifique:  \n   ```bash\n   node -v\n   git --version\n   ```\n\n2. **Clonar e Instalar**  \n   ```bash\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   npm run config\n   npm run config:install\n   ```\n\n3. **Rodar o Bot**  \n   ```bash\n   npm start\n   ```\n\n4. **Rodar em Segundo Plano**  \n   Use o `pm2`:  \n   ```bash\n   npm install -g pm2\n   pm2 start npm --name \"nazuna\" -- start\n   pm2 save\n   ```  \n   Monitore com `pm2 logs nazuna`.\n\n\u003e 💡 **Dica**: Desconectou? Reinicie com `pm2 restart nazuna`.\n\n##### 📱 **Termux (Android)**\n\n1. **Instalar o Termux**  \n   - Baixe pelo [F-Droid](https://f-droid.org/packages/com.termux/) (evite Google Play).  \n   - Atualize:  \n     ```bash\n     pkg update \u0026\u0026 pkg upgrade -y\n     ```\n\n2. **Pré-requisitos**  \n   ```bash\n   pkg install nodejs git -y\n   termux-setup-storage\n   ```\n\n3. **Clonar e Instalar**  \n   ```bash\n   cd /sdcard\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   npm run config\n   npm run config:install\n   ```\n\n4. **Rodar o Bot**  \n   ```bash\n   npm start\n   ```\n\n5. **Manter Online**  \n   - Evite fechar o Termux; mantenha o celular ligado ou use app de “manter acordado”.  \n   - Se parar, reinicie:  \n     ```bash\n     cd /sdcard/nazuna\n     npm start\n     ```\n\n\u003e 💡 **Dica**: “Permissão negada”? Rode `termux-setup-storage` de novo.\n\n##### ☁️ **Pterodactyl**\n\nConfigure o **nazuna Bot** no Pterodactyl de duas formas:\n\n**Opção 1: Egg Oficial da nazuna**\n\n1. **Baixar o Egg**  \n   - Pegue o egg em: [github.com/hiudyy/nazu-files/egg-ptero.json](https://github.com/hiudyy/nazu-files/egg-ptero.json).  \n   - Importe no painel Pterodactyl (**Eggs** \u003e **Import Egg**).\n\n2. **Criar o Servidor**  \n   - Crie um servidor com o egg da nazuna.  \n   - No **Startup**, configure:  \n     - **Nome do Dono**: Seu nome/apelido (ex.: `João`).  \n     - **Número do Bot**: Número com código do país (ex.: `+5511999999999`).  \n     - **Prefixo do Bot**: Símbolo pros comandos (ex.: `/`).  \n     - **Nome do Bot**: Nome no WhatsApp (ex.: `nazuna`).  \n     - **Atualização Automática**: `Sim` pra updates automáticos ou `Não` pra manual.  \n   - Recursos mínimos: 512MB RAM e 512MB disco (1GB RAM e 2GB disco recomendados).\n\n3. **Iniciar o Servidor**  \n   - Clique em **Iniciar** no painel.  \n   - O egg clona o repo (`https://github.com/hiudyy/nazuna.git`) e instala tudo.  \n   - Conecte ao WhatsApp via QR code ou código de pareamento (use console ou VNC).\n\n4. **Manter Online**  \n   - O Pterodactyl roda 24/7.  \n   - Sem atualização automática? Rode:  \n     ```bash\n     npm run update\n     ```\n\n**Opção 2: Egg Node.js Comum**\n\n1. **Criar o Servidor**  \n   - Crie um servidor com o egg **Node.js** padrão.  \n   - Defina o **Comando de Inicialização** como: `npm start`.  \n   - Recursos mínimos: 512MB RAM e 512MB disco (1GB RAM e 2GB disco recomendados).\n\n2. **Clonar o Repositório**  \n   - No console do Pterodactyl:  \n     ```bash\n     git clone https://github.com/hiudyy/nazuna.git\n     cd nazuna\n     ```\n\n3. **Instalar Dependências**  \n   - Execute:  \n     ```bash\n     npm run config\n     npm run config:install\n     ```\n\n4. **Iniciar o Bot**  \n   - Inicie o servidor no painel.  \n   - Conecte ao WhatsApp com QR code ou código.\n\n5. **Atualizações**  \n   - Atualize manualmente:  \n     ```bash\n     npm run update\n     ```\n\n\u003e 💡 **Dica**: O egg oficial automatiza tudo, é mais fácil!\n\n---\n\n#### ❓ **Resolvendo Problemas**\n\nDeu pau? Soluções pros problemas mais comuns:\n\n| **Problema**                     | **Solução**                                                                 |\n|----------------------------------|-----------------------------------------------------------------------------|\n| **“Comando não encontrado”**     | Instale Git/Node.js (`pkg install git nodejs` no Termux).                   |\n| **QR Code não funciona**         | Atualize o WhatsApp, gere outro QR com `npm start`, ou cheque a internet.   |\n| **Bot desconecta**               | Reinicie com `npm start`, apague a pasta `sessions`, ou troque o número.    |\n| **Erro na instalação**           | Rode `npm install`, verifique Node.js 18+ (`node -v`), ou atualize pacotes. |\n| **Termux para**                  | Mantenha o celular ligado e reinicie com `cd /sdcard/nazuna \u0026\u0026 npm start`. |\n\n\u003e 😊 **Tá na Merda?** Cola no [Canal do WhatsApp](https://whatsapp.com/channel/0029Vb6Ezk6LI8YXPgZPUJ2b) pra suporte!\n\n---\n\n#### 💖 **Apoie o Projeto**\n\nFazer o **nazuna Bot** é um trampo danado. Seu apoio é tudo:\n\n- **🌍 Global (Patreon)**  \n  [![Apoiar no Patreon](https://img.shields.io/badge/Apoiar-Patreon-orange?style=flat-square\u0026logo=patreon)](https://patreon.com/hiudyy)  \n  *Contribua mensalmente pra manter o projeto vivo.*\n\n- **🇧🇷 Brasil (Pix)**  \n  **Chave Pix (E-mail):** `lua.bot@hotmail.com`  \n  *Qualquer valor já ajuda pra caramba.*\n\n\u003e ❤️ **Valeu!** Cada real motiva mais features e melhorias!\n\n---\n\n#### 📜 **Licença**\n\n© 2025 **Hiudy**. Todos os direitos reservados.\n\nO **nazuna Bot** é **protegido por copyright**. Não remova os créditos, não venda, e não distribua versões modificadas sem autorização. Violações podem levar a ações legais.\n\n---\n\n#### 👤 **Sobre o Criador**\n\nFeito com ❤️ por [**Hiudy**](https://github.com/hiudyy), um dev apaixonado por criar ferramentas que tornam a tecnologia mais divertida e acessível. Ele tá sempre bolando projetos novos e dando aquele gás no nazuna Bot pra comunidade.\n\n**Estatísticas do Hiudy**:\n\n| Ícone | Badge | Descrição |\n|-------|-------|-----------|\n| 👥 | ![Seguidores](https://img.shields.io/github/followers/hiudyy?color=blue\u0026style=flat-square) | **Seguidores**: Quantas pessoas acompanham o Hiudy no GitHub. |\n| 📝 | ![Contribuições](https://img.shields.io/github/commit-activity/y/hiudyy/nazuna) | **Contribuições**: Atividade anual do Hiudy em todos os projetos. |\n| 💬 | ![Discord](https://img.shields.io/badge/Discord-hiudyyy-7289DA?style=flat-square\u0026logo=discord) | **Discord**: Conecte-se com o Hiudy no Discord. |\n| 📷 | ![Instagram](https://img.shields.io/badge/Instagram-hiudyyy_-E4405F?style=flat-square\u0026logo=instagram) | **Instagram**: Siga o Hiudy no Insta pra novidades. |\n\n**Bio**:  \nHiudy é um entusiasta de tech que curte criar soluções práticas e com aquele toque de diversão. Além do nazuna Bot, ele contribui pra projetos open-source e ama trocar ideia com a comunidade. Cola nas redes dele pra acompanhar os próximos rolês!\n\n- 📍 **GitHub**: [hiudyy](https://github.com/hiudyy)\n- 💬 **Discord**: [hiudyyy](https://discord.com/users/hiudyyy)\n- 📷 **Instagram**: [hiudyyy_](https://instagram.com/hiudyyy_)\n\n\u003e 🌟 **Gostou?** Dá uma estrela no GitHub e compartilha com a galera!\n\n---\n\n#### ❔ **FAQ Avançado**\n\n| **Pergunta**                              | **Resposta**                                                                 |\n|------------------------------------------|-----------------------------------------------------------------------------|\n| **Posso usar meu número principal?**      | Não é recomendado. Use um número secundário pra evitar riscos de banimento. |\n| **O bot funciona offline?**               | Não, precisa de internet pra se conectar ao WhatsApp.                       |\n| **Como personalizo os comandos?**         | Edite o `config.json` após instalar (veja a documentação).                  |\n| **E se meu servidor Pterodactyl travar?** | Reinicie o servidor e cheque os logs no console do Pterodactyl.             |\n\n\u003e 💡 **Mais Dúvidas?** Pergunte no [Canal do WhatsApp](https://whatsapp.com/channel/0029Vb6Ezk6LI8YXPgZPUJ2b)!\n\n\u003c/details\u003e\n\n---\n\n## 🇺🇸 **English**\n\n\u003cdetails\u003e\n\u003csummary\u003e💻 Click to Expand English Instructions\u003c/summary\u003e\n\n### 📊 **Project Statistics**\n\nReal-time metrics for **nazuna Bot**, with what each one means:\n\n| Icon | Badge | Description |\n|------|-------|-------------|\n| 🕒 | ![Last Update](https://img.shields.io/github/last-commit/hiudyy/nazuna?color=blue\u0026style=flat-square) | **Last Update**: When the project was last updated. |\n| ⭐ | ![Stars](https://img.shields.io/github/stars/hiudyy/nazuna?color=yellow\u0026label=Stars\u0026style=flat-square) | **Stars**: Number of people who starred it on GitHub. |\n| 🍴 | ![Forks](https://img.shields.io/github/forks/hiudyy/nazuna?color=green\u0026style=flat-square) | **Forks**: Copies of the project made by other devs. |\n| 🐞 | ![Issues](https://img.shields.io/github/issues/hiudyy/nazuna?color=red\u0026style=flat-square) | **Issues**: Bugs or suggestions reported by the community. |\n| 📝 | ![Commits](https://img.shields.io/github/commit-activity/m/hiudyy/nazuna?color=purple\u0026style=flat-square) | **Commits**: Frequency of code updates. |\n| 💾 | ![Repo Size](https://img.shields.io/github/repo-size/hiudyy/nazuna?color=orange\u0026style=flat-square) | **Repo Size**: Space used by the project on GitHub. |\n| 👥 | ![Contributors](https://img.shields.io/github/contributors/hiudyy/nazuna?color=cyan\u0026style=flat-square) | **Contributors**: People who helped build the bot. |\n| 📥 | ![Downloads](https://img.shields.io/github/downloads/hiudyy/nazuna/total?color=pink\u0026style=flat-square) | **Downloads**: Total downloads of the project. |\n| 🌐 | ![Languages](https://img.shields.io/github/languages/top/hiudyy/nazuna?color=teal\u0026style=flat-square) | **Languages**: Main languages used in the project. |\n| 🔄 | ![PRs](https://img.shields.io/github/issues-pr/hiudyy/nazuna?color=brightgreen\u0026style=flat-square) | **Pull Requests**: Improvement proposals from the community. |\n| ⏱️ | ![Response Time](https://img.shields.io/github/issues-closed-raw/hiudyy/nazuna?color=blueviolet\u0026style=flat-square) | **Response Time**: Average time to resolve issues. |\n| 📜 | ![License](https://img.shields.io/badge/license-Copyright-red?style=flat-square) | **License**: Project is copyright-protected. |\n| ✅ | ![Status](https://img.shields.io/badge/STATUS-ACTIVE-success?style=flat-square) | **Status**: Project is active and under development. |\n\n📈 **Total Visits**:  \n![Visit Counter](https://count.getloli.com/@nazuninha-bot?name=nazuninha-bot\u0026theme=booru-lewd\u0026padding=8\u0026offset=0\u0026align=top\u0026scale=2\u0026pixelated=1\u0026darkmode=1)  \n*Tracks how many people visited the project.*\n\n---\n\n### 📢 **Official WhatsApp Channel**\n\nStay in the loop with news, exclusive tips, and updates!  \n[![WhatsApp Channel](https://img.shields.io/badge/Join-WhatsApp-25D366?style=flat-square\u0026logo=whatsapp)](https://whatsapp.com/channel/0029Vb6Ezk6LI8YXPgZPUJ2b)  \n*Join our channel for support and exclusive content.*\n\n---\n\n### 🤖 **What is nazuna Bot?**\n\n**nazuna Bot** is an epic WhatsApp bot built with **Node.js** and **Baileys**. It’s like a supercharged assistant: automates tasks, manages groups, and offers commands for everything from admin tasks to fun. Perfect for beginners and highly customizable for coders.\n\n\u003e ⚠️ **Serious Warning**: nazuna Bot is **copyright-protected**. Removing credits, selling, or distributing modified versions without permission is illegal and may lead to legal trouble.\n\n### 🎉 **Why nazuna Bot Rocks?**\n\n- **Easy Setup**: Connect with QR code or pairing code in minutes.\n- **Super Versatile**: Manages groups, provides utilities, and spices things up with fun commands.\n- **Runs Anywhere**: Windows, Linux, macOS, Android (Termux), or servers like Pterodactyl.\n- **Always Fresh**: New features and fixes roll out regularly.\n- **Safe \u0026 Smooth**: Uses WhatsApp’s multi-device mode for stability and security.\n\n\u003e 💡 **Curious?** After setup, type `/menu` in WhatsApp to explore commands!\n\n---\n\n### 📜 **Table of Contents**\n\n1. [🚀 Getting Started](#-getting-started)\n2. [📋 Prerequisites](#-prerequisites)\n3. [📥 Installation](#-installation)\n4. [🚀 Running the Bot](#-running-the-bot)\n5. [🔌 Connecting to WhatsApp](#-connecting-to-whatsapp)\n6. [🔄 Updating the Bot](#-updating-the-bot)\n7. [💻 Platform Tutorials](#-platform-tutorials)\n   - [🖥️ Windows](#-windows)\n   - [🐧 Linux](#-linux)\n   - [📱 Termux (Android)](#-termux-android)\n   - [☁️ Pterodactyl](#-pterodactyl)\n8. [❓ Troubleshooting](#-troubleshooting)\n9. [💖 Support the Project](#-support-the-project)\n10. [📜 License](#-license)\n11. [👤 About the Creator](#-about-the-creator)\n12. [❔ Advanced FAQ](#-advanced-faq)\n\n---\n\n#### 🚀 **Getting Started**\n\nNew to **nazuna Bot**? Start with these simple steps:\n\n1. **Set up your environment**: Install Node.js and Git (see [Prerequisites](#-prerequisites)).\n2. **Download the bot**: Clone the GitHub repository.\n3. **Connect to WhatsApp**: Use a secondary number to avoid risks.\n4. **Explore commands**: Type `/menu` in WhatsApp to see what the bot can do.\n\n\u003e 💡 **Beginner Tip**: Looks complex? Chill, each section breaks it down step-by-step!\n\n---\n\n#### 📋 **Prerequisites**\n\nYou’ll need:\n\n| **Item**            | **Description**                                                               |\n|--------------------|-------------------------------------------------------------------------------|\n| **Node.js**        | Version 18 or higher. Download from [nodejs.org](https://nodejs.org).         |\n| **Git**            | To clone the repository. Get it from [git-scm.com](https://git-scm.com).      |\n| **WhatsApp**       | A dedicated number for the bot (avoid your main number to prevent bans).      |\n| **Stable Internet**| Essential for setup and operation.                                            |\n| **Device**         | PC (Windows, Linux, macOS), Android with Termux, or server (Pterodactyl).     |\n| **Minimum Specs**  | 512MB RAM and 512MB storage (1GB RAM and 2GB storage recommended).            |\n\n\u003e ⚠️ **Warning**: Use a secondary number for the bot to protect your main WhatsApp account.\n\n---\n\n#### 📥 **Installation**\n\nLet’s get **nazuna Bot** running:\n\n1. **Clone the Repository**  \n   Open your terminal (Command Prompt, PowerShell, or Termux) and run:  \n   ```bash\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   ```\n\n2. **Install Dependencies**  \n   Run these one at a time:  \n   ```bash\n   npm run config\n   npm run config:install\n   ```  \n   This grabs all required libraries.\n\n   \u003e **Error?**: Check if Node.js is installed (`node -v`). If issues persist, try `npm install`.\n\n---\n\n#### 🚀 **Running the Bot**\n\nTo fire up **nazuna Bot**:  \n```bash\nnpm start\n```\n\nIt’ll guide you to connect to WhatsApp (next section).\n\n\u003e 💡 **First Run**: You’ll need to authenticate with a QR code or pairing code. After that, it usually reconnects automatically.\n\n---\n\n#### 🔌 **Connecting to WhatsApp**\n\n**nazuna Bot** uses WhatsApp’s **multi-device mode**, so your phone doesn’t need to stay online after setup. Pick a method:\n\n1. **QR Code**  \n   - The terminal shows a QR code (a square with patterns).  \n   - On your phone, open WhatsApp:  \n     1. Go to **Settings** \u003e **Linked Devices**.  \n     2. Tap **Link a Device**.  \n     3. Scan the QR code with your camera.  \n   - Boom, connected!  \n\n2. **Pairing Code**  \n   - Great for devices without a camera.  \n   - Enter the bot’s number (e.g., `+12025550123`).  \n   - The terminal gives a code (e.g., `1234-5678`).  \n   - In WhatsApp:  \n     1. Go to **Settings** \u003e **Linked Devices**.  \n     2. Tap **Link with Phone Number**.  \n     3. Enter the code.  \n   - You’re in!\n\n\u003e ⚠️ **Caution**:  \n\u003e - Use a secondary number to avoid bans.  \n\u003e - QR code expired? Run `npm start` again.  \n\u003e - Session is saved, so reconnections are automatic unless you log out.\n\n---\n\n#### 🔄 **Updating the Bot**\n\nKeep it fresh:  \n```bash\nnpm run update\n```\n\nUpdates without messing with your settings or chats.\n\n\u003e ✅ **Safe**: Updates won’t wipe anything.\n\n---\n\n#### 💻 **Platform Tutorials**\n\n**Where you running the bot?** Pick your platform:\n\n##### 🖥️ **Windows**\n\n1. **Prerequisites**  \n   - Download and install [Node.js](https://nodejs.org) (LTS recommended).  \n   - Install [Git](https://git-scm.com/downloads) for Windows.  \n   - Verify:  \n     ```bash\n     node -v\n     git --version\n     ```\n\n2. **Clone and Install**  \n   Open Command Prompt or PowerShell:  \n   ```bash\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   npm run config\n   npm run config:install\n   ```\n\n3. **Run the Bot**  \n   ```bash\n   npm start\n   ```\n\n4. **Keep It Online**  \n   - Use [NSSM](https://nssm.cc/) to run 24/7:  \n     ```bash\n     nssm install nazuna \"C:\\path\\to\\node.exe\" \"C:\\path\\to\\nazuna\\app.js\"\n     ```\n   - Or keep the Command Prompt open (don’t close!).\n\n\u003e 💡 **Tip**: Bot stopped? Check internet or rerun `npm start`.\n\n##### 🐧 **Linux**\n\n1. **Prerequisites**  \n   Update and install:  \n   ```bash\n   sudo apt update \u0026\u0026 sudo apt install -y nodejs git\n   ```  \n   Verify:  \n   ```bash\n   node -v\n   git --version\n   ```\n\n2. **Clone and Install**  \n   ```bash\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   npm run config\n   npm run config:install\n   ```\n\n3. **Run the Bot**  \n   ```bash\n   npm start\n   ```\n\n4. **Run in Background**  \n   Use `pm2`:  \n   ```bash\n   npm install -g pm2\n   pm2 start npm --name \"nazuna\" -- start\n   pm2 save\n   ```  \n   Monitor with `pm2 logs nazuna`.\n\n\u003e 💡 **Tip**: Disconnected? Restart with `pm2 restart nazuna`.\n\n##### 📱 **Termux (Android)**\n\n1. **Install Termux**  \n   - Download from [F-Droid](https://f-droid.org/packages/com.termux/) (avoid Google Play).  \n   - Update Termux:  \n     ```bash\n     pkg update \u0026\u0026 pkg upgrade -y\n     ```\n\n2. **Prerequisites**  \n   ```bash\n   pkg install nodejs git -y\n   termux-setup-storage\n   ```\n\n3. **Clone and Install**  \n   ```bash\n   cd /sdcard\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   npm run config\n   npm run config:install\n   ```\n\n4. **Run the Bot**  \n   ```bash\n   npm start\n   ```\n\n5. **Keep It Online**  \n   - Prevent Termux from closing; keep phone awake (use charger or “stay awake” app).  \n   - If it stops, restart:  \n     ```bash\n     cd /sdcard/nazuna\n     npm start\n     ```\n\n\u003e 💡 **Tip**: “Permission denied”? Rerun `termux-setup-storage`.\n\n##### ☁️ **Pterodactyl**\n\nSet up **nazuna Bot** on Pterodactyl in two ways:\n\n**Option 1: Official nazuna Egg**\n\n1. **Download the Egg**  \n   - Grab the egg at: [github.com/hiudyy/nazu-files/egg-ptero.json](https://github.com/hiudyy/nazu-files/egg-ptero.json).  \n   - Import it in your Pterodactyl panel (**Eggs** \u003e **Import Facet Import Egg**).\n\n2. **Create the Server**  \n   - Create a server with the nazuna egg.  \n   - In **Startup**, configure:  \n     - **Owner Name**: Your name/nickname (e.g., `John`).  \n     - **Bot Number**: Number with country code (e.g., `+12025550123`).  \n     - **Bot Prefix**: Symbol for commands (e.g., `/`).  \n     - **Bot Name**: Name shown in WhatsApp (e.g., `nazuna`).  \n     - **Auto Update**: `Yes` for automatic updates or `No` for manual.  \n   - Minimum specs: 512MB RAM and 512MB storage (1GB RAM and 2GB storage recommended).\n\n3. **Start the Server**  \n   - Click **Start** in the panel.  \n   - The egg auto-clones the repo (`https://github.com/hiudyy/nazuna.git`) and installs dependencies.  \n   - Connect to WhatsApp via QR code or pairing code (use console or VNC).\n\n4. **Keep It Online**  \n   - Pterodactyl runs it 24/7.  \n   - For manual updates, run:  \n     ```bash\n     npm run update\n     ```\n\n**Option 2: Generic Node.js Egg**\n\n1. **Create the Server**  \n   - Create a server with the default **Node.js** egg.  \n   - Set **Startup Command** to: `npm start`.  \n   - Minimum specs: 512MB RAM and 512MB storage (1GB RAM and 2GB storage recommended).\n\n2. **Clone the Repository**  \n   - In Pterodactyl console:  \n     ```bash\n     git clone https://github.com/hiudyy/nazuna.git\n     cd nazuna\n     ```\n\n3. **Install Dependencies**  \n   - Run:  \n     ```bash\n     npm run config\n     npm run config:install\n     ```\n\n4. **Start the Bot**  \n   - Start the server in the panel.  \n   - Connect to WhatsApp with QR code or pairing code.\n\n5. **Updates**  \n   - Update manually:  \n     ```bash\n     npm run update\n     ```\n\n\u003e 💡 **Tip**: The official egg automates everything, so it’s easier!\n\n---\n\n#### ❓ **Troubleshooting**\n\nGot issues? Fixes for common problems:\n\n| **Issue**                        | **Solution**                                                               |\n|----------------------------------|---------------------------------------------------------------------------|\n| **“Command not found”**          | Install Git/Node.js (`pkg install git nodejs` in Termux).                 |\n| **QR Code doesn’t work**         | Update WhatsApp, generate new QR with `npm start`, or check internet.     |\n| **Bot disconnects**              | Restart with `npm start`, delete `sessions` folder, or switch numbers.    |\n| **Installation errors**          | Run `npm install`, verify Node.js 18+ (`node -v`), or update packages.    |\n| **Termux stops**                 | Keep phone awake and restart with `cd /sdcard/nazuna \u0026\u0026 npm start`.|\n\n\u003e 😊 **Still Stuck?** Hit up our [WhatsApp Channel](https://whatsapp.com/channel/0029Vb6Ezk6LI8YXPgZPUJ2b) for help!\n\n---\n\n#### 💖 **Support the Project**\n\nBuilding **nazuna Bot** is a ton of work. Your support keeps it alive:\n\n- **🌍 Global (Patreon)**  \n  [![Support on Patreon](https://img.shields.io/badge/Support-Patreon-orange?style=flat-square\u0026logo=patreon)](https://patreon.com/hiudyy)  \n  *Contribute monthly to keep the project going.*\n\n- **🇧🇷 Brazil (Pix)**  \n  **Pix Key (Email):** `lua.bot@hotmail.com`  \n  *Any amount helps a ton.*\n\n\u003e ❤️ **Thanks!** Every bit fuels new features and improvements!\n\n---\n\n#### 📜 **License**\n\n© 2025 **Hiudy**. All rights reserved.\n\n**nazuna Bot** is **copyright-protected**. Don’t remove credits, sell, or distribute modified versions without permission. Violations may lead to legal action.\n\n---\n\n#### 👤 **About the Creator**\n\nBuilt with ❤️ by [**Hiudy**](https://github.com/hiudyy), a dev passionate about making tech fun and accessible. He’s always cooking up new projects and leveling up nazuna Bot for the community.\n\n**Hiudy’s Stats**:\n\n| Icon | Badge | Description |\n|------|-------|-------------|\n| 👥 | ![Followers](https://img.shields.io/github/followers/hiudyy?color=blue\u0026style=flat-square) | **Followers**: Number of people following Hiudy on GitHub. |\n| 📝 | ![Contributions](https://img.shields.io/github/commit-activity/y/hiudyy/nazuna) | **Contributions**: Hiudy’s yearly activity across projects. |\n| 💬 | ![Discord](https://img.shields.io/badge/Discord-hiudyyy-7289DA?style=flat-square\u0026logo=discord) | **Discord**: Connect with Hiudy on Discord. |\n| 📷 | ![Instagram](https://img.shields.io/badge/Instagram-hiudyyy_-E4405F?style=flat-square\u0026logo=instagram) | **Instagram**: Follow Hiudy on Insta for updates. |\n\n**Bio**:  \nHiudy’s a tech enthusiast who loves crafting practical, fun solutions. Beyond nazuna Bot, he contributes to open-source projects and vibes with the community. Hit him up on socials to catch his next big thing!\n\n- 📍 **GitHub**: [hiudyy](https://github.com/hiudyy)\n- 💬 **Discord**: [hiudyyy](https://discord.com/users/hiudyyy)\n- 📷 **Instagram**: [hiudyyy_](https://instagram.com/hiudyyy_)\n\n\u003e 🌟 **Dig It?** Star the project on GitHub and share with your crew!\n\n---\n\n#### ❔ **Advanced FAQ**\n\n| **Question**                             | **Answer**                                                                |\n|-----------------------------------------|---------------------------------------------------------------------------|\n| **Can I use my main number?**           | Not recommended. Use a secondary number to avoid ban risks.               |\n| **Does the bot work offline?**          | No, it needs internet to connect to WhatsApp.                            |\n| **How do I customize commands?**        | Edit `config.json` after installation (check docs).                      |\n| **What if my Pterodactyl server crashes?** | Restart the server and check logs in Pterodactyl console.               |\n\n\u003e 💡 **More Questions?** Ask in our [WhatsApp Channel](https://whatsapp.com/channel/0029Vb6Ezk6LI8YXPgZPUJ2b)!\n\n\u003c/details\u003e\n\n---\n\n## 🇪🇸 **Español**\n\n\u003cdetails\u003e\n\u003csummary\u003e💻 Haga clic para expandir las instrucciones en español\u003c/summary\u003e\n\n### 📊 **Estadísticas del Proyecto**\n\nMétricas en tiempo real del **nazuna Bot**, con lo que significa cada una:\n\n| Icono | Insignia | Descripción |\n|-------|----------|-------------|\n| 🕒 | ![Última Actualización](https://img.shields.io/github/last-commit/hiudyy/nazuna?color=blue\u0026style=flat-square) | **Última Actualización**: Cuándo se actualizó el proyecto por última vez. |\n| ⭐ | ![Estrellas](https://img.shields.io/github/stars/hiudyy/nazuna?color=yellow\u0026label=Estrellas\u0026style=flat-square) | **Estrellas**: Personas que dieron estrella en GitHub. |\n| 🍴 | ![Forks](https://img.shields.io/github/forks/hiudyy/nazuna?color=green\u0026style=flat-square) | **Forks**: Copias del proyecto hechas por otros devs. |\n| 🐞 | ![Issues](https://img.shields.io/github/issues/hiudyy/nazuna?color=red\u0026style=flat-square) | **Issues**: Errores o sugerencias reportados por la comunidad. |\n| 📝 | ![Commits](https://img.shields.io/github/commit-activity/m/hiudyy/nazuna?color=purple\u0026style=flat-square) | **Commits**: Frecuencia de actualizaciones del código. |\n| 💾 | ![Tamaño del Repo](https://img.shields.io/github/repo-size/hiudyy/nazuna?color=orange\u0026style=flat-square) | **Tamaño del Repo**: Espacio ocupado en GitHub. |\n| 👥 | ![Contribuidores](https://img.shields.io/github/contributors/hiudyy/nazuna?color=cyan\u0026style=flat-square) | **Contribuidores**: Personas que ayudaron a desarrollar el bot. |\n| 📥 | ![Descargas](https://img.shields.io/github/downloads/hiudyy/nazuna/total?color=pink\u0026style=flat-square) | **Descargas**: Total de descargas del proyecto. |\n| 🌐 | ![Lenguajes](https://img.shields.io/github/languages/top/hiudyy/nazuna?color=teal\u0026style=flat-square) | **Lenguajes**: Principales lenguajes del proyecto. |\n| 🔄 | ![PRs](https://img.shields.io/github/issues-pr/hiudyy/nazuna?color=brightgreen\u0026style=flat-square) | **Pull Requests**: Propuestas de mejoras enviadas. |\n| ⏱️ | ![Tiempo de Respuesta](https://img.shields.io/github/issues-closed-raw/hiudyy/nazuna?color=blueviolet\u0026style=flat-square) | **Tiempo de Respuesta**: Promedio para resolver issues. |\n| 📜 | ![Licencia](https://img.shields.io/badge/licencia-Copyright-red?style=flat-square) | **Licencia**: Proyecto protegido por derechos de autor. |\n| ✅ | ![Estado](https://img.shields.io/badge/ESTADO-ACTIVO-success?style=flat-square) | **Estado**: Proyecto activo y en desarrollo. |\n\n📈 **Visitas Totales**:  \n![Contador de Visitas](https://count.getloli.com/@nazuninha-bot?name=nazuninha-bot\u0026theme=booru-lewd\u0026padding=8\u0026offset=0\u0026align=top\u0026scale=2\u0026pixelated=1\u0026darkmode=1)  \n*Registra cuántas personas visitaron el proyecto.*\n\n---\n\n### 📢 **Canal Oficial de WhatsApp**\n\n¡Mantente al día con noticias, consejos exclusivos y actualizaciones!  \n[![Canal de WhatsApp](https://img.shields.io/badge/Unirse-WhatsApp-25D366?style=flat-square\u0026logo=whatsapp)](https://whatsapp.com/channel/0029Vb6Ezk6LI8YXPgZPUJ2b)  \n*Únete a nuestro canal para soporte y contenido exclusivo.*\n\n---\n\n### 🤖 **¿Qué es nazuna Bot?**\n\n**nazuna Bot** es un bot épico para WhatsApp, construido con **Node.js** y **Baileys**. Es como un asistente todo terreno: automatiza tareas, gestiona grupos y ofrece comandos para admin, utilidades y diversión. Ideal para principiantes y súper personalizable para programadores.\n\n\u003e ⚠️ **Advertencia Seria**: nazuna Bot está **protegido por derechos de autor**. Quitar créditos, vender o distribuir versiones modificadas sin permiso es ilegal y puede meterte en problemas legales.\n\n### 🎉 **¿Por qué nazuna Bot es Genial?**\n\n- **Configuración Fácil**: Conecta con código QR o de vinculación en minutos.\n- **Súper Versátil**: Gestiona grupos, ofrece herramientas y anima con comandos divertidos.\n- **Funciona en Todo**: Windows, Linux, macOS, Android (Termux) o servidores como Pterodactyl.\n- **Siempre Actualizado**: Nuevas funciones y correcciones llegan regularmente.\n- **Seguro y Fluido**: Usa el modo multidispositivo de WhatsApp para estabilidad y seguridad.\n\n\u003e 💡 **¿Curioso?** Tras configurarlo, escribe `/menu` en WhatsApp para explorar comandos.\n\n---\n\n### 📜 **Índice**\n\n1. [🚀 Primeros Pasos](#-primeros-pasos)\n2. [📋 Requisitos Previos](#-requisitos-previos)\n3. [📥 Instalación](#-instalación)\n4. [🚀 Ejecutando el Bot](#-ejecutando-el-bot)\n5. [🔌 Conectando a WhatsApp](#-conectando-a-whatsapp)\n6. [🔄 Actualizando el Bot](#-actualizando-el-bot)\n7. [💻 Tutoriales por Plataforma](#-tutoriales-por-plataforma)\n   - [🖥️ Windows](#-windows)\n   - [🐧 Linux](#-linux)\n   - [📱 Termux (Android)](#-termux-android)\n   - [☁️ Pterodactyl](#-pterodactyl)\n8. [❓ Solución de Problemas](#-solución-de-problemas)\n9. [💖 Apoyar el Proyecto](#-apoyar-el-proyecto)\n10. [📜 Licencia](#-licencia)\n11. [👤 Sobre el Creador](#-sobre-el-creador)\n12. [❔ FAQ Avanzado](#-faq-avanzado)\n\n---\n\n#### 🚀 **Primeros Pasos**\n\n¿Nuevo en **nazuna Bot**? Empieza con estos pasos simples:\n\n1. **Prepara tu entorno**: Instala Node.js y Git (ver [Requisitos Previos](#-requisitos-previos)).\n2. **Descarga el bot**: Clona el repositorio de GitHub.\n3. **Conecta a WhatsApp**: Usa un número secundario para evitar riesgos.\n4. **Explora comandos**: Escribe `/menu` en WhatsApp para ver qué hace el bot.\n\n\u003e 💡 **Consejo para Novatos**: ¿Parece complicado? Cada sección lo explica paso a paso.\n\n---\n\n#### 📋 **Requisitos Previos**\n\nNecesitarás:\n\n| **Elemento**       | **Descripción**                                                               |\n|--------------------|-------------------------------------------------------------------------------|\n| **Node.js**        | Versión 18 o superior. Descarga desde [nodejs.org](https://nodejs.org).       |\n| **Git**            | Para clonar el repositorio. Consíguelo en [git-scm.com](https://git-scm.com). |\n| **WhatsApp**       | Un número dedicado para el bot (evita tu número principal para prevenir bloqueos). |\n| **Internet Estable**| Esencial para configuración y operación.                                      |\n| **Dispositivo**    | PC (Windows, Linux, macOS), Android con Termux, o servidor (Pterodactyl).     |\n| **Especs Mínimas** | 512MB RAM y 512MB almacenamiento (1GB RAM y 2GB almacenamiento recomendados). |\n\n\u003e ⚠️ **Advertencia**: Usa un número secundario para proteger tu cuenta principal de WhatsApp.\n\n---\n\n#### 📥 **Instalación**\n\nVamos a poner **nazuna Bot** en marcha:\n\n1. **Clonar el Repositorio**  \n   Abre tu terminal (Símbolo del sistema, PowerShell o Termux) y ejecuta:  \n   ```bash\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   ```\n\n2. **Instalar Dependencias**  \n   Ejecuta uno por uno:  \n   ```bash\n   npm run config\n   npm run config:install\n   ```  \n   Esto descarga todas las bibliotecas necesarias.\n\n   \u003e **¿Error?**: Verifica si Node.js está instalado (`node -v`). Si persiste, prueba `npm install`.\n\n---\n\n#### 🚀 **Ejecutando el Bot**\n\nPara arrancar **nazuna Bot**:  \n```bash\nnpm start\n```\n\nTe guiará para conectar a WhatsApp (siguiente sección).\n\n\u003e 💡 **Primera Vez**: Necesitas autenticarte con código QR o de vinculación. Luego, suele reconectar solo.\n\n---\n\n#### 🔌 **Conectando a WhatsApp**\n\n**nazuna Bot** usa el **modo multidispositivo** de WhatsApp, así que no necesitas mantener el teléfono conectado tras configurar. Elige un método:\n\n1. **Código QR**  \n   - El terminal muestra un código QR (cuadrado con patrones).  \n   - En tu teléfono, abre WhatsApp:  \n     1. Ve a **Configuración** \u003e **Dispositivos Vinculados**.  \n     2. Toca **Vincular un Dispositivo**.  \n     3. Escanea el código QR con la cámara.  \n   - ¡Conectado!  \n\n2. **Código de Vinculación**  \n   - Ideal para dispositivos sin cámara.  \n   - Ingresa el número del bot (ej.: `+34912345678`).  \n   - El terminal da un código (ej.: `1234-5678`).  \n   - En WhatsApp:  \n     1. Ve a **Configuración** \u003e **Dispositivos Vinculados**.  \n     2. Toca **Vincular con Número de Teléfono**.  \n     3. Ingresa el código.  \n   - ¡Listo!\n\n\u003e ⚠️ **Precaución**:  \n\u003e - Usa un número secundario para evitar bloqueos.  \n\u003e - ¿Código QR expirado? Ejecuta `npm start` otra vez.  \n\u003e - La sesión se guarda, así que reconecta automáticamente salvo que cierres sesión.\n\n---\n\n#### 🔄 **Actualizando el Bot**\n\nManténlo actualizado:  \n```bash\nnpm run update\n```\n\nActualiza sin tocar configs ni chats.\n\n\u003e ✅ **Seguro**: Las actualizaciones no borran nada.\n\n---\n\n#### 💻 **Tutoriales por Plataforma**\n\n**¿Dónde ejecutas el bot?** Elige tu plataforma:\n\n##### 🖥️ **Windows**\n\n1. **Requisitos Previos**  \n   - Descarga e instala [Node.js](https://nodejs.org) (LTS recomendado).  \n   - Instala [Git](https://git-scm.com/downloads) para Windows.  \n   - Verifica:  \n     ```bash\n     node -v\n     git --version\n     ```\n\n2. **Clonar e Instalar**  \n   Abre Símbolo del sistema o PowerShell:  \n   ```bash\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   npm run config\n   npm run config:install\n   ```\n\n3. **Ejecutar el Bot**  \n   ```bash\n   npm start\n   ```\n\n4. **Mantenerlo Activo**  \n   - Usa [NSSM](https://nssm.cc/) para 24/7:  \n     ```bash\n     nssm install nazuna \"C:\\ruta\\a\\node.exe\" \"C:\\ruta\\a\\nazuna\\app.js\"\n     ```\n   - O deja abierta la ventana del Símbolo del sistema.\n\n\u003e 💡 **Consejo**: ¿Bot parado? Revisa internet o ejecuta `npm start` de nuevo.\n\n##### 🐧 **Linux**\n\n1. **Requisitos Previos**  \n   Actualiza e instala:  \n   ```bash\n   sudo apt update \u0026\u0026 sudo apt install -y nodejs git\n   ```  \n   Verifica:  \n   ```bash\n   node -v\n   git --version\n   ```\n\n2. **Clonar e Instalar**  \n   ```bash\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   npm run config\n   npm run config:install\n   ```\n\n3. **Ejecutar el Bot**  \n   ```bash\n   npm start\n   ```\n\n4. **Ejecutar en Segundo Plano**  \n   Usa `pm2`:  \n   ```bash\n   npm install -g pm2\n   pm2 start npm --name \"nazuna\" -- start\n   pm2 save\n   ```  \n   Monitorea con `pm2 logs nazuna`.\n\n\u003e 💡 **Consejo**: ¿Desconectado? Reinicia con `pm2 restart nazuna`.\n\n##### 📱 **Termux (Android)**\n\n1. **Instalar Termux**  \n   - Descarga desde [F-Droid](https://f-droid.org/packages/com.termux/) (evita Google Play).  \n   - Actualiza Termux:  \n     ```bash\n     pkg update \u0026\u0026 pkg upgrade -y\n     ```\n\n2. **Requisitos Previos**  \n   ```bash\n   pkg install nodejs git -y\n   termux-setup-storage\n   ```\n\n3. **Clonar e Instalar**  \n   ```bash\n   cd /sdcard\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   npm run config\n   npm run config:install\n   ```\n\n4. **Ejecutar el Bot**  \n   ```bash\n   npm start\n   ```\n\n5. **Mantenerlo Activo**  \n   - Evita que Termux se cierre; mantén el teléfono encendido (usa cargador o app de “mantener despierto”).  \n   - Si para, reinicia:  \n     ```bash\n     cd /sdcard/nazuna\n     npm start\n     ```\n\n\u003e 💡 **Consejo**: ¿“Permiso denegado”? Ejecuta `termux-setup-storage` otra vez.\n\n##### ☁️ **Pterodactyl**\n\nConfigura **nazuna Bot** en Pterodactyl de dos formas:\n\n**Opción 1: Egg Oficial de nazuna**\n\n1. **Descargar el Egg**  \n   - Consigue el egg en: [github.com/hiudyy/nazu-files/egg-ptero.json](https://github.com/hiudyy/nazu-files/egg-ptero.json).  \n   - Impórtalo en el panel Pterodactyl (**Eggs** \u003e **Import Egg**).\n\n2. **Crear el Servidor**  \n   - Crea un servidor con el egg de nazuna.  \n   - En **Startup**, configura:  \n     - **Nombre del Propietario**: Tu nombre/apodo (ej.: `Juan`).  \n     - **Número del Bot**: Número con código de país (ej.: `+34912345678`).  \n     - **Prefijo del Bot**: Símbolo para comandos (ej.: `/`).  \n     - **Nombre del Bot**: Nombre en WhatsApp (ej.: `nazuna`).  \n     - **Actualización Automática**: `Sí` para updates automáticos o `No` para manuales.  \n   - Especs mínimas: 512MB RAM y 512MB almacenamiento (1GB RAM y 2GB almacenamiento recomendados).\n\n3. **Iniciar el Servidor**  \n   - Haz clic en **Iniciar** en el panel.  \n   - El egg clona el repo (`https://github.com/hiudyy/nazuna.git`) e instala dependencias.  \n   - Conecta a WhatsApp con código QR o de vinculación (usa consola o VNC).\n\n4. **Mantenerlo Activo**  \n   - Pterodactyl lo mantiene 24/7.  \n   - Si es manual, ejecuta:  \n     ```bash\n     npm run update\n     ```\n\n**Opción 2: Egg Genérico de Node.js**\n\n1. **Crear el Servidor**  \n   - Crea un servidor con el egg **Node.js** estándar.  \n   - Configura **Comando de Inicio** como: `npm start`.  \n   - Especs mínimas: 512MB RAM y 512MB almacenamiento (1GB RAM y 2GB almacenamiento recomendados).\n\n2. **Clonar el Repositorio**  \n   - En la consola de Pterodactyl:  \n     ```bash\n     git clone https://github.com/hiudyy/nazuna.git\n     cd nazuna\n     ```\n\n3. **Instalar Dependencias**  \n   - Ejecuta:  \n     ```bash\n     npm run config\n     npm run config:install\n     ```\n\n4. **Iniciar el Bot**  \n   - Inicia el servidor en el panel.  \n   - Conecta a WhatsApp con código QR o de vinculación.\n\n5. **Actualizaciones**  \n   - Actualiza manualmente:  \n     ```bash\n     npm run update\n     ```\n\n\u003e 💡 **Consejo**: ¡El egg oficial automatiza todo y es más fácil!\n\n---\n\n#### ❓ **Solución de Problemas**\n\n¿Problemas? Soluciones para los más comunes:\n\n| **Problema**                     | **Solución**                                                               |\n|----------------------------------|---------------------------------------------------------------------------|\n| **“Comando no encontrado”**      | Instala Git/Node.js (`pkg install git nodejs` en Termux).                 |\n| **Código QR no funciona**        | Actualiza WhatsApp, genera otro QR con `npm start`, o revisa internet.    |\n| **Bot se desconecta**            | Reinicia con `npm start`, elimina carpeta `sessions`, o cambia número.    |\n| **Errores de instalación**       | Ejecuta `npm install`, verifica Node.js 18+ (`node -v`), o actualiza paquetes. |\n| **Termux se detiene**            | Mantén teléfono encendido y reinicia con `cd /sdcard/nazuna \u0026\u0026 npm start`. |\n\n\u003e 😊 **¿Aún con Problemas?** Únete a nuestro [Canal de WhatsApp](https://whatsapp.com/channel/0029Vb6Ezk6LI8YXPgZPUJ2b) para soporte.\n\n---\n\n#### 💖 **Apoyar el Proyecto**\n\nDesarrollar **nazuna Bot** es un trabajazo. Tu apoyo lo mantiene vivo:\n\n- **🌍 Global (Patreon)**  \n  [![Apoyar en Patreon](https://img.shields.io/badge/Apoyar-Patreon-orange?style=flat-square\u0026logo=patreon)](https://patreon.com/hiudyy)  \n  *Contribuye mensualmente para mantener el proyecto.*\n\n- **🇧🇷 Brasil (Pix)**  \n  **Clave Pix (Correo):** `lua.bot@hotmail.com`  \n  *Cualquier cantidad ayuda muchísimo.*\n\n\u003e ❤️ **¡Gracias!** Cada aporte impulsa nuevas funciones y mejoras.\n\n---\n\n#### 📜 **Licencia**\n\n© 2025 **Hiudy**. Todos los derechos reservados.\n\n**nazuna Bot** está **protegido por derechos de autor**. No quites créditos, no lo vendas ni distribuyas versiones modificadas sin permiso. Las violaciones pueden llevar a acciones legales.\n\n---\n\n#### 👤 **Sobre el Creador**\n\nCreado con ❤️ por [**Hiudy**](https://github.com/hiudyy), un dev apasionado por hacer la tecnología divertida y accesible. Siempre está creando proyectos nuevos y mejorando nazuna Bot para la comunidad.\n\n**Estadísticas de Hiudy**:\n\n| Icono | Insignia | Descripción |\n|-------|----------|-------------|\n| 👥 | ![Seguidores](https://img.shields.io/github/followers/hiudyy?color=blue\u0026style=flat-square) | **Seguidores**: Personas que siguen a Hiudy en GitHub. |\n| 📝 | ![Contribuciones](https://img.shields.io/github/commit-activity/y/hiudyy/nazuna) | **Contribuciones**: Actividad anual de Hiudy en proyectos. |\n| 💬 | ![Discord](https://img.shields.io/badge/Discord-hiudyyy-7289DA?style=flat-square\u0026logo=discord) | **Discord**: Conecta con Hiudy en Discord. |\n| 📷 | ![Instagram](https://img.shields.io/badge/Instagram-hiudyyy_-E4405F?style=flat-square\u0026logo=instagram) | **Instagram**: Sigue a Hiudy en Insta para novedades. |\n\n**Bio**:  \nHiudy es un entusiasta de la tecnología que ama crear soluciones prácticas y divertidas. Además de nazuna Bot, contribuye a proyectos open-source y disfruta conectar con la comunidad. ¡Síguelo en sus redes para ver sus próximos proyectos!\n\n- 📍 **GitHub**: [hiudyy](https://github.com/hiudyy)\n- 💬 **Discord**: [hiudyyy](https://discord.com/users/hiudyyy)\n- 📷 **Instagram**: [hiudyyy_](https://instagram.com/hiudyyy_)\n\n\u003e 🌟 **¿Te Gusta?** Dale una estrella en GitHub y compártelo con tus amigos.\n\n---\n\n#### ❔ **FAQ Avanzado**\n\n| **Pregunta**                             | **Respuesta**                                                                |\n|-----------------------------------------|------------------------------------------------------------------------------|\n| **¿Puedo usar mi número principal?**    | No recomendado. Usa un número secundario para evitar riesgos de bloqueo.     |\n| **¿El bot funciona sin conexión?**      | No, necesita internet para conectarse a WhatsApp.                           |\n| **¿Cómo personalizo los comandos?**     | Edita `config.json` tras instalar (consulta docs).                          |\n| **¿Qué hago si mi servidor Pterodactyl falla?** | Reinicia el servidor y revisa logs en la consola de Pterodactyl.           |\n\n\u003e 💡 **¿Más Preguntas?** Pregunta en nuestro [Canal de WhatsApp](https://whatsapp.com/channel/0029Vb6Ezk6LI8YXPgZPUJ2b).\n\n\u003c/details\u003e\n\n---\n\n## 🇮🇩 **Bahasa Indonesia**\n\n\u003cdetails\u003e\n\u003csummary\u003e💻 Klik untuk Memperluas Instruksi dalam Bahasa Indonesia\u003c/summary\u003e\n\n### 📊 **Statistik Proyek**\n\nMetrik real-time untuk **nazuna Bot**, dengan arti masing-masing:\n\n| Ikon | Lencana | Deskripsi |\n|------|---------|-----------|\n| 🕒 | ![Pembaruan Terakhir](https://img.shields.io/github/last-commit/hiudyy/nazuna?color=blue\u0026style=flat-square) | **Pembaruan Terakhir**: Kapan proyek terakhir diperbarui. |\n| ⭐ | ![Bintang](https://img.shields.io/github/stars/hiudyy/nazuna?color=yellow\u0026label=Bintang\u0026style=flat-square) | **Bintang**: Jumlah orang yang memberikan bintang di GitHub. |\n| 🍴 | ![Fork](https://img.shields.io/github/forks/hiudyy/nazuna?color=green\u0026style=flat-square) | **Fork**: Salinan proyek yang dibuat oleh pengembang lain. |\n| 🐞 | ![Isu](https://img.shields.io/github/issues/hiudyy/nazuna?color=red\u0026style=flat-square) | **Isu**: Bug atau saran yang dilaporkan komunitas. |\n| 📝 | ![Komit](https://img.shields.io/github/commit-activity/m/hiudyy/nazuna?color=purple\u0026style=flat-square) | **Komit**: Frekuensi pembaruan kode. |\n| 💾 | ![Ukuran Repo](https://img.shields.io/github/repo-size/hiudyy/nazuna?color=orange\u0026style=flat-square) | **Ukuran Repo**: Ruang yang digunakan proyek di GitHub. |\n| 👥 | ![Kontributor](https://img.shields.io/github/contributors/hiudyy/nazuna?color=cyan\u0026style=flat-square) | **Kontributor**: Orang yang membantu mengembangkan bot. |\n| 📥 | ![Unduhan](https://img.shields.io/github/downloads/hiudyy/nazuna/total?color=pink\u0026style=flat-square) | **Unduhan**: Total unduhan proyek. |\n| 🌐 | ![Bahasa](https://img.shields.io/github/languages/top/hiudyy/nazuna?color=teal\u0026style=flat-square) | **Bahasa**: Bahasa utama proyek. |\n| 🔄 | ![PR](https://img.shields.io/github/issues-pr/hiudyy/nazuna?color=brightgreen\u0026style=flat-square) | **Pull Request**: Usulan perbaikan dari komunitas. |\n| ⏱️ | ![Waktu Respon](https://img.shields.io/github/issues-closed-raw/hiudyy/nazuna?color=blueviolet\u0026style=flat-square) | **Waktu Respon**: Rata-rata waktu untuk menyelesaikan isu. |\n| 📜 | ![Lisensi](https://img.shields.io/badge/lisensi-Copyright-red?style=flat-square) | **Lisensi**: Proyek dilindungi hak cipta. |\n| ✅ | ![Status](https://img.shields.io/badge/STATUS-AKTIF-success?style=flat-square) | **Status**: Proyek aktif dan dalam pengembangan. |\n\n📈 **Total Kunjungan**:  \n![Penghitung Kunjungan](https://count.getloli.com/@nazuninha-bot?name=nazuninha-bot\u0026theme=booru-lewd\u0026padding=8\u0026offset=0\u0026align=top\u0026scale=2\u0026pixelated=1\u0026darkmode=1)  \n*Melacak berapa banyak orang mengunjungi proyek.*\n\n---\n\n### 📢 **Kanal WhatsApp Resmi**\n\nTetap update dengan berita, tips eksklusif, dan pembaruan!  \n[![Kanal WhatsApp](https://img.shields.io/badge/Gabung-WhatsApp-25D366?style=flat-square\u0026logo=whatsapp)](https://whatsapp.com/channel/0029Vb6Ezk6LI8YXPgZPUJ2b)  \n*Gabung kanal kami untuk dukungan dan konten eksklusif.*\n\n---\n\n### 🤖 **Apa itu nazuna Bot?**\n\n**nazuna Bot** adalah bot WhatsApp keren yang dibuat dengan **Node.js** dan **Baileys**. Ini seperti asisten super: mengotomatiskan tugas, mengelola grup, dan menawarkan perintah untuk admin, utilitas, hingga hiburan. Cocok untuk pemula dan sangat bisa disesuaikan untuk coder.\n\n\u003e ⚠️ **Peringatan Serius**: nazuna Bot **dilindungi hak cipta**. Menghapus kredit, menjual, atau mendistribusikan versi modifikasi tanpa izin adalah ilegal dan bisa bermasalah secara hukum.\n\n### 🎉 **Mengapa nazuna Bot Keren?**\n\n- **Setup Mudah**: Terhubung dengan kode QR atau kode pasangan dalam hitungan menit.\n- **Super Serbaguna**: Kelola grup, sediakan alat, dan hibur dengan perintah seru.\n- **Berjalan di Mana Saja**: Windows, Linux, macOS, Android (Termux), atau server seperti Pterodactyl.\n- **Selalu Update**: Fitur baru dan perbaikan dirilis secara rutin.\n- **Aman \u0026 Stabil**: Menggunakan mode multi-perangkat WhatsApp untuk performa mulus dan aman.\n\n\u003e 💡 **Penasaran?** Setelah setup, ketik `/menu` di WhatsApp untuk lihat semua perintah!\n\n---\n\n### 📜 **Daftar Isi**\n\n1. [🚀 Memulai](#-memulai)\n2. [📋 Prasyarat](#-prasyarat)\n3. [📥 Instalasi](#-instalasi)\n4. [🚀 Menjalankan Bot](#-menjalankan-bot)\n5. [🔌 Menghubungkan ke WhatsApp](#-menghubungkan-ke-whatsapp)\n6. [🔄 Memperbarui Bot](#-memperbarui-bot)\n7. [💻 Tutorial per Platform](#-tutorial-per-platform)\n   - [🖥️ Windows](#-windows)\n   - [🐧 Linux](#-linux)\n   - [📱 Termux (Android)](#-termux-android)\n   - [☁️ Pterodactyl](#-pterodactyl)\n8. [❓ Pemecahan Masalah](#-pemecahan-masalah)\n9. [💖 Dukung Proyek](#-dukung-proyek)\n10. [📜 Lisensi](#-lisensi)\n11. [👤 Tentang Pembuat](#-tentang-pembuat)\n12. [❔ FAQ Lanjutan](#-faq-lanjutan)\n\n---\n\n#### 🚀 **Memulai**\n\nBaru dengan **nazuna Bot**? Mulai dengan langkah sederhana ini:\n\n1. **Siapkan lingkungan**: Instal Node.js dan Git (lihat [Prasyarat](#-prasyarat)).\n2. **Unduh bot**: Klon repositori GitHub.\n3. **Hubungkan ke WhatsApp**: Gunakan nomor sekunder untuk menghindari risiko.\n4. **Jelajahi perintah**: Ketik `/menu` di WhatsApp untuk melihat kemampuan bot.\n\n\u003e 💡 **Tips Pemula**: Terlihat rumit? Tenang, setiap bagian dijelaskan langkah demi langkah!\n\n---\n\n#### 📋 **Prasyarat**\n\nAnda akan membutuhkan:\n\n| **Item**            | **Deskripsi**                                                                 |\n|---------------------|-------------------------------------------------------------------------------|\n| **Node.js**         | Versi 18 atau lebih tinggi. Unduh dari [nodejs.org](https://nodejs.org).      |\n| **Git**             | Untuk mengklon repositori. Dapatkan dari [git-scm.com](https://git-scm.com).  |\n| **WhatsApp**        | Nomor khusus untuk bot (hindari nomor utama untuk mencegah banned).           |\n| **Internet Stabil** | Diperlukan untuk pengaturan dan operasi.                                      |\n| **Perangkat**       | PC (Windows, Linux, macOS), Android dengan Termux, atau server (Pterodactyl). |\n| **Spesifikasi Minimum** | 512MB RAM dan 512MB penyimpanan (disarankan 1GB RAM dan 2GB penyimpanan).   |\n\n\u003e ⚠️ **Peringatan**: Gunakan nomor sekunder untuk bot guna melindungi akun WhatsApp utama Anda.\n\n---\n\n### 📥 **Instalasi**\n\nMari kita jalankan **nazuna Bot**:\n\n1. **Klon Repositori**  \n   Buka terminal (Command Prompt, PowerShell, atau Termux) dan jalankan:  \n   ```bash\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   ```\n\n2. **Instal Dependensi**  \n   Jalankan satu per satu:  \n   ```bash\n   npm run config\n   npm run config:install\n   ```  \n   Ini akan mengunduh semua pustaka yang diperlukan.\n\n   \u003e **Error?**: Pastikan Node.js terinstal (`node -v`). Jika masih bermasalah, coba `npm install`.\n\n---\n\n#### 🚀 **Menjalankan Bot**\n\nUntuk menyalakan **nazuna Bot**:  \n```bash\nnpm start\n```\n\nIni akan memandu Anda untuk menghubungkan ke WhatsApp (bagian berikutnya).\n\n\u003e 💡 **Pertama Kali**: Anda perlu autentikasi dengan kode QR atau kode pasangan. Setelah itu, biasanya tersambung otomatis.\n\n---\n\n#### 🔌 **Menghubungkan ke WhatsApp**\n\n**nazuna Bot** menggunakan **mode multi-perangkat** WhatsApp, jadi ponsel tidak perlu tetap online setelah pengaturan. Pilih metode:\n\n1. **Kode QR**  \n   - Terminal menampilkan kode QR (kotak dengan pola).  \n   - Di ponsel, buka WhatsApp:  \n     1. Masuk ke **Pengaturan** \u003e **Perangkat Tertaut**.  \n     2. Ketuk **Tautkan Perangkat**.  \n     3. Pindai kode QR dengan kamera.  \n   - Selesai, tersambung!  \n\n2. **Kode Pasangan**  \n   - Cocok untuk perangkat tanpa kamera.  \n   - Masukkan nomor bot (mis.: `+6281234567890`).  \n   - Terminal memberikan kode (mis.: `1234-5678`).  \n   - Di WhatsApp:  \n     1. Masuk ke **Pengaturan** \u003e **Perangkat Tertaut**.  \n     2. Ketuk **Tautkan dengan Nomor Telepon**.  \n     3. Masukkan kode.  \n   - Beres!\n\n\u003e ⚠️ **Peringatan**:  \n\u003e - Gunakan nomor sekunder untuk menghindari banned.  \n\u003e - Kode QR kadaluarsa? Jalankan `npm start` lagi.  \n\u003e - Sesi disimpan, jadi penyambungan ulang otomatis kecuali Anda keluar.\n\n---\n\n#### 🔄 **Memperbarui Bot**\n\nAgar tetap terbaru:  \n```bash\nnpm run update\n```\n\nMemperbarui tanpa mengganggu pengaturan atau obrolan.\n\n\u003e ✅ **Aman**: Pembaruan tidak menghapus apa pun.\n\n---\n\n#### 💻 **Tutorial per Platform**\n\n**Di mana Anda menjalankan bot?** Pilih platform Anda:\n\n##### 🖥️ **Windows**\n\n1. **Prasyarat**  \n   - Unduh dan instal [Node.js](https://nodejs.org) (LTS disarankan).  \n   - Instal [Git](https://git-scm.com/downloads) untuk Windows.  \n   - Verifikasi:  \n     ```bash\n     node -v\n     git --version\n     ```\n\n2. **Klon dan Instal**  \n   Buka Command Prompt atau PowerShell:  \n   ```bash\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   npm run config\n   npm run config:install\n   ```\n\n3. **Jalankan Bot**  \n   ```bash\n   npm start\n   ```\n\n4. **Jaga Online**  \n   - Gunakan [NSSM](https://nssm.cc/) untuk 24/7:  \n     ```bash\n     nssm install nazuna \"C:\\jalur\\ke\\node.exe\" \"C:\\jalur\\ke\\nazuna\\app.js\"\n     ```\n   - Atau biarkan Command Prompt terbuka.\n\n\u003e 💡 **Tips**: Bot berhenti? Periksa internet atau jalankan ulang `npm start`.\n\n##### 🐧 **Linux**\n\n1. **Prasyarat**  \n   Perbarui dan instal:  \n   ```bash\n   sudo apt update \u0026\u0026 sudo apt install -y nodejs git\n   ```  \n   Verifikasi:  \n   ```bash\n   node -v\n   git --version\n   ```\n\n2. **Klon dan Instal**  \n   ```bash\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   npm run config\n   npm run config:install\n   ```\n\n3. **Jalankan Bot**  \n   ```bash\n   npm start\n   ```\n\n4. **Jalankan di Latar Belakang**  \n   Gunakan `pm2`:  \n   ```bash\n   npm install -g pm2\n   pm2 start npm --name \"nazuna\" -- start\n   pm2 save\n   ```  \n   Pantau dengan `pm2 logs nazuna`.\n\n\u003e 💡 **Tips**: Terputus? Mulai ulang dengan `pm2 restart nazuna`.\n\n##### 📱 **Termux (Android)**\n\n1. **Instal Termux**  \n   - Unduh dari [F-Droid](https://f-droid.org/packages/com.termux/) (hindari Google Play).  \n   - Perbarui Termux:  \n     ```bash\n     pkg update \u0026\u0026 pkg upgrade -y\n     ```\n\n2. **Prasyarat**  \n   ```bash\n   pkg install nodejs git -y\n   termux-setup-storage\n   ```\n\n3. **Klon dan Instal**  \n   ```bash\n   cd /sdcard\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   npm run config\n   npm run config:install\n   ```\n\n4. **Jalankan Bot**  \n   ```bash\n   npm start\n   ```\n\n5. **Jaga Online**  \n   - Jangan tutup Termux; pastikan ponsel tetap menyala (gunakan charger atau aplikasi “tetap aktif”).  \n   - Jika berhenti, mulai ulang:  \n     ```bash\n     cd /sdcard/nazuna\n     npm start\n     ```\n\n\u003e 💡 **Tips**: “Izin ditolak”? Jalankan ulang `termux-setup-storage`.\n\n##### ☁️ **Pterodactyl**\n\nSiapkan **nazuna Bot** di Pterodactyl dengan dua cara:\n\n**Opsi 1: Egg Resmi nazuna**\n\n1. **Unduh Egg**  \n   - Ambil egg di: [github.com/hiudyy/nazu-files/egg-ptero.json](https://github.com/hiudyy/nazu-files/egg-ptero.json).  \n   - Impor di panel Pterodactyl (**Eggs** \u003e **Import Egg**).\n\n2. **Buat Server**  \n   - Buat server dengan egg nazuna.  \n   - Di **Startup**, atur:  \n     - **Nama Pemilik**: Nama/panggilan Anda (mis.: `Budi`).  \n     - **Nomor Bot**: Nomor dengan kode negara (mis.: `+6281234567890`).  \n     - **Awalan Bot**: Simbol untuk perintah (mis.: `/`).  \n     - **Nama Bot**: Nama di WhatsApp (mis.: `nazuna`).  \n     - **Pembaruan Otomatis**: `Ya` untuk otomatis atau `Tidak` untuk manual.  \n   - Spesifikasi minimum: 512MB RAM dan 512MB penyimpanan (disarankan 1GB RAM dan 2GB penyimpanan).\n\n3. **Mulai Server**  \n   - Klik **Start** di panel.  \n   - Egg otomatis mengklon repo (`https://github.com/hiudyy/nazuna.git`) dan menginstal dependensi.  \n   - Hubungkan ke WhatsApp dengan kode QR atau kode pasangan (gunakan konsol atau VNC).\n\n4. **Jaga Online**  \n   - Pterodactyl menjalankannya 24/7.  \n   - Untuk pembaruan manual, jalankan:  \n     ```bash\n     npm run update\n     ```\n\n**Opsi 2: Egg Node.js Umum**\n\n1. **Buat Server**  \n   - Buat server dengan egg **Node.js** standar.  \n   - Atur **Perintah Startup** ke: `npm start`.  \n   - Spesifikasi minimum: 512MB RAM dan 512MB penyimpanan (disarankan 1GB RAM dan 2GB penyimpanan).\n\n2. **Klon Repositori**  \n   - Di konsol Pterodactyl:  \n     ```bash\n     git clone https://github.com/hiudyy/nazuna.git\n     cd nazuna\n     ```\n\n3. **Inst尸体 Dependensi**  \n   - Jalankan:  \n     ```bash\n     npm run config\n     npm run config:install\n     ```\n\n4. **Mulai Bot**  \n   - Mulai server di panel.  \n   - Hubungkan ke WhatsApp dengan kode QR atau kode pasangan.\n\n5. **Pembaruan**  \n   - Perbarui secara manual:  \n     ```bash\n     npm run update\n     ```\n\n\u003e 💡 **Tips**: Egg resmi mengotomatiskan semuanya, jadi lebih mudah!\n\n---\n\n#### ❓ **Pemecahan Masalah**\n\nAda masalah? Solusi untuk masalah umum:\n\n| **Masalah**                      | **Solusi**                                                               |\n|----------------------------------|-------------------------------------------------------------------------|\n| **“Perintah tidak ditemukan”**   | Instal Git/Node.js (`pkg install git nodejs` di Termux).                |\n| **Kode QR tidak berfungsi**      | Perbarui WhatsApp, buat QR baru dengan `npm start`, atau cek internet.  |\n| **Bot terputus**                 | Mulai ulang dengan `npm start`, hapus folder `sessions`, atau ganti nomor. |\n| **Error instalasi**              | Jalankan `npm install`, pastikan Node.js 18+ (`node -v`), atau perbarui paket. |\n| **Termux berhenti**              | Jaga ponsel aktif dan mulai ulang dengan `cd /sdcard/nazuna \u0026\u0026 npm start`. |\n\n\u003e 😊 **Masih Bingung?** Gabung ke [Kanal WhatsApp](https://whatsapp.com/channel/0029Vb6Ezk6LI8YXPgZPUJ2b) untuk bantuan!\n\n---\n\n#### 💖 **Dukung Proyek**\n\nMengembangkan **nazuna Bot** butuh kerja keras. Dukungan Anda sangat berarti:\n\n- **🌍 Global (Patreon)**  \n  [![Dukung di Patreon](https://img.shields.io/badge/Dukung-Patreon-orange?style=flat-square\u0026logo=patreon)](https://patreon.com/hiudyy)  \n  *Beri kontribusi bulanan untuk menjaga proyek tetap hidup.*\n\n- **🇧🇷 Brasil (Pix)**  \n  **Kunci Pix (Email):** `lua.bot@hotmail.com`  \n  *Jumlah berapa pun sangat membantu.*\n\n\u003e ❤️ **Terima Kasih!** Setiap kontribusi mendorong fitur baru dan perbaikan!\n\n---\n\n#### 📜 **Lisensi**\n\n© 2025 **Hiudy**. Semua hak dilindungi.\n\n**nazuna Bot** **dilindungi hak cipta**. Jangan hapus kredit, jual, atau distribusikan versi modifikasi tanpa izin. Pelanggaran dapat berujung pada tindakan hukum.\n\n---\n\n#### 👤 **Tentang Pembuat**\n\nDibuat dengan ❤️ oleh [**Hiudy**](https://github.com/hiudyy), seorang pengembang yang bersemangat membuat teknologi menyenangkan dan mudah diakses. Dia selalu mengerjakan proyek baru dan meningkatkan nazuna Bot untuk komunitas.\n\n**Statistik Hiudy**:\n\n| Ikon | Lencana | Deskripsi |\n|------|---------|-----------|\n| 👥 | ![Pengikut](https://img.shields.io/github/followers/hiudyy?color=blue\u0026style=flat-square) | **Pengikut**: Jumlah orang yang mengikuti Hiudy di GitHub. |\n| 📝 | ![Kontribusi](https://img.shields.io/github/commit-activity/y/hiudyy/nazuna) | **Kontribusi**: Aktivitas tahunan Hiudy di semua proyek. |\n| 💬 | ![Discord](https://img.shields.io/badge/Discord-hiudyyy-7289DA?style=flat-square\u0026logo=discord) | **Discord**: Terhubung dengan Hiudy di Discord. |\n| 📷 | ![Instagram](https://img.shields.io/badge/Instagram-hiudyyy_-E4405F?style=flat-square\u0026logo=instagram) | **Instagram**: Ikuti Hiudy di Instagram untuk update. |\n\n**Bio**:  \nHiudy adalah penggemar teknologi yang suka membuat solusi praktis dan menyenangkan. Selain nazuna Bot, dia berkontribusi pada proyek open-source dan senang berinteraksi dengan komunitas. Ikuti media sosialnya untuk proyek berikutnya!\n\n- 📍 **GitHub**: [hiudyy](https://github.com/hiudyy)\n- 💬 **Discord**: [hiudyyy](https://discord.com/users/hiudyyy)\n- 📷 **Instagram**: [hiudyyy_](https://instagram.com/hiudyyy_)\n\n\u003e 🌟 **Suka?** Beri bintang di GitHub dan bagikan dengan teman!\n\n---\n\n#### ❔ **FAQ Lanjutan**\n\n| **Pertanyaan**                           | **Jawaban**                                                                |\n|-----------------------------------------|---------------------------------------------------------------------------|\n| **Bisa pakai nomor utama?**             | Tidak disarankan. Gunakan nomor sekunder untuk menghindari risiko banned. |\n| **Bot bekerja offline?**                | Tidak, butuh internet untuk terhubung ke WhatsApp.                        |\n| **Cara menyesuaikan perintah?**         | Edit `config.json` setelah instalasi (lihat dokumentasi).                 |\n| **Jika server Pterodactyl crash?**      | Restart server dan cek log di konsol Pterodactyl.                         |\n\n\u003e 💡 **Pertanyaan Lain?** Tanya di [Kanal WhatsApp](https://whatsapp.com/channel/0029Vb6Ezk6LI8YXPgZPUJ2b)!\n\n\u003c/details\u003e\n\n---\n\n## 🇫🇷 **Français**\n\n\u003cdetails\u003e\n\u003csummary\u003e💻 Cliquez pour Développer les Instructions en Français\u003c/summary\u003e\n\n### 📊 **Statistiques du Projet**\n\nMétriques en temps réel pour **nazuna Bot**, avec leur signification :\n\n| Icône | Badge | Description |\n|-------|-------|-------------|\n| 🕒 | ![Dernière Mise à Jour](https://img.shields.io/github/last-commit/hiudyy/nazuna?color=blue\u0026style=flat-square) | **Dernière Mise à Jour** : Date de la dernière mise à jour du projet. |\n| ⭐ | ![Étoiles](https://img.shields.io/github/stars/hiudyy/nazuna?color=yellow\u0026label=Étoiles\u0026style=flat-square) | **Étoiles** : Nombre de personnes ayant mis une étoile sur GitHub. |\n| 🍴 | ![Forks](https://img.shields.io/github/forks/hiudyy/nazuna?color=green\u0026style=flat-square) | **Forks** : Copies du projet réalisées par d'autres développeurs. |\n| 🐞 | ![Issues](https://img.shields.io/github/issues/hiudyy/nazuna?color=red\u0026style=flat-square) | **Issues** : Bugs ou suggestions signalés par la communauté. |\n| 📝 | ![Commits](https://img.shields.io/github/commit-activity/m/hiudyy/nazuna?color=purple\u0026style=flat-square) | **Commits** : Fréquence des mises à jour du code. |\n| 💾 | ![Taille du Repo](https://img.shields.io/github/repo-size/hiudyy/nazuna?color=orange\u0026style=flat-square) | **Taille du Repo** : Espace occupé par le projet sur GitHub. |\n| 👥 | ![Contributeurs](https://img.shields.io/github/contributors/hiudyy/nazuna?color=cyan\u0026style=flat-square) | **Contributeurs** : Personnes ayant aidé à développer le bot. |\n| 📥 | ![Téléchargements](https://img.shields.io/github/downloads/hiudyy/nazuna/total?color=pink\u0026style=flat-square) | **Téléchargements** : Nombre total de téléchargements du projet. |\n| 🌐 | ![Langages](https://img.shields.io/github/languages/top/hiudyy/nazuna?color=teal\u0026style=flat-square) | **Langages** : Principaux langages utilisés dans le projet. |\n| 🔄 | ![PRs](https://img.shields.io/github/issues-pr/hiudyy/nazuna?color=brightgreen\u0026style=flat-square) | **Pull Requests** : Propositions d'améliorations soumises. |\n| ⏱️ | ![Temps de Réponse](https://img.shields.io/github/issues-closed-raw/hiudyy/nazuna?color=blueviolet\u0026style=flat-square) | **Temps de Réponse** : Temps moyen pour résoudre les issues. |\n| 📜 | ![Licence](https://img.shields.io/badge/licence-Copyright-red?style=flat-square) | **Licence** : Projet protégé par des droits d'auteur. |\n| ✅ | ![Statut](https://img.shields.io/badge/STATUT-ACTIF-success?style=flat-square) | **Statut** : Projet actif et en développement. |\n\n📈 **Visites Totales** :  \n![Compteur de Visites](https://count.getloli.com/@nazuninha-bot?name=nazuninha-bot\u0026theme=booru-lewd\u0026padding=8\u0026offset=0\u0026align=top\u0026scale=2\u0026pixelated=1\u0026darkmode=1)  \n*Compte le nombre de visiteurs du projet.*\n\n---\n\n### 📢 **Canal WhatsApp Officiel**\n\nRestez informé des nouveautés, astuces exclusives et mises à jour !  \n[![Canal WhatsApp](https://img.shields.io/badge/Rejoindre-WhatsApp-25D366?style=flat-square\u0026logo=whatsapp)](https://whatsapp.com/channel/0029Vb6Ezk6LI8YXPgZPUJ2b)  \n*Rejoignez notre canal pour du support et du contenu exclusif.*\n\n---\n\n### 🤖 **Qu'est-ce que nazuna Bot ?**\n\n**nazuna Bot** est un bot WhatsApp épique, construit avec **Node.js** et **Baileys**. C’est un assistant tout-terrain : il automatise les tâches, gère les groupes et propose des commandes pour l’administration, les utilitaires et le divertissement. Parfait pour les débutants et hautement personnalisable pour les codeurs.\n\n\u003e ⚠️ **Avertissement Sérieux** : nazuna Bot est **protégé par des droits d'auteur**. Supprimer les crédits, vendre ou distribuer des versions modifiées sans autorisation est illégal et peut entraîner des problèmes juridiques.\n\n### 🎉 **Pourquoi nazuna Bot est Génial ?**\n\n- **Configuration Facile** : Connexion via QR code ou code de jumelage en quelques minutes.\n- **Super Polyvalent** : Gère les groupes, fournit des outils et amuse avec des commandes ludiques.\n- **Fonctionne Partout** : Windows, Linux, macOS, Android (Termux) ou serveurs comme Pterodactyl.\n- **Toujours à Jour** : Nouvelles fonctionnalités et correctifs publiés régulièrement.\n- **Sûr et Fluide** : Utilise le mode multi-appareils de WhatsApp pour stabilité et sécurité.\n\n\u003e 💡 **Curieux ?** Après configuration, tapez `/menu` sur WhatsApp pour découvrir les commandes !\n\n---\n\n### 📜 **Tableau des Matières**\n\n1. [🚀 Premiers Pas](#-premiers-pas)\n2. [📋 Prérequis](#-prérequis)\n3. [📥 Installation](#-installation)\n4. [🚀 Lancer le Bot](#-lancer-le-bot)\n5. [🔌 Connexion à WhatsApp](#-connexion-à-whatsapp)\n6. [🔄 Mise à Jour du Bot](#-mise-à-jour-du-bot)\n7. [💻 Tutoriels par Plateforme](#-tutoriels-par-plateforme)\n   - [🖥️ Windows](#-windows)\n   - [🐧 Linux](#-linux)\n   - [📱 Termux (Android)](#-termux-android)\n   - [☁️ Pterodactyl](#-pterodactyl)\n8. [❓ Résolution des Problèmes](#-résolution-des-problèmes)\n9. [💖 Soutenir le Projet](#-soutenir-le-projet)\n10. [📜 Licence](#-licence)\n11. [👤 À Propos du Créateur](#-à-propos-du-créateur)\n12. [❔ FAQ Avancé](#-faq-avancé)\n\n---\n\n#### 🚀 **Premiers Pas**\n\nNouveau sur **nazuna Bot** ? Commencez par ces étapes simples :\n\n1. **Préparez l’environnement** : Installez Node.js et Git (voir [Prérequis](#-prérequis)).\n2. **Téléchargez le bot** : Clonez le dépôt GitHub.\n3. **Connectez-vous à WhatsApp** : Utilisez un numéro secondaire pour éviter les risques.\n4. **Explorez les commandes** : Tapez `/menu` sur WhatsApp pour voir ce que fait le bot.\n\n\u003e 💡 **Astuce Débutant** : Ça semble compliqué ? Chaque section explique tout étape par étape !\n\n---\n\n#### 📋 **Prérequis**\n\nVous aurez besoin de :\n\n| **Élément**        | **Description**                                                               |\n|--------------------|-------------------------------------------------------------------------------|\n| **Node.js**        | Version 18 ou supérieure. Téléchargez sur [nodejs.org](https://nodejs.org).   |\n| **Git**            | Pour cloner le dépôt. Obtenez-le sur [git-scm.com](https://git-scm.com).      |\n| **WhatsApp**       | Un numéro dédié pour le bot (évitez votre numéro principal pour éviter un ban). |\n| **Internet Stable**| Essentiel pour la configuration et le fonctionnement.                         |\n| **Appareil**       | PC (Windows, Linux, macOS), Android avec Termux, ou serveur (Pterodactyl).    |\n| **Specs Minimales**| 512 Mo de RAM et 512 Mo de stockage (1 Go de RAM et 2 Go de stockage recommandés). |\n\n\u003e ⚠️ **Avertissement** : Utilisez un numéro secondaire pour protéger votre compte WhatsApp principal.\n\n---\n\n#### 📥 **Installation**\n\nMettons **nazuna Bot** en route :\n\n1. **Cloner le Dépôt**  \n   Ouvrez votre terminal (Invite de commandes, PowerShell ou Termux) et exécutez :  \n   ```bash\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   ```\n\n2. **Installer les Dépendances**  \n   Exécutez un par un :  \n   ```bash\n   npm run config\n   npm run config:install\n   ```  \n   Cela télécharge toutes les bibliothèques nécessaires.\n\n   \u003e **Erreur ?** : Vérifiez si Node.js est installé (`node -v`). Si ça persiste, essayez `npm install`.\n\n---\n\n#### 🚀 **Lancer le Bot**\n\nPour démarrer **nazuna Bot** :  \n```bash\nnpm start\n```\n\nIl vous guidera pour vous connecter à WhatsApp (section suivante).\n\n\u003e 💡 **Première Exécution** : Vous devrez vous authentifier avec un QR code ou un code de jumelage. Ensuite, il se reconnecte généralement automatiquement.\n\n---\n\n#### 🔌 **Connexion à WhatsApp**\n\n**nazuna Bot** utilise le **mode multi-appareils** de WhatsApp, donc votre téléphone n’a pas besoin de rester connecté après la configuration. Choisissez une méthode :\n\n1. **QR Code**  \n   - Le terminal affiche un QR code (un carré avec des motifs).  \n   - Sur votre téléphone, ouvrez WhatsApp :  \n     1. Allez dans **Paramètres** \u003e **Appareils Connectés**.  \n     2. Appuyez sur **Connecter un Appareil**.  \n     3. Scannez le QR code avec l’appareil photo.  \n   - Connecté !  \n\n2. **Code de Jumelage**  \n   - Parfait pour les appareils sans caméra.  \n   - Entrez le numéro du bot (ex. : `+33612345678`).  \n   - Le terminal fournit un code (ex. : `1234-5678`).  \n   - Dans WhatsApp :  \n     1. Allez dans **Paramètres** \u003e **Appareils Connectés**.  \n     2. Appuyez sur **Connecter avec un Numéro de Téléphone**.  \n     3. Entrez le code.  \n   - C’est bon !\n\n\u003e ⚠️ **Attention** :  \n\u003e - Utilisez un numéro secondaire pour éviter un ban.  \n\u003e - QR code expiré ? Relancez `npm start`.  \n\u003e - La session est enregistrée, donc les reconnexions sont automatiques sauf si vous vous déconnectez.\n\n---\n\n#### 🔄 **Mise à Jour du Bot**\n\nRestez à jour :  \n```bash\nnpm run update\n```\n\nMet à jour sans toucher aux paramètres ni aux discussions.\n\n\u003e ✅ **Sûr** : Les mises à jour ne suppriment rien.\n\n---\n\n#### 💻 **Tutoriels par Plateforme**\n\n**Où exécutez-vous le bot ?** Choisissez votre plateforme :\n\n##### 🖥️ **Windows**\n\n1. **Prérequis**  \n   - Téléchargez et installez [Node.js](https://nodejs.org) (LTS recommandé).  \n   - Installez [Git](https://git-scm.com/downloads) pour Windows.  \n   - Vérifiez :  \n     ```bash\n     node -v\n     git --version\n     ```\n\n2. **Cloner et Installer**  \n   Ouvrez l’Invite de commandes ou PowerShell :  \n   ```bash\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   npm run config\n   npm run config:install\n   ```\n\n3. **Lancer le Bot**  \n   ```bash\n   npm start\n   ```\n\n4. **Maintenir en Ligne**  \n   - Utilisez [NSSM](https://nssm.cc/) pour 24/7 :  \n     ```bash\n     nssm install nazuna \"C:\\chemin\\vers\\node.exe\" \"C:\\chemin\\vers\\nazuna\\app.js\"\n     ```\n   - Ou gardez l’Invite de commandes ouverte.\n\n\u003e 💡 **Astuce** : Bot arrêté ? Vérifiez la connexion ou relancez `npm start`.\n\n##### 🐧 **Linux**\n\n1. **Prérequis**  \n   Mettez à jour et installez :  \n   ```bash\n   sudo apt update \u0026\u0026 sudo apt install -y nodejs git\n   ```  \n   Vérifiez :  \n   ```bash\n   node -v\n   git --version\n   ```\n\n2. **Cloner et Installer**  \n   ```bash\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   npm run config\n   npm run config:install\n   ```\n\n3. **Lancer le Bot**  \n   ```bash\n   npm start\n   ```\n\n4. **Exécuter en Arrière-Plan**  \n   Utilisez `pm2` :  \n   ```bash\n   npm install -g pm2\n   pm2 start npm --name \"nazuna\" -- start\n   pm2 save\n   ```  \n   Surveillez avec `pm2 logs nazuna`.\n\n\u003e 💡 **Astuce** : Déconnecté ? Redémarrez avec `pm2 restart nazuna`.\n\n##### 📱 **Termux (Android)**\n\n1. **Installer Termux**  \n   - Téléchargez depuis [F-Droid](https://f-droid.org/packages/com.termux/) (évitez Google Play).  \n   - Mettez à jour Termux :  \n     ```bash\n     pkg update \u0026\u0026 pkg upgrade -y\n     ```\n\n2. **Prérequis**  \n   ```bash\n   pkg install nodejs git -y\n   termux-setup-storage\n   ```\n\n3. **Cloner et Installer**  \n   ```bash\n   cd /sdcard\n   git clone https://github.com/hiudyy/nazuna.git\n   cd nazuna\n   npm run config\n   npm run config:install\n   ```\n\n4. **Lancer le Bot**  \n   ```bash\n   npm start\n   ```\n\n5. **Maintenir en Ligne**  \n   - Évitez de fermer Termux ; gardez le téléphone allumé (utilisez un chargeur ou une app “rester éveillé”).  \n   - En cas d’arrêt, redémarrez :  \n     ```bash\n     cd /sdcard/nazuna\n     npm start\n     ```\n\n\u003e 💡 **Astuce** : “Permission refusée” ? Relancez `termux-setup-storage`.\n\n##### ☁️ **Pterodactyl**\n\nConfigurez **nazuna Bot** sur Pterodactyl de deux manières :\n\n**Option 1 : Egg Officiel nazuna**\n\n1. **Télécharger l’Egg**  \n   - Obtenez l’egg sur : [github.com/hiudyy/nazu-files/egg-ptero.json](https://github.com/hiudyy/nazu-files/egg-ptero.json).  \n   - Importez-le dans le panneau Pterodactyl (**Eggs** \u003e **Importer un Egg**).\n\n2. **Créer le Serveur**  \n   - Créez un serveur avec l’egg nazuna.  \n   - Dans **Startup**, configurez :  \n     - **Nom du Propriétaire** : Votre nom/pseudo (ex. : `Jean`).  \n     - **Numéro du Bot** : Numéro avec code pays (ex. : `+33612345678`).  \n     - **Préfixe du Bot** : Symbole pour les commandes (ex. : `/`).  \n     - **Nom du Bot** : Nom affiché sur WhatsApp (ex. : `nazuna`).  \n     - **Mise à Jour Auto** : `Oui` pour les mises à jour automatiques ou `Non` pour manuelles.  \n   - Specs minimales : 512 Mo RAM et 512 Mo stockage (1 Go RAM et 2 Go stockage recommandés).\n\n3. **Démarrer le Serveur**  \n   - Cliquez sur **Démarrer** dans le panneau.  \n   - L’egg clone automatiquement le dépôt (`https://github.com/hiudyy/nazuna.git`) et installe les dépendances.  \n   - Connectez-vous à WhatsApp avec un QR code ou un code de jumelage (via console ou VNC).\n\n4. **Maintenir en Ligne**  \n   - Pterodactyl le fait tourner 24/7.  \n   - Pour les mises à jour manuelles, exécutez :  \n     ```bash\n     npm run update\n     ```\n\n**Option 2 : Egg Node.js Générique**\n\n1. **Créer le Serveur**  \n   - Créez un serveur avec l’egg **Node.js** standard.  \n   - Définissez **Commande de Démarrage** sur : `npm start`.  \n   - Specs minimales : 512 Mo RAM et 512 Mo stockage (1 Go RAM et 2 Go stockage recommandés).\n\n2. **Cloner le Dépôt**  \n   - Dans la console Pterodactyl :  \n     ```bash\n     git clone https://github.com/hiudyy/nazuna.git\n     cd nazuna\n     ```\n\n3. **Installer les Dépendances**  \n   - Exécutez :  \n     ```bash\n     npm run config\n     npm run config:install\n     ```\n\n4. **Démarrer le Bot**  \n   - Démarrez le serveur dans le panneau.  \n   - Connectez-vous à WhatsApp avec un QR code ou un code de jumelage.\n\n5. **Mises à Jour**  \n   - Mettez à jour manuellement :  \n     ```bash\n     npm run update\n     ```\n\n\u003e 💡 **Astuce** : L’egg officiel automatise tout, c’est plus simple !\n\n---\n\n#### ❓ **Résolution des Problèmes**\n\nDes soucis ? Solutions pour les problèmes courants :\n\n| **Problème**                     | **Solution**                                                               |\n|----------------------------------|---------------------------------------------------------------------------|\n| **“Commande introuvable”**       | Installez Git/Node.js (`pkg install git nodejs` sur Termux).              |\n| **QR Code ne fonctionne pas**    | Mettez à jour WhatsApp, générez un nouveau QR avec `npm start`, ou vérifiez internet. |\n| **Bot se déconnecte**            | Relancez avec `npm start`, supprimez le dossier `sessions`, ou changez de numéro. |\n| **Erreurs d’installation**       | Exécutez `npm install`, vérifiez Node.js 18+ (`node -v`), ou mettez à jour les paquets. |\n| **Termux s’arrête**              | Gardez le téléphone allumé et relancez avec `cd /sdcard/nazuna \u0026\u0026 npm start`. |\n\n\u003e 😊 **Toujours Bloqué ?** Rejoignez notre [Canal WhatsApp](https://whatsapp.com/channel/0029Vb6Ezk6LI8YXPgZPUJ2b) pour de l’aide !\n\n---\n\n#### 💖 **Soutenir le Projet**\n\nDévelopper **nazuna Bot** demande beaucoup de travail. Votre soutien est précieux :\n\n- **🌍 Global (Patreon)**  \n  [![Soutenir sur Patreon](https://img.shields.io/badge/Soutenir-Patreon-orange?style=flat-square\u0026logo=patreon)](https://patreon.com/hiudyy)  \n  *Contribuez mensuellement pour maintenir le projet.*\n\n- **🇧🇷 Brésil (Pix)**  \n  **Clé Pix (Email)** : `lua.bot@hotmail.com`  \n  *Tout montant aide énormément.*\n\n\u003e ❤️ **Merci !** Chaque contribution alimente de nouvelles fonctionnalités et améliorations !\n\n---\n\n#### 📜 **Licence**\n\n© 2025 **Hiudy**. Tous droits réservés.\n\n**nazuna Bot** est **protégé par des droits d'auteur**. Ne supprimez pas les crédits, ne vendez pas et ne distribuez pas de versions modifiées sans autorisation. Les violations peuvent entraîner des actions légales.\n\n---\n\n#### 👤 **À Propos du Créateur**\n\nCréé avec ❤️ par [**Hiudy**](https://github.com/hiudyy), un développeur passionné par rendre la technologie amusante et accessible. Il travaille toujours sur de nouveaux projets et améliore nazuna Bot pour la communauté.\n\n**Stats de Hiudy** :\n\n| Icône | Badge | Description |\n|-------|-------|-------------|\n| 👥 | ![Abonnés](https://img.shields.io/github/followers/hiudyy?color=blue\u0026style=flat-square) | **Abonnés** : Nombre de personnes suivant Hiudy sur GitHub. |\n| 📝 | ![Contributions](https://img.shields.io/github/commit-activity/y/hiudyy/nazuna) | **Contributions** : Activité annuelle de Hiudy sur tous les projets. |\n| 💬 | ![Discord](https://img.shields.io/badge/Discord-hiudyyy-7289DA?style=flat-square\u0026logo=discord) | **Discord** : Connectez-vous avec Hiudy sur Discord. |\n| 📷 | ![Instagram](https://img.shields.io/badge/Instagram-hiudyyy_-E4405F?style=flat-square\u0026logo=instagram) | **Instagram** : Suivez Hiudy sur Insta pour les nouveautés. |\n\n**Bio** :  \nHiudy est un passionné de technologie qui adore créer des solutions pratiques et amusantes. En plus de nazuna Bot, il contribue à des projets open-source et aime échanger avec la communauté. Suivez-le sur les réseaux pour découvrir ses prochains projets !\n\n- 📍 **GitHub** : [hiudyy](https://github.com/hiudyy)\n- 💬 **Discord** : [hiudyyy](https://discord.com/users/hiudyyy)\n- 📷 **Instagram** : [hiudyyy_](https://instagram.com/hiudyyy_)\n\n\u003e 🌟 **Vous Aimez ?** Mettez une étoile sur GitHub et partagez avec vos amis !\n\n---\n\n#### ❔ **FAQ Avancé**\n\n| **Question**                             | **Réponse**                                                                |\n|-----------------------------------------|---------------------------------------------------------------------------|\n| **Puis-je utiliser mon numéro principal ?** | Non recommandé. Utilisez un numéro secondaire pour éviter les risques de ban. |\n| **Le bot fonctionne hors ligne ?**       | Non, il nécessite une connexion internet pour WhatsApp.                   |\n| **Comment personnaliser les commandes ?**| Modifiez `config.json` après installation (voir docs).                    |\n| **Et si mon serveur Pterodactyl plante ?** | Redémarrez le serveur et vérifiez les logs dans la console Pterodactyl.   |\n\n\u003e 💡 **Plus de Questions ?** Posez-les sur notre [Canal WhatsApp](https://whatsapp.com/channel/0029Vb6Ezk6LI8YXPgZPUJ2b) !\n\n\u003c/details\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhiudyy%2Fnazuna","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhiudyy%2Fnazuna","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhiudyy%2Fnazuna/lists"}