{"id":22242847,"url":"https://github.com/theluqmn/matta","last_synced_at":"2025-07-28T01:32:02.111Z","repository":{"id":200490001,"uuid":"682494977","full_name":"theluqmn/Matta","owner":"theluqmn","description":"A Discord bot template","archived":false,"fork":false,"pushed_at":"2024-04-22T04:14:44.000Z","size":64,"stargazers_count":4,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-08-26T19:55:15.155Z","etag":null,"topics":["bot","discord","discord-bot","discord-py","pycord","pycord-bot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theluqmn.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}},"created_at":"2023-08-24T09:44:58.000Z","updated_at":"2024-05-10T02:59:50.000Z","dependencies_parsed_at":null,"dependency_job_id":"c2cbbfd6-4552-4c59-b8a1-174c195f381e","html_url":"https://github.com/theluqmn/Matta","commit_stats":null,"previous_names":["luqmanity/matta","luqmanually/matta","luq-mn/matta","theluqmn/matta"],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theluqmn%2FMatta","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theluqmn%2FMatta/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theluqmn%2FMatta/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theluqmn%2FMatta/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theluqmn","download_url":"https://codeload.github.com/theluqmn/Matta/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227850100,"owners_count":17829104,"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","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","discord","discord-bot","discord-py","pycord","pycord-bot"],"created_at":"2024-12-03T04:17:52.362Z","updated_at":"2024-12-03T04:17:52.878Z","avatar_url":"https://github.com/theluqmn.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Måtta The Discord Bot\n\n**Please note that this project has not been updated for at least 5 months. Some scripts may not work as intended**.\nThis is the rewritten and latest version of Måtta. The LEGACY version can be found [here](https://github.com/luqmanity/matta-legacy) (legacy version is no longer supported)\n\nJoin the Discord Server for support, etc:\nhttps://discord.gg/7w8b6MMXBy\n\nMåtta is an open-sourced Discord bot made by luqmanity and several\nother contributors, using `pycord` (a fork of discord.py).\nThis bot also uses cogs, command groups, and discord views and UI.\nIt is recommended to at least have some experience working on\nDiscord bots, and pycord, if you would like to contribute to the project.\n\nThis repo includes an overview of how to run the bot and other useful informations. Use `/help` after completing setup!\n\n**Usage of the source code for commercial, private, or fun uses is allowed, as long as this repo is credited. The crediting needs to be easily visible.**\n\n## How to run\n\nBelow are the instructions on how to run this bot on your local machine.\n\n### 1 - Discord application, bot\n\nYou'll need a Discord bot token in order for this to work. Head over to [discord.com/developers](https://discord.com/developers/applications), and create/select an application.\nOpen the application, then go to the Bots page and click that reset token button to generate a token.\n**Do note that if you have an existing code that uses a token, clicking that reset disables the old token and you'll have to use the newly generated one.**\n\nCopy the token displayed. If you have 2FA enabled, you may need to enter authorization code.\n![image](https://github.com/luqmanity/matta/assets/75654558/89826e88-a539-4a5b-a80b-ad40e689dbbd)\n\n### 2 - Setup\n\nSetting up is easy, simply run `main.py` and it will ask if to open **Config Panel** - simply\nproceed by inputting **y**.  It should output a panel on the console, that shows available actions and\nit's description. Simply input \"setup\", and once \"setup complete\" is outputted, all required folders\nand files should be created in the project folder.\n\n**The folders and files created are required for the bot to function, but is excluded from \nthis repo so that anyone can just keep their old data even when running off a newer version.**\n\n**Alternatively**, you can run the `config.py` script located in the project.\n\nPlease note that if you ran `main.py` to open the Config Panel, the bot will run after\nthe Config Panel closed (using `quit`).\n\n### 3 - Token\n\nNow that we've got all the required files and folders, all that is left is the bot token. Open the `data`\nfolder in the project folder (by default: matta/data), then open `.env`.\n\nOnce opened, edit to include the following variable:\n\n```env\nTOKEN = \"Your Bot Token\"\n```\n\nYour Discord bot should work now! Do note that Discord will reset/disable the token if they found it\nsomewhere in the internet. Discord will DM you to inform if that happens. Please do **NOT** share your\ndiscord bot's token anywhere unsecure, and it's best to keep it to yourself or your team. If you need\nto share the token, please encrypt it so only those with the key(s) can view the token.\n\nThe token will be invalid if Discord found it on the internet via crawlers, if so happens, Discord will notify you regarding this and will ask you to generate a new one.\n\n## Updating\n\nYou can easily update the bot by downloading the source code, then running `config.py`. The process\nis similar to when you first setup the bot. The `setup()` function will check\nwhat files, folders, etc is missing, then later creates it. *If it exists but is on an outdated format,\nit will be updated and included with new data. (Planned)*\n\n## Config panel\n\nThis project includes `config.py`, which is a console-based panel created specifically help with\na variety of tools that can help you manage and customise the bot the way you want it to be!\n\nThe Config Panel is updated in every major release.\n\n## The future of this project\n\nI will work on a major rewrite of this project this year (2024). ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheluqmn%2Fmatta","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheluqmn%2Fmatta","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheluqmn%2Fmatta/lists"}