← Back to ScoreKpr

Help & Guide

A short walkthrough to get the most out of ScoreKpr — from signing in to tallying scores.

🎲

Add Wins

Three steps: game, winner, date. Done.

👑

Leaderboard

See who rules your campaign.

📊

Tally Scores

Round-by-round scoring for complex games.

🔗

Invite & Share

One link to invite your group.

1. Getting Started

1.1 Sign in

Click Sign in with Google to create or access your account. No passwords — just your Google login.

Screenshot: Sign-in button
Video walkthrough coming soon

1.2 Create a Campaign

Select your campaign from the header dropdown, then click + New. Give it a name (e.g. "Friday Game Night") and you're set.

1.3 Join a Campaign

Ask your host for the invite link. Open it, view the leaderboard, then click Join campaign (or sign in first if prompted).

2. Adding a Win

2.1 Select Game

Go to Add a Win. Pick a game from the grid or click + Add New Game to add one. You can upload an image or paste a URL. BoardGameGeek (BGG) search when adding games is a future feature.

Screenshot: Game selection
Video walkthrough coming soon

2.2 Select Winner & Players

Choose the meeple who won. Optionally select who else played. Add new meeples with + Add Meeple.

2.3 Select Date

Pick the date the game was played, then hit Save Win 🎉. Use Back to change game or winner.

3. Leaderboard

3.1 Meeple Cards

Each card shows wins and top games. The #1 player gets the golden card. Click a meeple to open their profile.

Screenshot: Leaderboard cards

3.2 Top Games

Below the meeples, see which games have been played most and who's won them.

3.3 Meeple Profiles

Click a meeple card. If they've linked their account, you'll see cross-campaign stats — total wins, win rate, favourite game.

Video walkthrough coming soon

3.4 Celebration Pills

Use Confetti, Shake, Fanfare, or Roll Quotes for a bit of fun when viewing the leaderboard.

4. Tally Scores

4.1 Setup

Click Tally Scores in the nav. Pick a game and who's playing (2+ meeples). Add guests if needed. Click Start Tally.

Screenshot: Tally setup

4.2 Scoring Rounds

Choose round types — VP, Objectives, Cards, Resources, Coins, or custom. Enter scores per player per round. Totals update automatically.

Video walkthrough coming soon

4.3 Record Winner

When done, click Review win and set date. Confirm the winner, pick a date, then Save Win 🎉.

5. History

5.1 View Entries

Open the History tab to see all wins. Each entry shows game, winner, date, and who played.

5.2 Edit a Win

Click the ⚙️ icon on any entry. Update game, winner, date, or participants. Edits are stamped with who changed what and when.

Screenshot: Edit entry

5.3 Participants

When adding or editing a win, you can mark who played (not just the winner). This powers games-played and win-rate stats.

6. Data Management

6.1 Export

Use Export Data to download a JSON backup of your campaign.

6.2 Import

Use Import Data to restore from a previously exported JSON file.

6.3 Clear All

Clear All removes all data from the current campaign — wins, games, meeples, and history. This cannot be undone.

Back up first. Export your data before using Clear All. Go to Export Data, download the JSON file, and store it safely. You can restore later with Import Data.

7. Personalisation

7.1 Meeple Customisation

Click a meeple card, then Customize meeple. Commoners choose from preset avatars. Nobles and Royals can upload a custom photo (file or URL) or pick a preset. All tiers can pick a colour. Changes apply to the leaderboard card.

Video walkthrough coming soon

7.2 Game Images

Click the image area on a game card to set or change its image. Upload a file or paste an image URL.

7.3 Favourite Quotes

Linked meeples can pick a favourite quote to show on their card. Use the quote selector in the Customize meeple modal.

8. Membership & Tiers

8.1 Membership Tiers

Your membership tier sets your limits. Commoner (free): 2 campaigns, party permit of 5 meeples per campaign. Noble: 4 campaigns, party permit of 10 meeples. Royal: unlimited campaigns and meeples. Party permits control how many meeples you can have in each campaign — see the pill in the header. Commoners choose preset avatars only; Nobles and Royals can upload custom photos.

8.2 Plan Summary Pills

When signed in, the header shows small pills: your tier name, campaigns used (e.g. 1/2), and party permit (max meeples for the current campaign). These help you see your limits at a glance.

8.3 Campaign Join Requirements

Campaign owners can restrict who can join. Click Update class requirements (below the campaign dropdown) to choose which tiers are allowed — Commoner, Noble, Royal, or any combination. Only users with a matching tier can join that campaign.

9. Announcements & Messages

You may see banners above the nav bar. Global announcements (blue) are for all users. Personal messages (orange) are sent to you specifically. Both can be dismissed with the ✕ button. Dismissed banners may reappear after you log out and log back in, or in a new session.

10. Troubleshooting

Stuck or seeing old data? Try logging out and back in, or refresh the page (Ctrl+F5 or Cmd+Shift+R to bypass cache). Clearing browser cache can also fix display or loading issues.