╔═════════════════════════════════════════════════════════════════════════════════════╗
║ ┏┳┓┏━┓┏━┓┏━┓┳ ┏━┓┏┳┓┏━┓ ┏━┓┳━┓┏━┓┏┓┏┏┳┓┳┏━┓┳━┓┏━┓ ┏┳┓┳┏━┓┏━┓┏━┓┳━┓┏┳┓ ┏━┓┏━┓┏━┓ ║
║ ┃┃┣┫ ┗━┓┃ ┃┃ ┣━┫ ┃ ┣┫ ┣┫ ┣┳┛┃ ┃┃┃┃ ┃ ┃┣┫ ┣┳┛┗━┓ ┃┃┃┗━┓┃ ┃ ┃┣┳┛ ┃┃ ┣━┫┣━┛┣━┛ ║
║ ╺┻┛┗━┛┗━┛┗━┛┻━┛┻ ┻ ┻ ┗━┛ ┗ ┻┗━┗━┛┛┗┛ ┻ ┻┗━┛┻┗━┗━┛ ━┻┛┻┗━┛┗━┛┗━┛┻┗━╺┻┛ ┻ ┻┻ ┻ ║
╚═════════════════════════════════════════════════════════════════════════════════════╝
You need to have the map renderer running, which is a separate program (so, run in a seperate terminal/tab):
source $HOME/.local/venv/df_discord/bin/activate
cd map_render
hypercorn server:app --workers=2 --bind=0.0.0.0:9100
cd ..To run the Desolate Frontiers Discord frontend, you can use this command (from the root folder):
source $HOME/.local/venv/df_discord/bin/activate
op run --env-file op.env -- python -m discord_app.df_discordNote: in some debugging scenarios you might want to add the --no-masking flag, but do so judiciously.
To run that discord bot in a test environment, your op_discord.env should look something like this:
LOG_LEVEL = "INFO"
DF_API_HOST = "http://localhost:1337"
DF_SKELETON_KEY = "op://Oori DevOps/Desolate Frontiers Auth Secret Key/password"
DF_MAP_RENDERER = "http://localhost:9100"
DISCORD_TOKEN = "SECRET REFERENCE TO THE TOKEN OF THE BOT YOU'RE TESTING WITH" # Discord bot/app to use
# Find this as the "Copy Secret Reference" option in the dropdown for the credential in 1Password
# Server that is used as the presumed playerbase to send notifications to
DF_GUILD_ID = "1119003654800822302" # oori dev server
# Channel to send those notifications in
DF_CHANNEL_ID = "1179194033923432578" # #bot-attic-🔇
WASTELANDER_ROLE = "1201669829140942970" # "WASTELANDER test" role in oori dev server
ALPHA_ROLE = "1201669791866441748" # "ALPHA test" role in oori dev server
BETA_ROLE = "1201669724987990096" # "BETA test" role in oori dev server
DF_WELCOME_CHANNEL_ID = "1365103931935690874" # #df-test-notifications-🔇
DF_GAMEPLAY_CHANNEL_1_ID = "1119004092098953366" # #bot-garage-🔇
DF_GAMEPLAY_CHANNEL_2_ID = "1179194033923432578" # #bot-attic-🔇
DF_GAMEPLAY_CHANNEL_3_ID = "1205228905431306250" # #bot-dungeon-🔇You'll need to have the 1Password CLI tools installed to make this work ("Manual" reccomended over "Homebrew")
The Desolate Frontiers Discord App requires Python 3.12. It is highly reccomended to create a new virtual environment (venv) setup specifically for the DF Discord App.
To create a venv in the "standard" location of ~/.local/venv/:
/usr/local/bin/python3.12 -m venv $HOME/.local/venv/df_discordYou can manually activate that with:
source $HOME/.local/venv/df_discord/bin/activateGet the correct libraries installed to the venv:
pip install -U pip
pip install -U -r requirements.txt -c constraints.txtFor ease of development, you can install the libraries for the map renderer to the same venv:
pip install -U pip
pip install -U -r map_render/requirements.txt -c map_render/constraints.txtTo activate that in VSCode, open a python file and select the python version in the status bar in the bottom right in your VSCode window and click Enter interpreter path..., and enter:
~/.local/venv/df_discord/bin/python3.12