🌊 Mizu OwO 水

Advanced Auto Farming Bot for OwO Discord Game

The most advanced, feature-rich, and user-friendly OwO farming bot

---

✨ Features

• Smart Auto Farming: Automates hunt, battle, owo, and pray with human-like delays.
• Quest Solver: Automatically detects and solves daily quests (e.g. auto-enables slots for "Gamble 5 times").
• Mini-Games: Strategies for Slots, Coinflip, and Lottery.
• Anti-Ban Technology: Random sleep schedules, channel switching, and human-like typing simulation.
• Web Dashboard: Real-time statistics and configuration from your browser (Mobile friendly).
• Auto-Upgrade: Intelligently manages your HuntBot upgrades and essence investment.
• Multi-Account: Run as many accounts as your PC can handle.

---

🚀 Quick Start

python setup.py
python mizu.py

• Run setup.py first for an easy, interactive configuration.

2. Access Dashboard: Open: http://localhost:2000

⚡ One-Click Deploy

No PC? No problem. Run Mizu OwO on the cloud for free (24/7).

---

🛡️ Is it Safe? (Transparency)

We know you're worried about bans. Here is exactly how Mizu protects your account:

1. Human-like Typing: The bot simulates typing status before sending messages.
2. Randomized Delays: It never sends commands at perfect intervals (e.g., 15.2s, then 16.5s, then 14.8s).
3. Sleep Schedule: You can set the bot to "sleep" for 8 hours a day, just like a real person.
4. Channel Switching: The bot moves between channels so it doesn't look like a stationary turret.
5. Noise/Jitter: Every action has a slight random time offset.

Disclaimer: Automation always carries a small risk. We recommend using an alt account or the "Safe" profile in the setup wizard.

🐳 Docker Deployment

1. Configure tokens: Create .env in the project directory.

2. Run with Docker Compose:

   docker-compose up -d

3. Access Dashboard: Open: http://localhost:2000

🔄 Auto-Update System

# Update to latest version with settings preservation
python updater.py

---

📖 Documentation

📋 Installation Guides

• 🪟 Windows Setup - Complete Windows installation guide
• 🐧 Linux Installation - Ubuntu, Debian, CentOS setup
• 🍎 macOS Setup - macOS installation guide
• 📱 Termux (Android) - Mobile setup guide

⚙️ Configuration

• 🔑 Token Setup - Discord token extraction and setup
• ⚙️ Settings - config/settings.json configuration options
• 🌐 Global Settings - config/global_settings.json system settings
• 🎯 Command Configuration - Individual command customization

🔒 Security & Tokens

We prioritize security. Instead of plain text files, we recommend using Environment Variables.

1. Rename .env.example to .env (or create a new .env file).
2. Add your tokens in the format:

   TOKENS="YOUR_TOKEN_1 CHANNEL_ID_1;YOUR_TOKEN_2 CHANNEL_ID_2"

   Note: Multiple accounts are separated by semicolons (;)
3. Legacy Support: tokens.txt is still supported but deprecated. Please migrate to .env.

🔧 Advanced Features

• 💎 AutoEnhance - Automatic gem usage and essence investment
• 🎯 AutoHuntBot - Huntbot automation and upgrades
• 💰 AutoSell - Smart item selling with triggers
• 🎲 RPP System - Random command execution
• 🔄 Multi-Account - Managing multiple Discord accounts

🛠️ Development

• 🤝 Contributing Guide - How to contribute
• 📝 API Documentation - Internal API reference
• 🧪 Testing - Testing procedures and guidelines
• 🔧 Development Setup - Local development environment

---

🎨 Screenshots

🖥️ Desktop CLI

🌐 Web Dashboard

---

🔧 API Integration

🌐 Mizu Network API

Our bot integrates with the live Mizu API for enhanced functionality:

• 📡 Status Monitoring - Real-time service health checks
• 📢 Announcements - Important updates and news
• 🔄 Version Checking - Automatic update notifications
• 🛡️ Safety Updates - Security patches and warnings
• 📊 Statistics - Usage analytics and performance metrics

API Endpoint: https://api.ive.my.id

🎛️ Web Dashboard API

The bot includes a built-in REST API for the web dashboard:

• 📊 /api/stats - Real-time statistics
• ⚙️ /api/settings - Configuration management
• 🎮 /api/commands - Command control
• 📈 /api/performance - Performance metrics

---

🤝 Contributing

We welcome all types of contributions! Whether you're a developer, designer, or just want to help improve documentation.

🌟 Ways to Contribute

• 🐛 Bug Reports - Found an issue? Let us know!
• 💡 Feature Requests - Have ideas? Share them!
• 💻 Code Contributions - Fix bugs or add features
• 📖 Documentation - Help improve guides and docs
• 🎨 Design - UI/UX improvements
• 🌐 Translations - Help make Mizu multilingual

📋 Getting Started

1. Read our Contributing Guidelines
2. Join our Discord Community
3. Check Good First Issues

🔧 Development Setup

# Fork and clone the repository
git clone https://github.com/kiy0w0/owomizu.git
cd owomizu

# Set up virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt
pip install -r requirements-dev.txt

# Install pre-commit hooks
pre-commit install

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

⚠️ Disclaimer

This bot is for educational purposes only. Use at your own risk. The developers are not responsible for any Discord account suspensions or bans that may result from using this bot.

---

🌟 Support & Community

💬 Get Help

🎯 Quick Links

Need Help With	Go To
🐛 Bug Reports	GitHub Issues
💡 Feature Requests	GitHub Discussions
❓ General Questions	Discord #help
💻 Development	Discord #development
📖 Documentation	Wiki

Made with 💙 by the Mizu Network Community

Stay Mizu, Stay Water 🌊

---

📊 Stats

---