🤖 NexusBot.NET

NexusBot.NET is a high-performance, feature-rich fork of SysBot.NET, designed for advanced remote control automation of Nintendo Switch Pokémon games. Developed and maintained by Nexus Risen, it provides a robust framework for automated distribution, encounter hunting, and collection management.

---

📑 Table of Contents

• 🌟 Key Features
• 📸 Screenshots
• 🏗️ Project Structure
• 📦 Dependencies
• 👨‍💻 Development
• 👥 Contributors
• 🤝 Support
• 📜 License

---

🌟 Key Features

🎮 Multi-Game Support

Automated trading and encounter bots for all modern Nintendo Switch Pokémon titles:

• Pokémon Legends: Z-A (PLZA): Full support for the latest generation.
• Pokémon Scarlet & Violet (SV): Including Tera Type handling and Scale information.
• Pokémon Legends: Arceus (LA): Specialized support for Alpha Pokémon and research tasks.
• Pokémon Brilliant Diamond & Shining Pearl (BDSP): High-performance trade logic using modernized async operations.
• Pokémon Sword & Shield (SWSH): Comprehensive support for all distribution types.
• Pokémon Let's Go, Pikachu! & Eevee! (LGPE): Legacy support for Kanto-based distributions.

🔗 Multi-Platform Integrations

Full remote control and interaction support across multiple platforms:

• Discord Integration: Comprehensive interface for remote interaction, queue management, and visual trade reports using Discord.Net.
• Kook Integration: Native support for the Kook platform (KaiHeiLa) using Kook.Net. Features full parity with Discord, including native Kook Card paginated event listings, Battle Ready database requests, and hidden trades for a seamless experience in the Chinese community.
• Stoat Integration: Seamlessly connect and interact with your bots using the Stoat messaging platform.
• Twitch Integration: Automated queue management and interaction for live streamers via TwitchLib.
• YouTube Integration: Direct interaction with YouTube Live chat for automated distribution using Google.Apis.YouTube.v3.

🗣️ Universal Translation Engine

• Global Support: Full auto-detection and translation for Japanese, French, Italian, German, Spanish, Korean, and Chinese (Simplified/Traditional).
• High-Performance Caching: Implemented a thread-safe ConcurrentDictionary cache for species and moves across all languages, making translations near-instant.
• Comprehensive Dictionaries: Updated language-specific keywords for items, genders, shiny status, stats, and regional forms.

🤖 Automation & Intelligence

• Auto-Legality Mod (ALM): Integrated on-the-fly legalization ensures all distributed Pokémon meet strict legality standards.
• High-Performance Logic: BDSP trade routines refactored with Span<byte> and MemoryMarshal for maximum speed and zero-allocation memory management.
• Async Modernization: Fully non-blocking batch trade sequences using Task-based operations.
• AutoOT Integration: Personalize Pokémon with the receiver's trainer information automatically.
• Item Batching: The itemTrade ($it) command now supports requesting up to 3 items at once, automatically generating a batch trade for efficiency.

🧠 AI Chatbot Integration

NexusBot.NET features a state-of-the-art AI Chatbot powered by Hugging Face and the OpenAI-compatible Chat Completions API.

• Natural Language Requests: Request Pokémon using normal conversation (e.g., "@NexusBot can I have a competitive Mewtwo?").
• Conversation Memory: The bot now remembers the last 10 messages, allowing for follow-up questions and refined requests (e.g., "Actually, make it Shiny").
• Automated Queueing: The AI generates legal Showdown sets and, upon your confirmation, adds them directly to the trade queue.
• Robust Legality Guard: All AI-suggested Pokémon are verified by the internal PKHeX engine. If a set is illegal, the bot automatically asks the AI to fix it using error feedback.
• Advanced Tuning: Full control over Max Tokens, Temperature, and Top P via configuration settings to adjust AI creativity and response length.
• AI Commands:
  • $ai - Interactive help guide for AI features.
  • $clearAI - Instantly reset your conversation history.
• Learn More: See the AI Chatbot Wiki for setup instructions.

📊 Enhanced Discord Experience

• Visual Embeds: Multi-column layouts for clean and professional data visualization.
• Advanced Metadata:
  • Hyper Trained (HT) indicators for IVs.
  • Origin & Physical: Clear display of Met Level, Met Date, and Met Location (with ID).
  • Scale Visualization: See exactly how big or small your Pokémon is.
• Refined Nature Logic: Detailed display for minted natures, showing both intended stats and visual nature (e.g., Adamant (Minted from: Jolly)).
• Special Symbols: Professional iconography for Shiny, Alpha, Marks, and Ribbons.

---

📸 Screenshots

View Application Previews

Bots Dashboard

Localization & Language

Settings Configuration

Real-time Logs

Tray Icon Management

---

🏗️ Project Structure

Component	Description
SysBot.Base	Core logic library containing synchronous and asynchronous bot connection classes.
SysBot.Pokemon	Game-specific logic for Pokémon Sword/Shield and subsequent Switch titles.
SysBot.Pokemon.WinForms	User-friendly GUI launcher for managing and configuring Pokémon bots.
SysBot.Pokemon.Discord	Comprehensive Discord interface for remote interaction and queue management.
SysBot.Pokemon.Kook	Native Kook platform interface with rich CardBuilder support for the Chinese community.
SysBot.Pokemon.Stoat	Native Stoat platform interface for queue management and operations.
SysBot.Pokemon.ConsoleApp	Lightweight console interface for headless bot operations.
SysBot.Tests	Extensive unit test suite (50+) ensuring logic stability and correctness.

---

📦 Dependencies

NexusBot.NET leverages several powerful open-source libraries:

• Core Engine: Powered by a custom fork of PKHeX.Core by @hexbyt3.
• Automation: sys-botbase for console communication.
• Legality: Integrated Auto-Legality Mod (using @santacrab2's fork).
• Integrations: Discord.Net, TwitchLib, and StreamingClientLibrary.

---

👨‍💻 Development

NexusBot.NET is actively developed by Nexus Risen and a dedicated team of contributors. The project follows a Steering Committee governance model and a community Code of Conduct.

💬 Developer Discord Hangout

Are you a developer looking to collaborate? Join our Developer Discord Server! This is a dedicated hangout for developers working on programs based on the SysBot.NET framework (such as NexusBot.NET, DudeBot.NET, and FusionBot.NET) to share ideas, troubleshoot, and improve these projects together over time.

See the full list of Contributors.

• kwsch - Original Creator (SysBot.NET & PKHeX)
• Nexus Risen - Main Developer
• Lusamine - Research & Data Analysis
• Hexbyt3 - Core Engine Enhancements
• Secludedly - Medals, Refactoring & Feature Enhancements
• SantaCrab2 - Auto-Legality Mod (ALM)
• Link - Program Contributor (Ideas, Feedback & Project Support)
• Havok - Program Contributor (Ideas, Feedback & Project Support)

---

👥 Contributors

Thanks to these wonderful people:

kwsch 💻 🚧	Nexus Risen 💻 🎨 🚧	Lusamine 🔬 📊	Hexbyt3 💻
Secludedly 💻 🚧	SantaCrab2 💻	Link 🎨	Havok 🎨

---

🤝 Support

Need help setting up your instance or troubleshooting an issue?

• 📖 Support Guide: Find all the ways to get help.
• 📚 Official Wiki: Detailed setup and feature guides.

Note: This bot is a fork of SysBot.NET. Please do not contact the PKHeX Development Project for support regarding NexusBot.NET.

---

📜 License

NexusBot.NET is licensed under the AGPLv3. See LICENSE for more details.