Rounds
Rounds are the main workflow in Frolf Bot. The app is the primary surface for round lists, detail pages, RSVP, scoring, editing, deletion, and offline total-score entry. Discord commands and event cards are available for clubs that install the bot.
Create a round in the app
Requires: Player role
Open Rounds and use Create Round. The form captures the normal round details:
| Field | Required | Description |
|---|---|---|
| Title | Yes | Name of the round. |
| Description | No | Notes, card details, or other context. |
| Start Time | Yes | Local date and time for the round. |
| Timezone | Yes | US timezone picker; defaults to your detected zone — change it only if it’s wrong. |
| Location | Yes | Course name or address. |
| Apply handicap | No | Editors and admins only. Score this round on handicap-adjusted (net) scores. |
| Course par | If handicap is on | The course’s par — a whole number from 36 to 90. Used to compute net scores. |
The Location field includes a course picker with a map and a “Near Me” list of known disc golf courses. Tap a course to auto-fill the field.
When Apply handicap is on, a Show net scores to all players toggle also appears (on by default; when off, only admins and editors see net scores). See Handicaps & Net Scores.
If the club is linked to Discord, round creation can also produce a native Discord scheduled event and event-channel round card.
Create a round in Discord
Discord-linked clubs can use:
/createround
/createcasualround
/startround
/eventscomingup /createround creates a normal competitive round. /createcasualround creates a casual non-tag round where RSVP and scores are tracked, but points and tag calculations are skipped. /startround immediately opens a live scorecard with no scheduling step, and /eventscomingup posts the next 7 days of rounds. See Discord Commands.
RSVP
Players can RSVP from the app’s round detail page:
- Join to participate
- Decline when you cannot attend
- Late join where the round state and permissions allow it
For Discord-linked clubs, players can also use the native Discord scheduled event or the round card buttons.
Edit or delete a round
Requires: Round creator, Editor, or Admin role
Use the round detail page in the app to edit or delete a round. Discord-linked clubs can also expose Edit and Delete actions on round cards.
Editable fields include title, description, start time, timezone, and location. Deleting a round removes it from the active club and can void related betting markets or imports where applicable.
Score a round
When a round is active, accepted participants can enter their total score from the app’s round detail page. Scores are relative to par:
| Example | Meaning |
|---|---|
-3 | Three under par. |
0 | Even. |
+2 | Two over par. |
Discord-linked clubs can also use the Score button on round cards.
If the round was created with Apply handicap on, a net score (adjusted for each player’s handicap index) is also shown once the round is underway, and final placement is decided by net score. See Handicaps & Net Scores.
Live hole-by-hole scoring
When a round uses live scoring, the scorecard opens in hole-by-hole mode instead of total-score mode. Each hole has its own cell; scores update in real time for all participants and spectators. See Scoring & Imports for focused entry, peer scoring within cards, Wolf format, and format lenses.
Sharing & spectating
Any live round has a Share button that generates a public watch link. Anyone with the link can follow the scorecard in real time — no account required. See Spectating.
Guest players
Requires: Editor or Admin role
Active rounds support adding players who are not yet registered.
- Open the round’s + Add Player panel and search by name, or choose Create Guest to add a new row.
- The guest plays in the round; scores are recorded under the guest row.
- After the round, the admin shares a claim code with the guest.
- The guest creates an account, enters the claim code on their profile, and a voucher is submitted.
- An editor or admin approves the voucher to link the scores to the guest’s account.
Guest scores count toward the round immediately. Claiming an account links the history; it does not re-score the round.
Offline total-score entry
The app supports saving active rounds for offline score entry.
- Open an active round while online.
- Choose Keep this round available offline.
- Enter total scores while offline.
- Reconnect and let the app sync pending score updates.
Offline scoring stores total score updates for the selected club and user. If the server has a different score when sync resumes, the app surfaces the conflict instead of silently overwriting it.
Round lifecycle
| State | What happens |
|---|---|
| Scheduled | Round is visible and players can RSVP. |
| Active | Score entry and imports are available. |
| Finalized | Scores are locked, tag movement and points are calculated where applicable, and summaries update. |
Finalized competitive rounds can affect tags, leaderboard standings, season points, imports, and betting settlement.