Skip to content

AI Chatbot

Jump to bottom
DudeBot Bot edited this page Jun 25, 2026 · 7 revisions

AI Chatbot Integration (v6.2.0+)

NexusBot.NET features a powerful AI chatbot powered by Hugging Face's Inference API. This chatbot acts as an expert Pokémon assistant, capable of answering questions, generating competitive Showdown sets, and automatically adding them to the trade queue.

Features

  • Natural Language Requests: Ask for Pokémon naturally (e.g., "@NexusBot, can I have a competitive Mewtwo?").
  • Conversation History (v6.2.1+): I remember the last 10 messages in our conversation, so you can ask follow-up questions like "Make it shiny instead" or "Change its held item".
  • Real-Time PKHeX Integration (v6.2.1+): The AI now "reads" actual game data! Powered by the latest PKHeXth (v26.05.05-rev.3) engine, the bot extracts legal abilities and metadata for the requested Pokémon directly from the core library and provides it to the AI as a reference.
  • ALM Override Awareness (v6.2.1+): The AI is trained to use ~ RegenTemplate overrides (e.g., ~Ball: Luxury Ball) to ensure 100% legal generation for specific user requirements, leveraging the latest AutoLegalityMod updates.
  • Auto OT Intelligence (v6.2.1+): The AI understands that the bot applies Auto OT (personalization) by default. It will omit OT details for common requests but knows to preserve original OT/ID information for Event Pokémon and specific Mystery Gifts.
  • Expert Knowledge: The AI is trained on Pokémon competitive play (Smogon/VGC), historical events, and legality.
  • Automated Queueing: If the AI provides a valid Showdown set, it will ask if you want to be added to the queue.
  • Legality Guard: All AI-generated Pokémon are verified by the internal PKHeX.Core engine. If a set is illegal (e.g., shiny-locked), the AI is automatically asked to fix it before you are queued.

Setup Instructions

To enable the AI chatbot:

  1. Get a Hugging Face Token:
    • Create a free account at huggingface.co.
    • Go to Settings > Access Tokens and create a new "Read" token.
  2. Configure NexusBot.NET:
    • Open the WinForms application.
    • Navigate to Discord Settings > AI Settings.
    • Paste your Hugging Face API Key.
    • Set Enable AI Chatbot to True.
  3. Model Selection & Advanced Tuning:
    • Model: By default, the bot uses mistralai/Mistral-7B-Instruct-v0.2.
    • Max Tokens (v6.2.1+): Controls the maximum length of the AI's response (default: 800).
    • Temperature (v6.2.1+): Adjusts creativity (0.0 = deterministic, 1.0 = highly creative). Default: 0.7.
    • Top P (v6.2.1+): Fine-tunes word diversity via nucleus sampling. Default: 0.9.
  4. Restart the Bot: Restart the application to initialize the AI service.

Commands (v6.2.1+)

You can use the following commands (using your configured command prefix, e.g., $) to manage the AI:

  • $ai: Displays a help guide for the AI chatbot directly in Discord.
  • $clearAI: Clears your personal conversation history. Useful if the AI gets confused or you want to start a completely new topic.

How It Works

  1. Mention the Bot: Mention your bot in a whitelisted Discord channel with your request.
  2. AI Response: The AI will respond with information about your request. If a Pokémon was requested, it will provide a Showdown set wrapped in tags.
  3. Follow-up (v6.2.1+): Since the bot now has memory, you can reply to its message or mention it again to refine your request (e.g., "Actually, give it a Jolly nature").
  4. Confirmation: The bot will ask: "Would you like to be put in the queue for this Pokemon? (Yes/No)".
  5. Queueing: Reply with "Yes" or "Y", and you will be added to the trade queue!

Troubleshooting

  • "I couldn't think of a response right now": This usually means the Hugging Face API is rate-limited or the model is still loading. Wait 30 seconds and try again.
  • "Set is illegal": If the AI suggests an illegal Pokémon, the bot will attempt to ask the AI for a fix. If it still fails, it will notify you of the legality error.

Clone this wiki locally