Ruleset URI

Every Volity [Internet RFC-2396], the standard URI syntax rules.

As with URIs found throughout the world of Internet protocols, each ruleset URI serves multiple functions.

• Since a given URI is guaranteed to be unique across the entire Internet, assigning a URI to a Volity ruleset gives it a label and a namespace that is always unambigious. Volity uses rulesets in this manner for sub-applications such as the UI finder.
• Thorough Volity designers will also have their rulesets' URIs serve double-duty as URLs pointing to Web pages describing the rulesets in detail.

Ruleset URIs in game records

Ruleset URIs are also a key component of game records, indicating the type of game that the rest of the record describes. However, because table configuration can change what rules are active at a given table, effectively making the game played there slighty different. When preparing a game record, the referee acknowledges this difference by appending a query string to the recorded ruleset URI, holding one or more key/value pairs for every configuration variable that the ruleset defines. The ruleset also defines the syntax for each part of the query string.

So, to continue the above example, the game record of an RPS game that allowed ties but was a best-of-three contest would claim a URI of http://volity.org/games/rps?no_ties=0&best_of=3.

Since URIs get compared string-wise, the referee will have to maintain a canonical order of key/value pairs.