Skip to main content

A framework that makes discord bot programming easy

Reason this release was yanked:

documentation contained typos

Project description

██████╗ ██╗  ██╗ ██████╗ ███╗   ██╗██╗  ██╗██████╗     ██████╗  ██████╗ ████████╗
██╔══██╗██║  ██║██╔═══██╗████╗  ██║██║ ██╔╝██╔══██╗    ██╔══██╗██╔═══██╗╚══██╔══╝
██████╔╝███████║██║   ██║██╔██╗ ██║█████╔╝ ██║  ██║    ██████╔╝██║   ██║   ██║   
██╔═══╝ ██╔══██║██║   ██║██║╚██╗██║██╔═██╗ ██║  ██║    ██╔══██╗██║   ██║   ██║   
██║     ██║  ██║╚██████╔╝██║ ╚████║██║  ██╗██████╔╝    ██████╔╝╚██████╔╝   ██║   
╚═╝     ╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚═════╝     ╚═════╝  ╚═════╝    ╚═╝   
---------------------------------------------------------------------------------

License: MIT

Phonkd_bot is a free discord bot framework made with the intent to help beginner programmers learn python. It allows you to take console-based programs and convert them into discord bots by substiting the input and print functions. It takes the Discord library and abstracts all of the complex functionality to make writing these programs simpler.

Setup

Installation

Before installing pygame, you must check that Python is installed on your machine. To find out, open a command prompt (if you have Windows) or a terminal (if you have MacOS or Linux) and type this:

python --version

If a message such as "Python 3.8.10" appears, it means that Python is correctly installed. If an error message appears, it means that it is not installed yet. You must then go to the official website and install it.

Once Python is installed, you have to perform a final check: you have to see if pip is installed. Generally, pip is pre-installed with Python but we are never sure. Same as for Python, type the following command:

pip --version

If a message such as "pip 20.0.2 from /usr/lib/python3/dist-packages/pip (python 3.8)" appears, you are ready to install the library. To install it, enter this command:

pip install phonkd_bot

Creating a Discord Bot

Now you will need to create a discord bot, to do so, follow these instructions:

  1. Go to discord.com/developers/applications
  2. Click New Application
  3. Give the bot a name, agree to the terms, then click Create
  4. (optional) give the bot a profile picture, tags, and or a description, then click Save Changes
  5. Go to the Bot page on the side panel
  6. (optional) give the bot a username
  7. Click Reset Token, Yes, do it! and Copy, save the token somewhere safe
  8. Allow Presence Intent, Server Members Intent, and Message Content Intent
  9. Click Save Changes
  10. Expand OAuth2 on the side panel and go to URL Generator
  11. Check bot, this will reveal Bot Permissions, you will need to check Administrator in this new section
  12. Scroll down, and open the generated url in another tab
  13. Select the server to add the bot to and click Continue
  14. Make sure Administrator is checked and click Authorize
  15. Do the captcha (if one appears) and close the window once you see "Success!" on your screen

Setting up the environment

Create a file named config.json in the same directory as your script. Copy and paste your bot token (from discord.com/developers) into the file, it should look something like this:

{
    "token": "MTE2nze0MDYzmzk5MTk5MTMxNg.Gm0Mnf.kmsdIjbvOZFMIs94ipxOCt70aLs3lKQsl0VaPE"
}

This token is not real, you will need to replace it with your own.

Help

If you want to use this framework check out the reference documentation on the docs page. If you find issues with this library please reach out to me.

Meta

Gmail - phonkibusiness@gmail.com

Github - https://github.com/RealPhonki

Find me on the Python Discord Server - https://discord.com/invite/python

Discord Tags - Phonki#0090, slamsandwich19

Code distributed under the MIT license. See LICENSE for more information.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

phonkd_bot-1.0.1.tar.gz (11.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

phonkd_bot-1.0.1-py3-none-any.whl (10.9 kB view details)

Uploaded Python 3

File details

Details for the file phonkd_bot-1.0.1.tar.gz.

File metadata

  • Download URL: phonkd_bot-1.0.1.tar.gz
  • Upload date:
  • Size: 11.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for phonkd_bot-1.0.1.tar.gz
Algorithm Hash digest
SHA256 4201a92cfffd6db936e8f7c922075f30203d509989211bb30a1b1b60beca051d
MD5 7b566fc5d71f4f6e842d6f70c2176d49
BLAKE2b-256 299725095a34e6622e6d7e2b37332a58fedf81211cd1bac72619fb1dfe722da5

See more details on using hashes here.

File details

Details for the file phonkd_bot-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: phonkd_bot-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 10.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for phonkd_bot-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b398f75e62ac511d9b063ac79a10fe1111763c70fe6eb9cb53dcb92252d3860a
MD5 49840d82e0a33642f5a39989ba4dbd44
BLAKE2b-256 1038fc2fd4fda0370c4e9d1a03b6cf496d0ea6da3c740d574f0fc9efbfa11213

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page