/TWLHelper

DS⁽ⁱ⁾ Mode Hacking Discord server bot

Primary LanguagePythonISC LicenseISC

TWLHelper, DS⁽ⁱ⁾ Mode Hacking Discord server bot

How to use

  1. Make a copy of settings.json.example and name it settings.json.
  2. Set your bot's token ID.
  3. You can also set other arguments in settings.json, such as command prefix, account status, and moderator roles.
    • It is recommended to use IDs rather than names for Moderator Roles to make sure jishaku can't be hijacked.
    • If none are set, all moderation permissions will default to either the guild owner or the bot owner.
  4. Install the following for your host:
    • Python 3.10.x (and its respective pip)
  5. Create a venv and activate it
    • UNIX-based: python3 -m venv venv, source venv/bin/activate
    • Windows py -m venv venv, .\venv\Scripts\activate
  6. Run pip install -r requirements.txt
  7. Run the following command:
    • UNIX-based: python3 twlhelper.py
    • Windows: py twlhelper.py

Optional functions

Each function and related commands will be disabled until the instructions are followed correctly.

  • The nds-boostrap compatibility list uses gspread, which requires a Google API key.
    1. You can read a guide on how to get this key here: https://docs.gspread.org/en/latest/oauth2.html
    2. In settings.json, set GSPREADKEY to the relative path of your API key JSON file.
  • The RSS cog pulls from the Nintendo Updates API, notifying when a system update for Nintendo 3DS consoles are published.
    • In settings.json, set NINUPDATES to the channel ID of where the RSS data will be posted.
  • The RSS cog pulls from the r/NDSBrew subreddit, notifying when a new post is submitted.
    • In settings.json, set SUBREDDIT to the channel ID of where the RSS data will be posted.
  • The Convert cog converts images, videos, and audio to a certain format, primarily designed for TWiLight Menu++ theming and video players.
    • To use the image/video/audio conversion functions, install ffmpeg for your host.
    • To use the Unlaunch background conversion functions, install ffmpeg and gifsicle for your host.
    • To use the GBARunner2 border conversion functions, install grit for your host. This can be found by installing the devkitPro build environment.
      • If your host is already configured to compile NDS or GBA software, this should already be set up.
      • If only installing the devkitPro build environment specifically for grit, you will need to install both grit and devkit-env package from pacman.
  • The GitHub cog pushes GitHub webhook updates into specific threads in the server.
    • In settings.json, set GITHUBUPDATES to the channel where the main GitHub webhook is set.
    • In settings.json, under THREAD, set values accordingly.

License

ISC License

Copyright (C) 2021-present DS-Homebrew

Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Credits