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