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
    • 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
      • On MacOS/Linux
        • Execute ./env/Scripts/activate
  • Install project dependencies to the venv:
    • On Windows: pip install -r requirements.txt
    • On MacOS/Linux: pip3 install -r requirements.txt
  • Configure via config.json taking inspiration from example
  • Use ./run.bat or python 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