A warm welcome to the Rayz Github repo! Rayz is a multi-utility Guilded bot built in Python, using Shay's Guilded.py! wrapper library. This document provides guidelines on how to contribute to the project and set up the bot on your local machine.
-
Please make sure you have a recent version of python 3 installed. (3.10.6+)
-
Clone this repo.
-
Make a test bot via Guilded on your own private server to test your changes on.
-
Get its token.
-
Paste it into config/config.json make the file if it's not there already.
-
Run the bot
- CD into project root dir.
- Using a Virtual Environment for the project is recommended:
- To create:
- On Windows: Execute
python -m venv env
- On MacOS/Linux: Execute
python3 -m venv env
- On Windows: Execute
- Activate virtual environment of the project, specific to OS and shell environment
- Using VSCode && Python extension might be helpful if you are new
- On Windows
- Execute
./env/Scripts/Activate.ps1
on windows if using PowerShell - CD into the same dir and run
activate.bat
if using CMD
- Execute
- On MacOS/Linux
- Execute
./env/Scripts/activate
- Execute
- To create:
- Install project dependencies to the venv:
- On Windows:
pip install -r requirements.txt
- On MacOS/Linux:
pip3 install -r requirements.txt
- On Windows:
- Configure via config.json taking inspiration from example
- Use
./run.bat
orpython base.py
to get started if on windows. - Use
python3 base.py
to get started if on mac/linux.
-
Run wild. Happy coding fellow developer! GODSPEED