From da4d006bc0984893f1a6db9975d5c7696c3a7a9d Mon Sep 17 00:00:00 2001 From: Brendan Golden Date: Tue, 29 Oct 2024 14:00:43 +0000 Subject: [PATCH] doc: update user docs --- README.md | 39 +++++++++++++++------------------------ 1 file changed, 15 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index 068979a..1f5fe3a 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,13 @@ # Skynet Discord Bot -This bots core purpose is to give members roles based on their status on . -It uses an api key provided by wolves to get member lists. +This bots core purpose is to give members roles based on their status on https://ulwolves.ie. +It uses an api key provided by wolves to get member lists. Users are able to link their wolves account to the bot and that works across discord servers. For example is a user links on the CompSoc Discord then they will also get their roles (automagically) on Games Dev if they are a member there. -## Commands - Admin - +## Setup - Committee You need admin access to run any of the commands in this section. -Either the server owner or a suer with the ``Administrator`` permission +Either the server owner or a user with the ``Administrator`` permission ### Getting the Skynet Discord bot 1. Email ``keith@assurememberships.com`` from committee email and say ye want an api key for ``193.1.99.74`` @@ -42,29 +41,21 @@ This unlinks a minecraft server from your club/society. ``/minecraft_delete SERVER_ID`` -## Commands - User +## Setup - Users +This is to link your Discord account with your UL Wolves account. +**You will only need to do this once**. ### Setup -* Start the process using ``/link_wolves WOLVES_EMAIL`` - * The email that is in the Contact Email here: -* An email will be sent to them that they need to verify using ``/verify CODE`` -* This will only have to be done once. +1. in a server with the Skynet Bot enter ``/link_wolves WOLVES_EMAIL`` + * Your ``WOLVES_EMAIL`` is the email in the Contact Email here: + * This is most likely your student mail +2. An email will be sent to you with a verification code. +3. Verify the code using ``/verify CODE`` +4. Once complete your Wolves and Discord accounts will be linked. -* If the user is an active member on wolves - * If they are in any servers with teh Skynet Bot - * They will get relevant roles. - * If they Join a server with teh bot enabled. - * They will be granted the roles automatically -* If the user is **not** an active member on wolves. - * If they have no Roles - * No change - * If they have Past Member Role - * No change - * If they have both Roles - * The current-member role will be removed from them - * Past Member role will remain unchanged +You will get member roles on any Discord that is using the bot that you are a member of. ### Minecraft -Users can link their Minecraft username to grant them access to any servers where teh whitelist is managed by teh bot. +You can link your Minecraft username to grant you access to any Minecraft server run by UL Computer Society. ``/link_minecraft MINECRAFT_USERNAME``