Welcome to the SWGoH Raid Analysis tool! This application automatically analyzes your guild’s raid performance based on CSV files from Wookiebot.

Quick Setup

1. Use This Template

1. Click the “Use this template” button at the top of this repository
2. Choose “Create a new repository”
3. Give your repository a name (e.g., my-guild-raids, guild-name-analysis)
4. Make sure it’s set to Public (required for GitHub Pages)
5. Click “Create repository from template”

2. Enable GitHub Pages

1. Go to your forked repository on GitHub
2. Navigate to Settings → Pages (in the left sidebar)
3. Under Source, select “GitHub Actions”
4. The workflow will be automatically detected

3. Clean Up Sample Data

1. In your forked repository, navigate to the /data folder
2. Delete all existing CSV files (these are sample data)
3. The folder should be empty after this step

4. Generate Your Guild Data

1. In Star Wars: Galaxy of Heroes, use the Wookiebot command:

   /raid guild

   Add your desired parameters (effort level, etc.)
2. Download the generated CSV file from Wookiebot

5. Upload Your Data

1. In your GitHub repository, navigate to the /data folder
2. Click “Add file” → “Upload files”
3. Upload your downloaded CSV file(s)
4. Commit the changes with a message like “Add raid data”

6. Automatic Deployment

• GitHub Actions will automatically build and deploy your site
• Your analysis will be available at: https://YOUR_USERNAME.github.io/REPOSITORY_NAME/
• The build process takes 2-3 minutes

7. Adding More Data

• Repeat steps 4-5 whenever you want to add new raid data
• The site automatically updates with each new CSV file upload

8. Updating Your Fork (Getting New Features)

When the original repository gets updates with new features or bug fixes:

1. Go to your forked repository on GitHub
2. Click the “Sync fork” button (if available) or:
3. Manual sync via GitHub web interface:
   • Click “Compare” → switch the comparison to see updates from original
   • Create a pull request from the original repository to your fork
   • Merge the pull request to get the updates
4. Alternative - Delete and re-fork:
   • If you haven’t made custom changes, simply delete your fork
   • Fork the repository again to get the latest version
   • Re-upload your CSV data

Command Examples

/raid guild
/raid guild effort:high

Parameters

• effort: Analysis effort level - low, medium (default), high

Expected CSV Format

name,allycode,estimatedScore,lastActualScore,diff,diffPercent
"Player Name",123456789,1500000,1450000,-50000,-3.33

Column Descriptions

• name: Player name in the guild
• allycode: Unique player identifier
• estimatedScore: Expected raid score based on roster
• lastActualScore: Actual score achieved in the raid
• diff: Difference between estimated and actual score
• diffPercent: Percentage difference

Key Metrics

• Participation %: Percentage of raids a player has participated in (last 5 raids)
• Average Estimate: Average estimated score per raid
• Best Score: Highest actual score achieved
• Last Score: Most recent raid score
• Efficiency %: Actual vs estimated performance ratio
• Trend: Rising, Falling, or Stable based on recent performance

Color Coding

• 🟢 Green: Above average performance
• 🔴 Red: Below average performance
• ⚫ Gray: Did not participate in that raid

Available Tools

📈 Charts

• Total Points Over Time: Shows guild-wide performance trends
• Performance Points Over Time: Individual player scores over time

🔍 Filtering

• Sort by various metrics (participation, score, name, etc.)
• Search by player name in tables

📋 Tables

• Player Statistics: Overview of all players
• Raid Details: Detailed view of last 5 raids with individual scores

Common Issues

Site Not Loading

• Check that GitHub Pages is enabled in your repository settings
• Verify that GitHub Actions completed successfully (check the “Actions” tab)
• Wait 2-3 minutes after upload for the build to complete

No Data Showing

• Ensure CSV files are uploaded to the /data folder (not the root)
• Check that CSV files follow the Wookiebot format
• Verify that the CSV files contain actual data (not empty)

Build Failures

• Check the “Actions” tab in your GitHub repository for error details
• Ensure CSV files are valid and not corrupted
• Try re-uploading the CSV files