Dola

Dola is a Python-based bot specialising in Splatoon and Slapp but also comes with some utility functions. Code on Github.

Import prefix is DolaBot.

Requirements

• Python 3.9+

Bot Setup

• Create a .env in the repository root with the following values:

# This is the bot's Discord token from the Developer API page.
BOT_TOKEN="xxxx.xxxx.xxxx"
# This is the bot's Discord Id.
CLIENT_ID=123456789
# This is your Discord Id.
OWNER_ID=123456789
# Path to SplatTagConsole for Slapp things
SLAPP_CONSOLE_PATH=".../SplatTagConsole.dll"
# Path to the Slapp App Data folder
SLAPP_DATA_FOLDER=".../SplatTag"
# Discord id of a logging channel (optional)
LOGS_CHANNEL=870436255777837098
# Bot command symbol (optional). 
# '~' by default or not specified.
# Recommend using a different symbol for local testing.
BOT_COMMAND_SYMBOL="+"

You must also set the relevant env values for SlappPy

Dockerised setup (not required)

• The Dockerfile assumes SplatTag is under /bin. Adjust if necessary.
  • First, grab SplatTag and put it into the Docker build context, e.g.
  • . GrabSplatTag.bat

THEN

• With Docker Desktop running,
• docker build --no-cache --pull --tag="slate.azurecr.io/dola:latest" -f Dockerfile .

Test or run with

• docker run -t -d slate.azurecr.io/dola

Update Azure Image with

After the build step, (note these commands are long in this window!)

• az login
• az acr login --name slate
• docker push slate.azurecr.io/dola:latest
• To stop:
  • az container stop --name dola --resource-group slapp-resource-group
• To recreate from scratch (this should also re-pull the image)
  • az container create --resource-group slapp-resource-group --name dola --image slate.azurecr.io/dola:latest
  • The username is slate, and the password is in the ACR access keys.
• To start:
  • az container start --name dola --resource-group slapp-resource-group

Azure Cloud setup from scratch

ACR_NAME=slate.azurecr.io
SERVICE_PRINCIPAL_NAME=acr-service-principal
ACR_REGISTRY_ID=$(az acr show --name $ACR_NAME --query id --output tsv)
SP_APP_ID=$(az ad sp show --id http://$SERVICE_PRINCIPAL_NAME --query appId --output tsv)
echo "Service principal ID: $SP_APP_ID"
SP_PASSWD=$(az ad sp create-for-rbac --name http://$SERVICE_PRINCIPAL_NAME --scopes $ACR_REGISTRY_ID --role acrpull --query password --output tsv)
echo "Service principal password: $SP_PASSWD"
az container create --resource-group slapp-resource-group --name dola --image slate.azurecr.io/dola