Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions api/crates/api/src/runs.rs
Original file line number Diff line number Diff line change
Expand Up @@ -130,6 +130,24 @@ async fn submit_run(
let stored = store(&mut tx, key, &run).await?;
tx.commit().await?;

// A player is otherwise fetched from Steam only when they sign in or their profile is opened, so one who just
// plays would show initials everywhere they're listed. Their runs keep the copy fresh instead; the queue's
// spacing and cap keep this to Steam's pace however busy the servers are.
if stored.created {
let fetched_at = sqlx::query_scalar!(
"SELECT steam_profile_fetched_at FROM players WHERE steamid64 = $1",
run.player.steamid64.get()
)
.fetch_one(&state.db)
.await?;
players::steam_profile::refresh_if_stale(
state.db.clone(),
state.steam.clone(),
run.player.steamid64,
fetched_at,
);
}

let status = if stored.created {
StatusCode::CREATED
} else {
Expand Down
2 changes: 1 addition & 1 deletion docs/site-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Players sign in with Steam (OpenID 2.0); the endpoints answer browsers (redirect
- Profiles take a SteamID64, SteamID2 or SteamID3 and answer with the SteamID64. Placements rank personal bests per map, style and track; equal times share a place.
- Per style, a profile counts completed maps (main tracks, out of the map list's count), completed bonuses and world records, and carries the first 50 main-track personal bests by map; `…/personal-bests?style=&tracks=main|bonuses&cursor=` pages on, and `records=true` keeps only world records (2.0 only). Without `style` it lists every style, newest first; `all_styles` counts across styles. Ranks: `main_standing`, `bonus_standing` (lead, 2026-11-04).
- `PUT /v1/players/{player}/details` (rules in `players/details.rs`): setup and a country (`GET /v1/countries`), a save per 5 s; others' need `manage_bans` and a logged reason. Old-site setup shows first.
- Avatar, country (unless the player picked one) and (until a run gives one) name come from their public Steam profile XML, fetched at sign-in and on viewing one over a day old (an hour after a failed one): one request per 2 s, 50 queued, one per player. Country names map to ISO codes in `players/countries.rs`.
- Avatar, country (unless the player picked one) and (until a run gives one) name come from their public Steam profile XML, fetched at sign-in, and when a day old after a run or a view (an hour after a failed one): one request per 2 s, 50 queued, one per player. Country names map to ISO codes in `players/countries.rs`.
- Staff privileges are a bitmap in `players.privileges` (`players/privileges.rs`). Bit positions never change; the API names privileges and never sends numbers. `players.restrictions` is unused (bans hold restrictions). The CLI's `privileges grant <steamid> <name>…`, `revoke`, `list` and the staff tools share `staff/privileges.rs`.

## Maps and leaderboards
Expand Down