Hunterandeip
91c297ead7
* Updated downgrade command to include ban risk and elaborate further on mismatched lotus firmware * Update information about patched Eristas/Mariko * Someone reportedly forgot to put their units * Updated format_map to reflect last Switch versions * Converted nxcfw command to a standard markdown command Most information provided in this command was already outdated given that every custom firmware mentioned is no longer in development and does not work on the latest firmware. AIO packs and Atmosphere forks are the new (just as dangerous) versions of nxcfw which is why this command is now meant to advise against obtaining Atmosphere from anywhere except the official Github page. The current information within the command is just a modified version of what was said for Kosmos as Kosmos was always just an AIO pack for Atmosphere. More information may be added in the future depending on our needs, especially with the fear of HOS 22.0.0 coming up. * Updated newver command to include post 21.2.0 updates Since the primary maintainer of Atmosphere has retired, updates to the CFW after a system update are expected to take a significantly longer amount of time. This change is designed to provide the latest information regarding this. Do note that this command should be updated again once a new version of HOS comes out that brings major changes (most likely 22.0.0). * Updated format_map to include latest Switch versions * Removed unneeded dependencies after revamp of nxcfw * Update newver.switch.md * Update nxcfw.switch.md * Update stock.switch.md --------- Co-authored-by: eip <36315290+eip618@users.noreply.github.com>
Kurisu
A Discord server bot developed for Nintendo Homebrew on Discord. Maintained primarily by NH staff and helpers.
Although it is open source, this bot is not really designed to be used in other setups at the moment; the source is mainly just available for those interested in how it works on the Nintendo Homebrew server.
Server template
A server template is available for testing Kurisu, with all the channels and roles necessary.
Setting up for local testing in Docker (recommended)
To test changes to Kurisu locally using Docker, make sure Docker Desktop (Windows and macOS) or Docker Engine (Linux) is installed. If you are using Windows, it's heavily recommended to use Powershell so the commands shown here run as intended.
For Linux, docker-compose must be installed separately.
Create a new application on Discord and add a bot. Put the token in token.txt in the same directory. (Newline at the end of the file doesn't matter.)
The file server_logs_url.txt is the url to a database of a different project, which is used along Kurisu in production. For local testing purposes, this file still needs to be created but can be blank, in which case the server_logs cog won't be loaded.
Set up the database volume with the following commands, this can also be used in cases in which the schema was updated and the database volume still contains an old version, missing tables necessary to run the bot. This will pull postgres:13 to run as the database, create the tables (removing them if they already exist) then stop and remove the container.
docker-compose up --build -d db
cat ./schema.sql | docker compose exec -T db psql -U kurisu -d kurisu
docker-compose down db
Start Kurisu with the following command. Assuming a clean setup, this will pull postgres:13 to run as the database, and python:3.11-alpine as the base image for Kurisu, then build a new Kurisu image. Then it will start up postgres first, then kurisu once the database is active.
docker-compose up --build
postgres database files are stored in a Docker volume called kurisutestdb. Use Ctrl-C if not running in detached mode to stop the bot.
Other useful commands
-
docker-compose build- Build only, pull base images if required -
docker-compose build --pull- Build only, always try to pull base images for newer versions -
docker-compose pull- Pull images, in this case update postgres:13 -
docker-compose up -d- Detach and run containers in the background -
docker-compose down- Stop running containers and remove them
Set up for local testing manually
- Ever since the move to Docker and PostgreSQL this has not been as well tested, so tell us if something is wrong or confusing!
Set up PostgreSQL 13 or later (older versions aren't tested but might work).
Python 3.10 or later is required.
Install the dependencies in requirements.txt, ideally in a virtual environment.
Create a new application on Discord and add a bot.
Inside data/, create config.ini with the contents:
[Main]
token = <token for Discord bot>
database_url = <url of the database>
server_logs_url = <url to server logs database`
database_url and server_logs_url should follow a format like postgresql://user:password@ipaddr/database (example: postgresql://kurisu:dev123@127.0.0.1/kurisu). server_logs_url can be left blank.
Run the bot:
python3 kurisu.py