🩸 Bloodborne Calculator

A web application that allows you to:

• Check the optimal class for your build
• Explore detailed statistics of each boss
• Calculate attack rating for trick weapons and firearms
• Simulate damage dealt by each weapon's moveset against a selected boss

🔗 Live Frontend
🔗 Live Backend Swagger API

---

🧭 Table of Contents

• 📖 About
• 🛠 Tech Stack
• ✨ Features
• 🔐 Authorization
• 🚀 Running Locally
• 🖼 Screenshots

📖 About

Bloodborne Calculator is a fan-made tool that helps players plan their builds, simulate weapon damage based on stats, and explore optimization options.

🛠 Tech Stack

• Frontend: Angular v19.2.0 (TypeScript, HTML, CSS)
• Backend: ASP.NET Core 8.0 (C#)
• Database: PostgreSQL
• Authorization: Auth0 (OAuth2 / OpenID Connect)
• Hosting: Microsoft Azure

✨ Features

• Weapons scaling calculator
• Damage simulation
• Bosses, origins, weapons info
• API documentation via Swagger
• Secure API Authorization with Auth0
• Responsive design for mobile & desktop

🔐 Authorization

• Login is handled via Auth0 with secure tokens
• JWT tokens are sent in API requests to protected endpoints (POST | PUT | DELETE)
• Token is obtainable only for pre-registered accounts

🚀 Running Locally

Prerequisites:

• .NET 8 SDK
• Node.js 22 & Angular CLI
• PostgreSQL
• Auth0 account

📁 Configuration

Postgresql

• Create database

Backend

• Before running the backend, create a .env file in the backend root directory with the following content

# .env
DB_PASSWORD=
DB_HOST=
DB_USER=
DB_NAME=
CLIENT_ID=[Auth0 client id]
CLIENT_SECRET=[Auth 0 Client secret]
AUTHORITY=[Auth0 authority link]
AUDIENCE=[Auth0 audience link]
PRODUCTION_CORS_HOST=[Frontend link for CORS]

• Create Migrations and update database

dotnet ef migrations add DatabaseInit --output-dir Persistence/Migrations
dotnet ef database update

• Run the backend, the database will be seeded automatically.

cd backend
dotnet restore
dotnet run

Frontend

• Before running the frontend, create a environments folder and inside environment.ts file in frontend/src/app with the following content

// environment.ts
export const environment = {
  production: false,
  apiUrl:
    'link to backend',
};

• Run the frontend.

cd frontend
npm install
ng serve

🖼 Screenshots

Database

---

Frontend

Home Page

Boss Page

Optimal Class Page

Firearms Page

Firearms Selection Pop-up

Boss Selection Pop-up

Trickster Weapons Page

Trickster Weapons Selection Pop-up

Selected Trickster Weapon Damage Table

---

Backend API

API with Swagger Documentation