PractiScore Neo

Quick start

Everything happens in your DMs with the bot. Nobody else can use it, and it never posts in a server channel.

1. Open a DM with the bot. In your server, click PractiScore Neo in the member list and choose Message. Type / to see its commands.
2. Check it's healthy. Run /status. You want Scraping: On and Health: OK.
3. See what's tracked. /clubs lists your clubs and /matches lists their upcoming matches.
4. Add a club. /addclub url:https://practiscore.com/clubs/<club>. The reply lists its matches with a picker to star the ones you care about.
5. Tune the noise. Use the Star / Normal / Mute buttons on alerts, /manage to change several matches at once, or set rules so new matches of a type start at the right level.

How it works

The bot loads each club's PractiScore page, such as practiscore.com/clubs/tps-uspsa. Every listed match has a registration label, which the bot reads as a state:

Alerts come from changes between checks: a match appearing, its state changing, its date changing, or it disappearing from the page.

That's why an early manual opening is caught. It doesn't matter what date registration was supposed to open: the moment the label turns green, the next check sees it.

Club tiers

A tier sets how often a club's page is checked. Change it with /tier.

One page load covers every match at a club, so the cost of a club depends only on its tier, not on how many matches it has.

Match levels

A level sets which alerts you get for a match. Change it with the buttons on any alert, /star, /unstar, /mute, /manage, the /scan picker, or rules.

Where a new match starts: the matching rule if there is one, otherwise the club tier's default (watched → starred, standard → normal, manual → muted).

Alerts

Every alert is a DM. The coloured edge tells you what kind it is at a glance.

Every alert except "Match Removed" has Star · Normal · Mute buttons, and alerts with a match page have a View Match or Register Now link.

You'll also get a red Scraping is failing DM if checks keep failing (three in a row by default), and a green Scraping recovered DM when they work again. That's one pair per outage, not a DM every time a check fails.

When checks run

The bot looks every 5 minutes for anything that's due.

Regular checks

Regular checks follow each club's tier, and only between 8 AM and 9 PM Eastern. A watched club is checked about 8, 11 AM, 2, 5 and 8 PM, depending on when it was last checked. Restarting the bot doesn't trigger extra checks.

Registration-time checks

When a starred or normal match's label says "opens in N hours" or "opens in N minutes", the bot schedules extra checks around that moment. These run at any hour, including overnight.

They work the same at every tier except paused: a starred or normal match at a standard or manual club gets exactly the same extra checks as one at a watched club. The tier only decides how often a regular check comes along to read the countdown.

The evening checks see any opening before the next morning as hours, so an opening at 2 AM gets checked at about 2 AM.

How close to the opening the alert arrives

The first extra check lands halfway through the hour the countdown points to:

• Opening in the second half of that hour: the halfway check sees "opens in N minutes" and schedules one more for just after. The alert arrives about 1–2 minutes after opening.
• Opening in the first half: the halfway check finds it already open. The alert arrives up to 30 minutes after opening.

Rules

A rule sets the starting level of a club's newly posted matches based on their type or title.

/rule club:TPS USPSA text:Steel level:normal
/rule club:TPS USPSA text:PCSL level:muted

How text matches

• It's compared against the match's type (e.g. Steel Challenge: Blank, USPSA level I, PCSL 1-GUN) and its title together.
• Case doesn't matter, and it matches anywhere, even inside a word (pcsl matches PCSL 1-GUN).
• It's literal text: no wildcards and no "or". Spaces and punctuation count.
• If several rules match, the longest text wins, so a specific rule can override a broad one.
• No match? The tier default applies (watched → starred, standard → normal, manual → muted).
• Rules only apply to matches posted after you create them. Change existing matches with /star, /unstar, /mute or the buttons.

Example at a watched club

To remove a rule, run it again with level:remove. Every /rule reply lists the club's current rules, and /clubs shows them too.

Commands

All commands work in the bot's DMs only. Club and match names autocomplete as you type. /help command:<name> shows the same details inside Discord.

Buttons & picker

Star · Normal · Mute buttons

On every alert except "Match Removed". Tap one to set that match's level; the bot confirms with a short reply. The buttons keep working after the bot restarts. The highlighted button shows the level when the alert was sent.

The match picker

Replies to /addclub and /scan include a Choose matches to be alerted about menu (up to 25 matches):

• Matches you select become ⭐ starred.
• Matches that were starred and you deselect go back to normal (muted at a manual club).
• Matches you never touched keep their level.

The picker stops working after an hour or a bot restart. Run /scan again for a fresh one.

The /manage panel

Select matches in its menu, then press ⭐ Star, Normal or 🔇 Mute. Only the selected matches change. See /manage for its tier, scan and remove controls.

Recipes

Request usage

Each check loads one club page through the scraping service, which costs one request no matter how many matches the club lists. Commands that only read saved data (/matches, /clubs, /status, and /manage unless you press Scan now) cost nothing. /usage shows what's actually been spent.

Limits worth knowing

• No exact registration times yet. Club pages only show a rounded countdown, and match pages hide exact times behind a login. Registration-time checks work from the "hours" and "minutes" countdowns. Exact times from PractiScore's search index are planned.
• Removal takes two checks. A match must be missing twice in a row, so one bad page load never causes a false alarm. At a watched club that's about 3–6 hours after it disappears.
• An empty page is treated as a failed check, not as every match being cancelled.
• Past matches drop off the listing naturally and are never reported as removed.
• Full and waitlist labels haven't been seen yet. When one appears you get an "Unrecognized Registration Label" DM.
• Manual clubs aren't checked at all unless a starred match is waiting to open, so news about their other matches only arrives when you /scan.

Troubleshooting