ARK RP Visualisation

This project is unofficial and not endorsed by the UNSW Tabletop Games Society.

A dashboard for analysing Discord message metadata from the ARK: Journey Through the Realms (2024) Dungeons and Dragons campaign.

Link (TBD): N/A

Demo

example.mp4

Screenshots

Time Series	Bar	Scatter

Features

• Support for line, bar and scatter graphs.
• Dynamic filtering.
• Togglable log scale and moving averages.
• Fullscreen view for graphs.
• Customisation options for graph title, axes labels and sorting.

Built With

• 
• 
• 
• 
• 
• 

Getting Started

Prerequisites

• uv
• Discord exports in CSV format (if using own data)
• Docker (optional)
• An S3 bucket (if using S3)

Quick Start

1. Run the following commands:

git clone https://github.com/queze1/ark-rp-visualisation.git
cd ark-rp-visualisation
cp .env.example .env
uv sync

# This will create a file in `.cache`. To use S3, upload this file into your S3 bucket.
uv run src/app.py

# If using Docker
# docker compose up --build

2. Go to http://127.0.0.1:8050/.
   • Note: As the ARK dataset is private, the dashboard will use a dummy dataset by default.

Installation

1. Follow the quickstart.
2. Create a /data directory if it does not exist, and place your Discord CSV exports in there.
3. Update data paths in src/core/data_loader.py.
4. Update .env.

Roadmap

• Tooltips & help icons
• Preset graphs
• Filter by an expression

License

This project is licensed under the MIT license.

See LICENSE for more information.