Skip to content

Automate your Mudae waifu/husbando collection with MudaRemote! Open-source bot featuring auto-claiming and real-time sniping for characters and series.

License

Notifications You must be signed in to change notification settings

misutesu-desu/MudaRemote

Repository files navigation

English | Türkçe | Français | 简体中文 | 日本語 | 한국어

✨ MudaRemote: Advanced Mudae Automation ✨

Discord TOS Violation - USE CAUTIOUSLY ⚠️ ACCOUNT BAN RISK! ⚠️

🛑🛑🛑 WARNING: SELF-BOT - POTENTIAL DISCORD TOS VIOLATION! ACCOUNT BAN RISK! 🛑🛑🛑 🔥 USE AT YOUR OWN RISK! 🔥 WE ARE NOT RESPONSIBLE FOR ANY ACTIONS TAKEN AGAINST YOUR ACCOUNT. 😱


🚀 MudaRemote: Enhance Your Mudae Experience (Use Responsibly!)

MudaRemote is a Python-based self-bot designed to automate various tasks for the Discord bot Mudae. It offers features like real-time sniping and intelligent claiming. However, using self-bots is against Discord's Terms of Service and may lead to account suspension or ban. Please use with extreme caution and understand the risks involved.

✨ Core Features:

  • 🎯 External Sniping (Wishlist, Series & Kakera Value):
    • Wishlist Sniping: Claims characters from your wishlist when rolled by others (configurable delay).
    • Series Sniping: Claims characters from your series wishlist when rolled by others (configurable delay).
    • Kakera Value Sniping: Claims characters based on their kakera value (if above threshold) when rolled by others.
  • 🟡 External Kakera Reaction Sniping (New!): Automatically clicks kakera reaction buttons on any Mudae message.
  • 😴 Snipe-Only Mode: Configure bot instances to only listen for and execute external snipes, without sending roll commands.
  • ⚡ Reactive Self-Roll Sniping: Instantly claims characters from your own rolls if they match criteria (wishlist, series, kakera value). Interrupts current rolling batch.
  • 👯 Multi-Account Support: Run multiple bot instances simultaneously, each with its own configuration.
  • 🤖 Automated Rolling & General Claiming: Handles rolling commands and makes general claims based on minimum kakera after rolls.
  • 🥇 Intelligent Claim Logic: Utilizes $rt for a potential second claim.
  • 🔄 Auto Roll & Claim Reset Detection: Monitors and waits for Mudae's reset timers.
  • 🔑 Key Mode: Enables continuous rolling for kakera collection, even when main character claim rights are on cooldown.
  • ⏱️ Customizable Delays & Roll Speed: Adjust general action delays and roll command speed.
  • 🗂️ Easy Preset Configuration: Manage all settings via a presets.json file.
  • 📊 Console Logging: Clear, color-coded real-time output of bot actions and status.

