{"id":26729007,"url":"https://github.com/itzmaniss/mist-bot","last_synced_at":"2025-10-14T11:35:48.761Z","repository":{"id":274934601,"uuid":"807635025","full_name":"itzmaniss/MIST-Bot","owner":"itzmaniss","description":"A versatile Discord bot for Minecraft server management, music playback, and community games. Features server controls, YouTube music streaming, interactive counting games, and moderation tools.","archived":false,"fork":false,"pushed_at":"2025-05-06T04:34:55.000Z","size":6862,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-14T11:35:26.554Z","etag":null,"topics":["bot","counting-bot","discord","music-bot-discord","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/itzmaniss.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"license","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-05-29T13:31:46.000Z","updated_at":"2025-05-06T04:34:58.000Z","dependencies_parsed_at":"2025-04-05T13:28:23.306Z","dependency_job_id":"83d8b793-e30d-4934-b874-56da9d177c00","html_url":"https://github.com/itzmaniss/MIST-Bot","commit_stats":null,"previous_names":["itzmaniss/mist-bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/itzmaniss/MIST-Bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itzmaniss%2FMIST-Bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itzmaniss%2FMIST-Bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itzmaniss%2FMIST-Bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itzmaniss%2FMIST-Bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/itzmaniss","download_url":"https://codeload.github.com/itzmaniss/MIST-Bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itzmaniss%2FMIST-Bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279019062,"owners_count":26086516,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","counting-bot","discord","music-bot-discord","python"],"created_at":"2025-03-27T22:38:13.524Z","updated_at":"2025-10-14T11:35:48.728Z","avatar_url":"https://github.com/itzmaniss.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Discord Bot\n\nThis is a multi-purpose Discord bot built with Python and the discord.py library. It includes several features such as server management for Minecraft servers, music playback, and a smoking feature. \n\n## Table of Contents\n- [Features](#features)\n- [Installation](#installation)\n  - [Prerequisites](#prerequisites)\n  - [Setup](#setup)\n- [Configuration](#configuration)\n- [Usage](#usage)\n  - [Minecraft Server Management](#minecraft-server-management)\n  - [Music Playback](#music-playback) \n  - [Smoking Feature](#smoking-feature)\n- [File Structure](#file-structure)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Features\n\n- **Minecraft Server Management**: Start and stop Minecraft servers using the API of a server management panel. Includes safeguards to prevent abuse and ensure only authorized users can manage the servers.\n\n- **Music Playback**: Play music in a voice channel using YouTube as the source. Supports queuing songs, skipping tracks, pausing/resuming, looping, and more. Also fetches lyrics for the currently playing song.\n\n- **Smoking Feature**: A fun feature that allows users with a specific role to \"wake up\" other users by pinging them repeatedly. Includes checks to ensure it's used in the appropriate channels and by authorized users.\n\n## Installation\n\n### Prerequisites \n\n- Python 3.7+\n- discord.py \n- yt-dlp\n- aiohttp\n- toml\n- ffmpeg\n- opus\n\n### Setup\n\n1. Clone the repository:\n   ```\n   git clone https://github.com/yourusername/discord-bot.git\n   ```\n\n2. Install the required dependencies:\n   ```\n   pip install -r requirements.txt\n   ```\n\n3. Make sure FFMpeg, yt-dlp and opus are installed\n\n4. Set up the necessary configuration files (see [Configuration](#configuration)).\n\n5. Run the bot:\n   ```\n   python main.py\n   ```\n\n## Configuration\n\nThe bot's configuration is stored in a `config.toml` file. An example configuration file is provided in `config/config.toml`. You'll need to edit this file to include your bot token, server management API details, allowed users and channels, and more.\n\n## Usage\n\n### Minecraft Server Management\n\n- `/start \u003cserver\u003e`: Start a Minecraft server. Replace `\u003cserver\u003e` with the name of the server (e.g., \"vanilla\", \"ATM9\").\n- `/stop \u003cserver\u003e`: Stop a Minecraft server.\n\n### Music Playback\n\n- `/join`: Join a voice channel.The bot will join the channel the user is currently in.\n- `/play \u003cquery\u003e`: Play a song from YouTube. `\u003cquery\u003e` can be a search term or a YouTube URL.\n- `/pause` or `/resume`: Pause or resume playback.\n- `/skip`: Skip the currently playing song. \n- `/queue` or `/q`: Show the current song queue.\n- `/clear`: Clear the song queue.\n- `/remove \u003cposition\u003e`: Remove a song from the queue at the specified position.\n- `/volume \u003cvolume\u003e` or `/vol \u003cvolume\u003e`: Set the volume to a value between 0 and 100.\n- `/loop`: Toggle loop mode on or off.\n- `/np`, `/now`, or `/playing`: Show the currently playing song.\n- `/seek \u003ctimestamp\u003e`: Seek to a specific position in the current song. `\u003ctimestamp\u003e` can be in the format \"MM:SS\" or a number of seconds.\n- `/replay` or `/restart`: Replay the current song from the beginning.\n- `/lyrics [song]` or `/ly [song]`: Fetch the lyrics for the specified song. If no song is specified, the lyrics for the currently playing song will be fetched.\n\n### Smoking Feature\n\n- `/wakey \u003cuser\u003e`: \"Wake up\" a user by pinging them repeatedly. Only available to users with the \"smoker\" role and usable in designated channels.\n- `/woken`: Stop the pinging for a user.The pinging for the user who used the command will be stopped.\n\n## File Structure\n\n- `main.py`: The main entry point of the bot.\n- `config/`: Contains configuration files.\n  - `config.py`: Loads the configuration from `config.toml` and provides it to the rest of the application.\n  - `config.toml`: The main configuration file. \n- `core/`: Contains core functionality of the bot.\n  - `bot.py`: Defines the main `DiscordBot` class.\n  - `server_manager.py`: Handles interactions with the Minecraft server management API.\n- `features/`: Contains the different features of the bot.\n  - `base.py`: Defines a base `BotFeature` class that all features inherit from.\n  - `minecraft.py`: Implements the Minecraft server management feature.\n  - `music.py`: Implements the music playback feature.\n  - `smoking.py`: Implements the smoking feature.\n- `utils/`: Contains utility functions and classes. \n  - `helpers.py`: Various helper functions used throughout the bot.\n  - `logger.py`: A simple logging utility.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is open source and available under the [MIT License](LICENSE).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitzmaniss%2Fmist-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitzmaniss%2Fmist-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitzmaniss%2Fmist-bot/lists"}