📖 Player Documentation

PLAYER GUIDE

Everything you need to get started, earn XP, compete in leagues, and make the most of your Picklly community.

🏓
Overview

What is Picklly?

Picklly is a community platform built specifically for pickleball clubs. Each club gets its own private site with their colors, logo, and community — all powered by the same platform. Players can track their stats, earn badges, join leagues, challenge each other, and upload photos, all in one place.

🧑‍🤝‍🧑

Community First

Your club, your brand. Fully themed and customized for your community.

🎮

Gamified Engagement

XP, levels, badges, streaks, and leaderboards keep players coming back to the courts.

📱

GroupMe Native

Integrated with your GroupMe group — check in, report scores, and more via bot commands.

🏆

Competitive Play

Challenge other players, join organized leagues, and climb the rankings.

📸

Media Gallery

A shared photo gallery where players can upload, tag, and celebrate great shots.

⚙️

Admin Controlled

Full admin panel for schedule, theme, settings, player management, and more.

Platform Overview

What's Included

Here's a full breakdown of every feature included in your Picklly community site.

FeatureWhat It DoesPlayersAdmin
🧑 Player ProfilesCustom profile cards with avatar, bio, tagline, skill rating, and stats
⭐ XP & LevelsExperience points earned from playing, checking in, winning, and more
🏅 Badges30+ milestone, achievement, and hidden badges to earn
📍 Check-InsCourt check-ins with streak tracking and XP rewards
⚔️ ChallengesIssue 1v1 challenges, report scores, confirm results
🏆 LeaguesOrganized round-robin or bracket leagues managed by admins
📸 Photo GalleryShared community gallery with player tagging and albums
🗓️ ScheduleWeekly court schedule with session types and location map
💬 GroupMe BotBot commands for check-in, stats, leaderboard, scores, and more
📊 LeaderboardTop players ranked by total XP
📧 Email NotificationsAlerts for badges earned, challenges, league results, and referrals
🎨 Custom BrandingFull color theme, logo, hero image — admin-controlled
🌐 Custom DomainUse your own domain alongside picklly.co
💡
14-Day Free Trial Your community starts with a free trial — no credit card required. Get fully set up before committing.
🚀
Player Guide

Getting Started

New to Picklly? Here's how to get set up in under 5 minutes.

1
Go to your community's Picklly siteYour admin will share the link — it looks like yourclub.picklly.co or a custom domain.
2
Click "Sign Up" and create your accountUse your email or sign in with Google. You'll set your display name and password.
3
Complete your Player ProfileAdd a photo, bio, tagline, and skill level. A complete profile earns you bonus XP!
4
Connect your GroupMe accountIn the GroupMe group, type !join to link your profile so you can use bot commands.
5
Check in at the courts and start playing!Every session you check in earns XP, builds your streak, and counts toward badges.
🎉
First-Time Bonus XP You'll earn XP automatically for registering, completing your profile, and linking your GroupMe. Get started right!
🧑
Player Guide

Player Profile & XP

Your player profile is your identity in the community. It shows your stats, XP level, badges, and history.

Your Profile Card

🖼️ Avatar & Frame

Upload a profile photo. As you level up, you unlock special card frames to show off your rank.

✍️ Tagline & Bio

Write a short tagline that appears on your card, and a longer bio on your profile page.

🏓 Skill Rating

Set your skill level (e.g. 3.0, 3.5, 4.0). Links to your DUPR or USA Pickleball profile if you have one.

🌟 Featured Badge

Pick one badge to feature on your profile card — show off your best achievement.

How XP Works

XP (Experience Points) are earned through activity. The more you play and engage, the faster you level up.

ActionXP Earned
✅ Register your account+25 XP
📸 Upload a profile photo+10 XP
✍️ Complete your bio+10 XP
📍 Court check-in+15 XP
⚔️ Win a challenge (Bo1)+75 XP
⚔️ Win a challenge (Bo3)+100 XP
⚔️ Win a challenge (Bo5)+130 XP
🏆 Win a league match+55 XP
🎮 Play a league match (any result)+40 XP
🏅 Earn a badgeVaries by badge
👥 Refer a new player+25 XP
📷 Tagged in a photo/video+5 XP each

Level Progression

1
Rookie
0 XP
2
Dinker
150 XP
3
Baller
400 XP
4
Pickler
800 XP
5
Court Veteran
1500 XP
ℹ️
XP Never Resets Your total XP is cumulative and determines your level. The leaderboard ranks all players by total XP.
🏅
Player Guide

Badges

Badges are earned achievements that show up on your profile. There are over 30 badges across multiple categories — some earned automatically, some admin-awarded, and a few are hidden until you unlock them.

🎯

Milestone Badges

Earned automatically when you hit certain thresholds — first check-in, first challenge win, 25 wins, etc.

🏆

Achievement Badges

League champion, runner-up, and bronze finisher. Awarded when league results are finalized.

👑

Legendary Badges

Rare badges for extraordinary contributions — Player of the Year, Community Legend, Night Crew OG.

🤝

Community Badges

Refer new players to the community. Earn Recruiter at 3 referrals and Ambassador at 10.

🔍

Hidden Badges

Mystery badges you won't see until you unlock them. Watch for the surprise reveal!

Admin-Awarded

Special recognition your community admin can grant manually for standout moments.

Badge Rarities