🛠️ Setup Guide

  1. 🐍 Python: Ensure Python 3.8+ is installed. (Download Python)
  2. 📦 Dependencies: Open your terminal or command prompt and run:
    pip install discord.py-self inquirer
  3. 📝 presets.json: Create a presets.json file in the script's directory. Add your bot configurations here. See the example below for all available options.
  4. 🚀 Run: Execute the script from your terminal:
    python mudae_bot.py
    (Replace mudae_bot.py with your script's actual filename if different).
  5. 🕹️ Select Presets: Choose which configured bot(s) to run from the interactive menu.

presets.json Configuration Example:

{
  "YourBotAccountName": {
    // --- REQUIRED SETTINGS ---
    "token": "YOUR_DISCORD_ACCOUNT_TOKEN", // Your Discord account token. KEEP THIS EXTREMELY SECRET!
    "channel_id": 123456789012345678,     // ID of the Discord channel for Mudae commands.
    "roll_command": "wa",                  // Your preferred Mudae roll command (e.g., wa, hg, w, ma). Only used if "rolling" is true.
    "delay_seconds": 1,                    // General delay (seconds) between some bot actions (e.g., after $tu before parsing). Only used if "rolling" is true.
    "mudae_prefix": "$",                   // The prefix Mudae uses in your server (usually "$").
    "min_kakera": 50,                      // Minimum kakera value for general (post-roll batch) character claims. Only used if "rolling" is true.

    // --- CORE OPERATIONAL MODE ---
    "rolling": true,                       // (Default: true) If true, bot performs rolling, claiming, $tu checks, etc.
                                           // If false, bot enters SNIPE-ONLY mode: no rolling, no $tu checks, only listens for external snipes.

    // --- OPTIONAL SETTINGS (Some depend on "rolling: true") ---
    "key_mode": false,                     // (Default: false) If true AND "rolling" is true, rolls for kakera even if no character claim right is available.
    "start_delay": 0,                      // (Default: 0) Delay (seconds) before the bot starts after being selected in the menu.
    "roll_speed": 0.4,                     // (Default: 0.4) Delay (seconds) between individual roll commands. Only used if "rolling" is true.

    // External Sniping Settings (for characters/kakera rolled by OTHERS - Always active if configured, regardless of "rolling" status)
    "snipe_mode": true,                    // (Default: false) Enable external wishlist sniping (heart claims).
    "wishlist": ["Character Name 1", "Character Name 2"], // List of character names for heart sniping.
    "snipe_delay": 2,                      // (Default: 2) Delay (seconds) before claiming an external wishlist snipe AND external kakera value snipe.

    "series_snipe_mode": true,             // (Default: false) Enable external series sniping (heart claims).
    "series_wishlist": ["Series Name 1"],  // List of series names for heart sniping.
    "series_snipe_delay": 3,               // (Default: 3) Delay (seconds) before claiming an external series snipe.

    "kakera_reaction_snipe_mode": false,   // (Default: false) Enable external kakera REACTION sniping (clicks kakera buttons).
    "kakera_reaction_snipe_delay": 0.75,   // (Default: 0.75) Delay (seconds) before clicking an external kakera reaction.

    // Reactive Sniping Settings (for characters/kakera from YOUR OWN rolls - Only active if "rolling: true")
    "reactive_snipe_on_own_rolls": true,   // (Default: true) Enable/disable INSTANT reactive heart claims AND kakera clicks during YOUR OWN rolls.
                                           // If true, uses wishlist, series_wishlist, and kakera_snipe_threshold (if kakera_snipe_mode is true) as criteria for heart claims.
                                           // Kakera on these reactively claimed characters will also be clicked.
                                           // If false, all claims/kakera clicks for own rolls happen after the roll batch is complete.

    // Kakera Threshold Settings (used for BOTH reactive self-roll HEART claims AND external kakera value HEART snipes)
    "kakera_snipe_mode": true,             // (Default: false) If true, enables `kakera_snipe_threshold` as a criterion for HEART claims for:
                                           //    1. INSTANT reactive heart claims during own rolls (if "rolling" AND reactive_snipe_on_own_rolls are true).
                                           //    2. DELAYED external kakera value-only heart snipes (uses `snipe_delay`).
    "kakera_snipe_threshold": 100,         // (Default: 0) Minimum kakera value to trigger HEART claims mentioned above if `kakera_snipe_mode` is true.

    // Other (Only active if "rolling: true")
    "snipe_ignore_min_kakera_reset": false // (Default: false) If true, for post-roll general claims, min_kakera is effectively 0 if your claim reset is <1hr away.
                                           // This does NOT affect reactive sniping or external kakera value sniping thresholds.
  }
  // Add more presets for other accounts here, separated by commas.
}

🎮 Obtaining Your Discord Token 🔑

Self-bots require your Discord account token. This token grants full access to your account – keep it extremely private! Sharing it is like giving away your password. It is recommended to use this bot on an alternative account.

  1. Open Discord in your web browser (e.g., Chrome, Chrome, Firefox). Not the desktop app.
  2. Press F12 to open Developer Tools.
  3. Navigate to the Console tab.
  4. Paste the following code snippet into the console and press Enter:
    window.webpackChunkdiscord_app.push([
    	[Symbol()],
    	{},
    	req => {
    		if (!req.c) return;
    		for (let m of Object.values(req.c)) {
    			try {
    				if (!m.exports || m.exports === window) continue;
    				if (m.exports?.getToken) return copy(m.exports.getToken());
    				for (let ex in m.exports) {
    					if (m.exports?.[ex]?.getToken && m.exports[ex][Symbol.toStringTag] !== 'IntlMessagesProxy') return copy(m.exports[ex].getToken());
    				}
    			} catch {}
    		}
    	},
    ]);
    
    window.webpackChunkdiscord_app.pop();
    console.log('%cWorked!', 'font-size: 50px');
    console.log(`%cYou now have your token in the clipboard!`, 'font-size: 16px');
  5. Your token will be copied to your clipboard. Carefully paste it into the "token" field in your presets.json file.

🤝 Contributing

Contributions are welcome! Feel free to report issues, suggest features, or submit pull requests to the project repository.

🙏 Please use this tool responsibly and ethically, with full awareness of the potential risks to your Discord account. 🙏

Happy (and Cautious!) Mudae-ing! 😉


License: MIT License

About

Automate your Mudae waifu/husbando collection with MudaRemote! Open-source bot featuring auto-claiming and real-time sniping for characters and series.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages