NatsukiSpammerDroid

Kivy mobile port of Natsuki Spammer (PocketMine-MP bot controller).

Requirements

• Linux (WSL2 on Windows) or native Linux
• Python 3.11+
• Android SDK + NDK (auto-installed by Buildozer)
• Java JDK 17

Quick Start (Linux / WSL2)

# Install buildozer
pip install buildozer

# Copy project to Linux filesystem (WSL2)
cp -r NatsukiSpammerDroid ~/NatsukiSpammerDroid
cd ~/NatsukiSpammerDroid

# Build debug APK (first build takes 30-60 min)
buildozer -v android debug

# APK output:
# bin/natsukispammer-1.0-debug.apk

Install on Android

1. Copy the .apk to your phone
2. Enable "Install from unknown sources" in Android settings
3. Tap the APK to install
4. Place nicks.txt / socks5.txt in the app's data directory if needed

Project Structure

main.py              Kivy GUI + bot engine launcher
mcbot.py             Core bot logic (RakNet, spam, registration)
proxy.py             SOCKS5 proxy pool + free proxy fetcher
buildozer.spec       Buildozer config for APK compilation

Notes

• Proxies and nicks files are stored in the app's private storage directory
• The bot uses raw UDP sockets (RakNet) which work on Android
• First build downloads Android SDK/NDK (~2GB), subsequent builds are fast
• Use buildozer android clean to reset the build environment