Connect your assistant

Your assistant sees exactly what you see when you are signed in — never more, never another person's private data.

• ·Games, variations and rulesets in the catalogue
• ·Your groups, their members and their standings
• ·Matches and sessions you can already open
• ·Every ranking view, and the explanation of each method
• ·Your collections, wishlists and homes

Your own owned-games and wishlist rows — your lane alone, and every change is one you can undo.

• ·Add and remove games you own
• ·Add and remove wishlist games
• ·Edit the items inside your own collections

Your assistant can write down a game night and hand it to you; nothing lands on anyone's standings until you tap confirm.

• ·Draft a match or a whole game night, awaiting your confirmation
• ·Suggest corrections to something already recorded
• ·File a dispute, which asks a person to look — it changes no record

Recording a match changes several people's ranking history at once, so signing in never grants this. You raise it yourself, once, and can lower it again.

• ·Record matches and sessions without a confirmation step
• ·Create groups, and add players to them
• ·Link a player to an existing account found by exact email
• ·Add and edit games and game notes in the catalogue

The reversible destructive verb, and only the reversible one.

• ·Void a match
• ·Delete a group

The orientation call — make it first. Returns who the person is on How You Rank, the groups they play in with each group's pinned ranking methods and their own position under them, any game night that is currently open, their most recent matches, and which permissions this connection actually holds.

Find games by name or keyword. Returns slug, player counts, and how many variations each has. Use the slug with hyr_get_game.

Everything the encyclopedia holds about one game: how to play, history, official links and videos, its variations and their rulesets, frequently asked rules questions, scorecard styles, and which of the 49 ranking methods suit it.

Call this before hyr_record_match for any game you have not recorded before. Games differ enormously — some record points, some placements, some only a winner, some are co-operative — and this returns the exact result signature for a variation, naming the fields a match write must carry and the values they accept.

A group's members, the ranking methods it has pinned as its scoreboard, its per-game weighting, and the standings under a method you choose. Groups this person cannot see are not returned.

How You Rank's founding idea: the same match history, ranked many ways. Ask for a group's, a game's or a person's standings under a named method, or omit the method to get the list of methods with what each one measures.

Recent matches this person can see, newest first, with each one's result and how it was recorded (by a person, or by an assistant, and which one). Filter by group or game.

Sides, players, scores, placements, which groups it counts in, whether anyone has disputed it, and its provenance.

Sessions — an evening of games in one group. Returns what is open now and what has finished, with each night's games and standings. A match recorded while a night is open joins that night automatically.

Every collection they keep — a main shelf, a camping bag, a two-player shelf — plus their wishlist, with the games on each.

The person's own achievements, and the ones they are nearest to earning.

This connection's own permissions: what it holds, what it does not, and what is never issuable to any assistant. If a write refuses for want of a permission, call this and tell the person exactly which one to raise, and where.

Add games to a collection, take them off, or move them between shelves. This is the person's own lane — nobody else's records change, and everything here is reversible.

Files a dispute on a recorded match. This changes no record and no standings — it asks the people in the group to check something. Use it when you believe a result is wrong rather than editing anything.

Writes a result. This is not the person's own lane: recording a match changes several people's ranking history at once, which is why signing in alone never grants it. Call hyr_describe_result_shape first unless you already know this game's result signature. If a game night is open in the group, the match joins it automatically. Every match you write is marked as recorded by this assistant.

Starts, ends or reopens a session in a group. This matters beyond bookkeeping: while a night is open, every match recorded in that group joins it — by you, by the person, or by anyone else in the group.