Skip to content
Frolf Bot Docs
Sign In

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:

FieldRequiredDescription
TitleYesName of the round.
DescriptionNoNotes, card details, or other context.
Start TimeYesLocal date and time for the round.
TimezoneYesUS timezone picker; defaults to your detected zone — change it only if it’s wrong.
LocationYesCourse name or address.
Apply handicapNoEditors and admins only. Score this round on handicap-adjusted (net) scores.
Course parIf handicap is onThe 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:

ExampleMeaning
-3Three under par.
0Even.
+2Two 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.

  1. Open the round’s + Add Player panel and search by name, or choose Create Guest to add a new row.
  2. The guest plays in the round; scores are recorded under the guest row.
  3. After the round, the admin shares a claim code with the guest.
  4. The guest creates an account, enters the claim code on their profile, and a voucher is submitted.
  5. 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.

  1. Open an active round while online.
  2. Choose Keep this round available offline.
  3. Enter total scores while offline.
  4. 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

StateWhat happens
ScheduledRound is visible and players can RSVP.
ActiveScore entry and imports are available.
FinalizedScores 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.