RarityDescriptionXP Bonus
CommonEntry-level milestones — first check-in, first challenge25–75 XP
UncommonConsistent effort — win streaks, referrals100–200 XP
RareSignificant achievement — 25 wins, league titles200–500 XP
LegendaryCommunity icons — Player of the Year, Court Legend500+ XP

Challenge Badges

BadgeHow to Earn
⚔️ Challenger CommonIssue or accept your first player challenge
🏆 Challenge Winner UncommonWin your first player challenge
🔥 On Fire UncommonWin 5 player challenges
🎖️ Court Veteran RareWin 25 player challenges
👑 Court Legend LegendaryWin 50 player challenges
📍
Player Guide

Check-Ins & Streaks

Checking in at the courts is how Picklly tracks that you've been playing. Every check-in earns XP, counts toward your streak, and can unlock badges.

📱 How to Check In (Website)

Log in to your community site, click "Check In" from the home page or the Players section. Available during and after session hours.

💬 How to Check In (GroupMe)

Type !checkin in the GroupMe group. The bot will log your check-in and post a message. You must have linked your account with !join first.

Weekly Streaks

A streak counts how many consecutive weeks you've checked in at least once.

StreakBadgeXP Bonus
First check-in ever🏅 Early Bird+25 XP
Active any week+15 XP per session
Night session check-in🌙 Night Owl (progress)+15 XP
25 night sessions🌙 Night Crew OG+500 XP
🔥
Keep the Streak Alive Your streak is shown on your player profile and in the GroupMe when you check in. Miss a week and it resets to zero!
⚔️
Player Guide

Challenges

Challenges are 1v1 matchups between players. Issue a challenge, play the match, report the score, and your opponent confirms. Results count toward your XP, badges, and leaderboard standing.

Challenge Formats

1️⃣

Best of 1 (Bo1)

One game to 11. Win and earn +75 XP.

3️⃣

Best of 3 (Bo3)

First to win 2 games. Winner earns +100 XP.

5️⃣

Best of 5 (Bo5)

First to win 3 games. Winner earns +130 XP.

How a Challenge Works

1
Issue a ChallengeGo to a player's profile page and click "Challenge". Choose your format and send it.
2
Opponent AcceptsThe challenged player receives a notification and can accept or decline.
3
Play the MatchHead out to the courts and play! The challenge stays open until scores are reported.
4
Report the ScoreGo to Challenges → My Challenges and report the score. Or type !score 11-7 in GroupMe.
5
Opponent Confirms or DisputesYour opponent has 48 hours to confirm. If they don't respond, it auto-confirms.
6
XP & Badges AwardedOnce confirmed, XP is automatically awarded to both players. Badge progress is updated.
Auto-Confirm Timer If your opponent doesn't confirm or dispute within 48 hours, the score is automatically confirmed. Admins can also manually resolve disputes.
🏆
Player Guide

Leagues

Leagues are organized competitive seasons managed by your community admin. Players sign up, get scheduled into matches, play games, and earn XP — with badges for the top 3 finishers at the end.

1
Find an Open LeagueGo to Leagues in the navigation. Open leagues show a Open status.
2
Register Before the DeadlineClick "Join League" on the league page. Don't miss the registration deadline!
3
Check Your ScheduleOnce the league starts, your match schedule is posted on the league page.
4
Play Your Matches & Report ResultsAfter each match, one player reports the score and the other confirms — just like challenges.
5
Earn Your Finish BadgeTop 3 finishers earn the League Champion 🏆, Runner Up 🥈, or Bronze Finisher 🥉 badge — plus a big XP reward.
ResultXPBadge
Win a match+55 XP
Play a match (any result)+40 XP
🥇 1st PlaceLarge bonus (admin sets)🏆 League Champion
🥈 2nd PlaceMedium bonus🥈 Runner Up
🥉 3rd PlaceSmall bonus🥉 Bronze Finisher
🗓️
Player Guide

When & Where

The When & Where page tells you everything about showing up to play — court location, weekly schedule, and session types.

📍

Court Location

Full address, embedded Google Map, and parking notes.

🏓

Court Amenities

Number of courts, lighting status, restrooms, and parking — all displayed.

🗓️

Weekly Schedule

See which days have sessions, times, and whether it's Open Play or Flexible.

💬

GroupMe Updates

Session cancellations and changes are announced in the GroupMe group.

TypeWho Is It For?
Open PlayAll skill levels welcome. Just show up with a paddle.
FlexibleMay have skill requirements or a different format — check the schedule or GroupMe for details.
💬
Player Guide

GroupMe Bot Commands

The Picklly bot lives in your community's GroupMe group. Once you link your account with !join, you can use any of the commands below right from the chat.

🔗
Link Your Account First Type !join in the GroupMe group. The bot will post a registration link. Once you've registered on the Picklly site, your GroupMe is automatically linked.

Full Command Reference

CommandWhat It DoesExample
!joinLink your GroupMe to your Picklly account!join
!checkinCheck in at the courts — earns XP and updates your streak!checkin
!statsView your personal stats: XP, check-ins, games played!stats
!badgesList all badges you've earned!badges
!streakView your current weekly check-in streak!streak
!leaderboardSee the top 5 players by total XP!leaderboard
!score [score]Report a score for your active challenge!score 11-7
!confirmConfirm your opponent's reported score!confirm
!disputeDispute your opponent's reported score!dispute
!photo [caption]Upload an attached image to your gallery!photo Great game!
!helpShow all available commands!help
💡
Bot Announcements The bot also posts automatically when players earn badges, check in, or when league matches are recorded. You'll always know what's happening!