the one and only JhonMicro 🤖

a discord.py bot for my itch.io game jam Micro Jam, where anyone can help with development!

Installation (cloning the repo)

git clone https://github.com/t33devv/jhonmicro.git

How to help with Development/Contribution

1. Fork the repository

Start by clicking the "fork" button on github

git clone https://github.com/your_username/jhonmicro.git
cd jhonmicro

2. Create a new feature branch

git checkout -b feat/your-feature-name

3. Commit your changes

# check where you made edits
git status

# stage changes
git add main.py           # or anywhere else you made changes

# write a good commit message
git commit -m "added slash command to view all micro jams"

4. Push to the branch

git push origin feat/your-feature-name

5. Open a Pull Request from Github

Quick Start the Bot (E.G. if you want to use this as a template for your own bot)

1. Create a Discord bot from the Discord Developer Portal

• Add the bot to any server you like (create a new one for testing purposes)
• Make sure the bot has the server members intent and the message content intent
• Make sure the bot has slash commands and show messages permissions in the server

2. Create a .env file:

• Create a file in the jhonmicro folder called .env
• Add these lines in the file, replacing the values as needed for your bot and server

TOKEN = your_token_here
GUILD_ID = your_discord_server_id_here
WELCOME_CHANNEL_ID = your_welcome_channel_id_here
LEAVE_CHANNEL_ID = your_leave_channel_id_here
LEVEL_CHANNEL_ID = your_level_channel_id_here

to get the guild_id you'll need discord developer mode which can be turned on in your profile settings

3. If you don't have UV, run:

pip install uv
uv version

4. Navigate to your project folder, and run:

uv run main.py

5. Now the bot should be live in the server you put as the GUILD_ID, have fun testing!

Documentation

This bot was made with discord.py, so to help with development, please refer to the Discord.py documentation. They have tons of examples of code for existing features.

Support

If you have any questions about this, feel free to join our Discord Server and ping me (@t33dev) or any other staff!

Made with ❤️ by Tommy and the Micro Jam community