Skip to content
Frolf Bot Docs
Sign In

Admin Reference

Admin and editor access is scoped to the active club. Use the app for club membership, invite codes, imports, betting access, and account tools. Use Discord setup commands only when a club has installed the Discord bot.

Club admin surfaces

SurfaceRolePurpose
/account invite codesEditor, AdminCreate, copy, and revoke invite codes for the active club.
/import review/backfillEditor, AdminReview imports, overwrite finalized scorecards, create historical backfills, and attach PDGA references.
Admin routesAdminManage club-level settings and feature access where exposed by the app.
Betting admin toolsAdminEnable, freeze, disable, adjust wallets, and manage markets where betting is available.
Putting League (/admin/putting-league)AdminCreate and run league nights — divisions, season config, doubles, side games, team battle, and live scoring. Requires League Night.
Station templates & lineup presetsAdminReusable station sets and saved line-ups for league nights. Requires League Night.
Payout settlement (league Settle tab)AdminBuy-ins, prize splits, and marking payouts paid. Requires League Night.
Winnings export (/admin/winnings)AdminExport yearly per-player winnings as CSV for taxes. Requires League Night.
Discord commandsDiscord Administrator/Admin/EditorConfigure Discord setup, roles, seasons, and command links for Discord-linked clubs.

Admin permissions are active-club permissions. Switch clubs before managing invites, imports, betting, or Discord-linked settings for another club.

Feature entitlements. Some surfaces are gated per club. League Night — putting leagues, payouts, and winnings — is turned on by the club owner in admin settings. Betting is set per club by an admin. Gated areas show a locked screen until the feature is enabled.

Invite codes

Requires: Editor or Admin role

Create invite codes from /account.

OptionDescription
RoleRole assigned when someone joins through the code.
Max UsesOptional limit before the code stops working.
Expires InOptional expiry in days.

Discord-linked clubs can run /invite to get a private link to the same account invite-code panel.

Import administration

Requires: Editor or Admin role

Editors and admins can:

  • Review scorecard imports that need mapping
  • Upload scorecard files for eligible rounds
  • Overwrite finalized round scores with a scorecard file
  • Backfill a missing historical round from a scorecard file
  • Attach PDGA event references to rounds

The import review queue also surfaces score attention flags — rounds where automatic score processing raised a concern. A Re-run button next to a flagged round lets editors and admins re-trigger score processing after making corrections.

See Scoring & Imports.

Putting League administration

Requires: Admin role and League Night enabled for the club

Putting leagues have their own admin area at /admin/putting-league. From the create wizard and a night’s Config / Run / Settle tabs, admins manage season configs, divisions, station templates, lineup presets, doubles, side games, team battle, live scoring, UDisc imports, and payouts.

See Putting Leagues for the full workflow and League Payouts for buy-ins and settlement.

Tags administration

Requires: Editor or Admin role

The /admin/tags page provides an All / Untagged / Tagged filter for reviewing tag assignment across all club members.

FilterShows
AllEvery club member.
UntaggedMembers who do not currently hold a tag.
TaggedCurrent tag holders with their tag numbers.

Use this page to identify untagged members to invite to claim tags, or to audit tag distribution before a season transition.

UDisc identity support

Players can set UDisc identity from /account. Discord-linked clubs can also use:

/set-udisc-name username:<username> name:<name>

At least one field is required. This identity helps automatic scorecard matching.

Discord initial setup

Requires: Discord Administrator permission

Before this command can work, Frolf Bot must already be installed in the Discord server.

/frolf-setup

The setup form configures:

FieldDefaultDescription
Channel Name PrefixfrolfPrefix for auto-created channels, such as frolf-events and frolf-leaderboard.
Role NamesFrolf Player, Frolf Editor, Frolf AdminComma-separated names for the three Discord permission roles.
Signup MessageReact with 🥏 to sign up for frolf events!Message posted in the signup channel.
Signup Emoji🥏Emoji players react with to trigger the signup direct message.

Recommended Discord-linked sequence:

  1. Create or identify the club in the app.
  2. Install Frolf Bot in Discord.
  3. Run /frolf-setup.
  4. Invite players through app invite codes, Discord reaction signup, or Discord server discovery.

Reset Discord setup

Requires: Discord Administrator permission

/frolf-reset

Resetting deactivates the Discord server configuration and unregisters commands. It does not delete round history, profiles, scores, tags, imports, betting history, or leaderboard data.

Role management from Discord

Requires: Editor role

/updaterole user:@member

Opens a Discord role selector for the member using the configured Frolf Bot role names.

Season management

Requires: Admin role

These Discord /season commands manage competitive (tag) seasons. Putting leagues use a separate season config set in the Putting League admin area — see Putting Leagues.

/season start name:<name>
/season standings
/season end
/season summary

/season summary posts a season summary embed to the leaderboard channel. It accepts an optional season_id; when omitted, it summarizes the most recently ended season.

Dashboard and betting links

/dashboard
/bet

/dashboard posts a private link to the app. /bet links to the betting page when betting is enabled for the club.

Support

For setup help, onboarding issues, or support questions, join the Frolf Bot support server.