package tbadmin
Get desktop application:
View/edit binary Protocol Buffers messages
rpc CreateUser (, )
account.proto:192Create a new user account.
message
account.proto:89Create a new user.
optional spec = 1
New account owner, identifiers and authentication.
optional prefs = 2
Optional preferences.
optional int32 access = 10
Permission bits for the new account. Can't be more permissive than the invoking account.
optional tbmatch.LoginStatus login_status = 11
Login state of the account.
message
account.proto:103optional int64 account_id = 1
rpc GetHandleHistory (, )
account.proto:229Get the history of handle changes for an account.
message
account.proto:148optional int64 account_id = 1
message
account.proto:151optional int64 account_id = 1
repeated change = 2
rpc LookupUser (, )
account.proto:182Look up a user account by primary key.
message
account.proto:11Admin user lookups.
optional int64 account_id = 1
Find user account ID.
optional string email = 2
Find user by e-mail address.
optional string handle = 3
Find user by player handle.
rpc NukeHandle (, )
account.proto:224Rename an offensive handle with an automatically generated one, and send a notification e-mail.
message
account.proto:138optional int64 account_id = 1
Account with the offensive handle.
message
account.proto:142optional int64 account_id = 1
optional string new_handle = 2
New handle assigned to the account.
rpc ResetUserPassword (, )
account.proto:218Reset the user's password to the one provided. Also resets any temporary abuse lock on the account.
message
account.proto:133Set the account password to the one given.
optional int64 account_id = 1
optional string password = 2
rpc SearchUsers (, )
account.proto:187Find user accounts.
message
account.proto:63Admin user search requests.
optional criteria = 1
optional sort = 2
optional int32 offset = 5
Pagination.
optional int32 limit = 6
message
account.proto:71repeated users = 1
Results do not include preferences or contact address.
optional bool end_of_data = 2
Send a system-generated notification e-mail to the address on file. Account must have a validated e-mail address.
message
account.proto:156optional int64 account_id = 1
Target account. Must have a validated e-mail.
optional SendUserEmailNotificationRequest.NotifyType type = 2
optional friend_codes = 12
rpc SetUserAccess (, )
account.proto:207Modify a user's access permissions.
message
account.proto:114Change permission bits for a user account.
optional int64 account_id = 1
optional int32 grant = 3
Roles to grant.
optional int32 revoke = 4
Roles to revoke.
optional int32 __deprecated_access = 2
Set or modify a user's contact address.
message
account.proto:108Update the user's contact address.
optional int64 account_id = 1
optional contact_address = 2
rpc SetUserLoginStatus (, )
account.proto:212Assign the user an explicit login status.
message
account.proto:127Set the login state of an account.
optional int64 account_id = 1
optional tbmatch.LoginStatus login_status = 2
rpc UpdateUser (, )
account.proto:197Modify a user's primary fields and/or preferences.
message
account.proto:78Admin account changes.
optional int64 account_id = 1
optional spec = 2
Changes to account record.
optional prefs = 3
Changes to preferences.
service AuditService
audit.proto:107rpc SearchAuditHistory (, )
audit.proto:109Display a portion of audit log history.
message
audit.proto:95optional criteria = 1
optional sort = 2
optional int32 offset = 5
optional int32 limit = 6
message
audit.proto:102repeated events = 1
optional bool end_of_data = 2
service ConfigService
config.proto:900Allow frontend and other servers to read AppConfig.
rpc GetAppConfig (, )
config.proto:901message
config.proto:886AppConfig contains application reference data and behavioral settings. It is stored in the database and is applied universally by all servers. It should NOT contain highly sensitive information such as credentials or key material.
optional account_config = 1
optional match_config = 2
optional shop_config = 3
optional event_config = 4
optional audit_config = 5
optional lobby_config = 6
optional crash_report_config = 7
optional server_rollout_flags = 8
optional desync_report_config = 9
optional export_trim_config = 10
service FailReportService
report.proto:75message
report.proto:56optional int32 offset = 1
optional int32 limit = 2
message
report.proto:61repeated identifiers = 1
rpc ListCrashCollections (, )
report.proto:89message
report.proto:65optional int32 offset = 1
optional int32 limit = 2
optional string build_identifier = 3
message
report.proto:71repeated collections = 1
rpc ListCrashes (, )
report.proto:81message
report.proto:44optional int32 offset = 1
optional int32 limit = 2
optional string build_identifier = 3
optional string crash_identifier = 4
message
report.proto:51optional collection = 1
repeated reports = 2
rpc ListDesyncs (, )
report.proto:77message
report.proto:36optional int32 offset = 1
optional int32 limit = 2
message
report.proto:40repeated desync = 1
service MatchAdminService
match.proto:165rpc GetActiveMatch (, )
match.proto:182message
match.proto:131optional tbmatch.MatchType match_type = 1
optional int64 match_id = 2
message
match.proto:135optional match = 1
rpc GetActiveMatches (, )
match.proto:178message
match.proto:123optional tbmatch.MatchType match_type = 1
optional int32 limit = 2
message
match.proto:127repeated match = 1
rpc GetLobbies (, )
match.proto:170message
match.proto:110optional int32 limit = 2
message
match.proto:113repeated lobby = 1
rpc GetLobby (, )
match.proto:174message
match.proto:116optional int64 lobby_id = 1
message
match.proto:119optional lobby = 1
rpc GetMatchDetail (, )
match.proto:190message
match.proto:150optional int64 match_id = 1
message
match.proto:153optional match = 1
rpc GetMatchQueueUsers (, )
match.proto:166message
match.proto:102optional tbmatch.MatchType queue = 1
message
match.proto:106repeated user = 1
rpc GetPlayerDetail (, )
match.proto:194message
match.proto:157optional int64 account_id = 1
message
match.proto:160optional player = 1
rpc GetRecentMatches (, )
match.proto:186message
match.proto:139optional tbmatch.MatchType match_type = 1
optional int32 limit = 2
optional int64 player_account_id = 3
Limit results to those with the given player involved.
message
match.proto:146repeated match = 1
rpc CreateFeatureRule (, )
config.proto:271message
config.proto:215optional rule = 1
Also deletes any feature rules referencing the feature.
message
config.proto:205optional string tag = 1
rpc DeleteFeatureRule (, )
config.proto:277message
config.proto:221optional int64 rule_id = 1
rpc GetActiveFeatures (, )
config.proto:268message
config.proto:212optional feature_set = 1
rpc GetGlobalConfig (, )
config.proto:227message
config.proto:173optional config = 1
rpc GetLobbyConfig (, )
config.proto:245message
config.proto:191optional config = 1
rpc GetMatchQueueConfig (, )
config.proto:233message
config.proto:179optional config = 1
rpc GetMatchUserConfig (, )
config.proto:239message
config.proto:185optional config = 1
message
config.proto:199repeated def = 1
rpc ListFeatureRules (, )
config.proto:265message
config.proto:209repeated rule = 1
rpc SetFeatureDefinition (, )
config.proto:257Create or update a feature definition.
message
config.proto:202optional def = 1
rpc SetGlobalConfig (, )
config.proto:230message
config.proto:176optional config = 1
rpc SetLobbyConfig (, )
config.proto:248message
config.proto:194optional config = 1
rpc SetMatchQueueConfig (, )
config.proto:236message
config.proto:182optional config = 1
rpc SetMatchUserConfig (, )
config.proto:242message
config.proto:188optional config = 1
rpc UpdateFeatureRule (, )
config.proto:274message
config.proto:218optional rule = 1
service ShopAdminService
shop.proto:79rpc RefundPurchaseOrder (, )
shop.proto:98Refund payment for a settled order.
message
shop.proto:74Refund a completed purchase order with settled payment.
optional int64 order_number = 1
rpc SearchPurchaseOrders (, )
shop.proto:82Search over all purchase orders. Admin only. Returns headers only, no line items.
message
shop.proto:41Search for purchase orders.
optional criteria = 1
Restrictions on the search.
optional sort = 2
Order sorting
optional int32 offset = 5
Skip past this many records in the result.
optional int32 limit = 6
Max number of results to return.
message
shop.proto:54repeated orders = 1
Orders that matched the criteria.
optional bool end_of_data = 2
True when the included results reached the end of the query result.
rpc SyncPurchaseOrder (, )
shop.proto:88Bring purchase order up to date with external transaction state. This operation causes goods to be delivered or revoked.
message
shop.proto:64Reconcile a purchase order state with external payment processing transaction state.
optional int64 order_number = 1
rpc VoidPurchaseOrder (, )
shop.proto:93Cancel payment for a purchase order still pending settlement.
message
shop.proto:69Cancel a pending purchase order.
optional int64 order_number = 1
service StatsService
stats.proto:122rpc CountUsers (, )
stats.proto:123message
stats.proto:8optional int64 total = 1
optional int64 no_access = 2
repeated role = 3
rpc GetCharacterUsage (, )
stats.proto:131message
stats.proto:114optional options = 1
message
stats.proto:118optional report = 1
rpc GetSessions (, )
stats.proto:127message
stats.proto:100optional int32 max_age_sec = 1
optional int32 limit = 2
message
stats.proto:105repeated game = 1
repeated launcher = 2
repeated web = 3
optional int32 total = 10
Total sessions active.
message
config.proto:549Rules for handling account RPCs.
Used in:
optional int32 min_password_length = 1
Minimum length when setting a password.
optional int32 min_password_classes = 2
Minimum number of unique character classes for a password.
repeated tbrpc.Access register_access = 3
Access roles granted to publicly registered accounts.
optional int32 email_validate_confirm_secs = 4
How long before e-mail validation links expire.
optional string email_validate_url_prefix = 5
Prepended to email validation links.
optional int32 validate_nonce_length = 6
Number of bytes in the generated nonce hex string.
optional int32 password_reset_expire_secs = 7
How long a password reset code is valid for in seconds.
optional int32 password_reset_code_length = 8
Number of letters and numbers in the reset code.
optional int32 max_user_search_result = 10
Max number of users to return from SearchUsers.
optional int32 lockout_duration_mins = 20
Minutes to keep an account locked out after exceeding lockout_threshold attempts.
optional int32 lockout_threshold = 21
Number of failed login attempts before account is locked. Set to 0 to disable lockout.
optional int32 reset_lockout_counter_after_mins = 22
Number of minutes after the last login failure after which the counter is reset to 0.
optional int32 session_ticket_expire_secs = 30
How long do session tickets last (SessionService.RequestSessionTicket)?
optional bool require_registration_key = 40
Require a registration key?
repeated string disallow_handle_regexp = 41
Deny any handle that full-matches one of these expressions.
optional string nuke_handle_prefix = 42
Prefix to use when generating a handle to replace an offensive/disallowed one.
optional int32 nuke_retries = 43
Pre-existing nuked handles to skip over before giving up.
message
audit.proto:17Used in: ,
optional int64 account_id = 1
optional string email = 2
optional string handle = 3
message
match.proto:41Used in: ,
optional int64 match_id = 1
optional desc = 2
optional int64 start_time_unix = 3
message
config.proto:493Used in:
optional bool enable_export_trim = 1
Periodically look for history records in BQ and remove them from PostGres. Behavior is configured through ExportTrimConfig within AppConfig.
message
audit.proto:23Used in:
optional user = 1
Account that was affected.
optional tbmatch.LoginStatus login_status = 2
message
config.proto:832Used in:
optional int32 max_audit_search_result = 1
Most number of results to return from an audit query.
optional int32 max_audit_search_days = 2
Largest time range allowed for a search.
message
audit.proto:36Used in:
optional actor = 2
User who initiated the operation.
optional string event_time = 3
When the operation occurred.
optional AuditEventType event_type = 4
Category of the event.
optional string remote_ip = 5
IP address of the initiating session.
optional string server_host = 6
Hostname of the server that handled the request.
optional string operation = 9
Name of the operation.
optional string query = 10
Parameters of the query, if one was invoked.
optional account = 11
Account that was affected, if any.
optional order = 12
Order that was affected, if any.
message
audit.proto:66Criteria that can constrain a search for audit events.
Used in:
optional int64 actor_account_id = 1
optional event_time = 2
optional AuditEventType event_type = 3
optional string remote_ip_net = 4
CIDR netmask
optional server_host = 5
optional operation = 6
optional query = 7
optional int64 account_id = 11
optional int64 order_id = 12
message
audit.proto:79Options for sorting audit events returned by a query.
Used in:
optional AuditEventSort.SortBy first = 1
optional AuditEventSort.SortBy second = 2
optional bool descending = 3
Used in:
ACTOR_ID = 1
EVENT_TIME = 2
REMOTE_IP = 3
SERVER_HOST = 4
OPERATION = 5
ACCOUNT_ID = 6
ORDER_ID = 7
Used in: ,
USER = 1
ACCOUNT = 2
ORDER = 3
QUERY = 4
message
audit.proto:29Used in:
optional int64 order_number = 1
Order that was affected.
optional tbmatch.OrderStatus status = 2
Order status as of the end of this event.
message
stats.proto:30Used in: ,
optional int64 start_time_unix = 1
Time of first match to include, 0 = all
optional int64 end_time_unix = 2
Time of last match to include, 0 = now
optional string build_version = 4
Global filter options.
Limit results to a specific build.
optional tbmatch.MatchType match_type = 5
Limit results to a specific match type.
optional bool include_disconnect = 6
Include disconnected matches.
optional bool include_disagree = 7
Include foul-play matches.
optional int32 max_rating_diff = 10
Win ratio options.
Most allowed rating difference for a win ratio query.
optional int32 rating_bucket_size = 11
Width of Glicko2 rating buckets.
message
stats.proto:63Overall stats for an individual character.
Used in:
optional string type_name = 1
optional uint32 total_matches = 2
Number of match slots involved in.
optional uint32 unique_users = 3
Number of unique users who played the character.
optional uint32 wins = 4
optional uint32 disconnects = 5
repeated variant_top_n = 6
message
stats.proto:71Used in:
optional string specials = 1
optional uint32 count = 2
message
stats.proto:78Used in:
optional int64 report_time = 1
Time this report was generated.
optional options = 2
Query parameters that bounded the report scope.
optional uint32 total_matches = 10
Matches observed in this report.
optional uint32 total_users = 11
Total unique users considered for the report.
repeated char_usage = 13
Summary stats for each character.
repeated win_ratio = 14
Half-matrix of win/loss ratios for each character combo & rating band.
message
report.proto:6Used in:
optional string build_identifier = 1
optional string app_name = 2
optional string build_version = 3
message
report.proto:12Used in: ,
optional string crash_identifier = 1
The top line of the stack trace, used as a unique identifier to group together the same types of crash.
optional string build_identifier = 2
optional uint64 occurrences = 3
optional uint64 users_affected = 4
The number of unique users affected by the crash. Less than num_occurrences if a crash happens to the same person more than once.
optional string stack_trace = 5
message
config.proto:840Used in:
optional bool should_store_crash_bundles = 1
optional int32 max_versions_to_keep = 2
the number of build versions for each client app to keep the crash redis records around for
optional int32 polling_interval = 3
the interval to check for new crash reports to symbolicate, in seconds
message
report.proto:27Used in:
optional string report_path = 1
The path on gcs
optional int64 timestamp = 2
optional string app_name = 3
optional string build_version = 4
optional string machine_id = 5
optional string crash_number = 6
The crash number on a per-build version basis
message
config.proto:797What currencies are supported and their rules.
Used in:
repeated desc = 1
optional string default_currency = 2
Currency to use for new accounts when the country code is unknown.
message
config.proto:768Describes a supported currency and rules for working with it.
Used in:
optional string code = 1
3-letter capital code.
optional int32 precision = 2
Digits of precision.
optional string symbol = 3
Character prepended to distinguish values.
repeated string country_iso3 = 4
List of 3-letter country codes that use this currency.
optional bool balance_purchase_allow = 40
Allow balance loads with this currency.
repeated balance_purchase_default = 41
Default values given for account balance purchases.
optional balance_purchase_min = 42
Range of allowed custom balance purchase amounts.
optional balance_purchase_max = 43
optional balance_max = 50
Maximum balance an account may hold in this currency. Orders that would exceed this amount are rejected.
message
config.proto:297How to connect to the database.
Used in:
optional string user = 1
optional string password = 2
optional string host = 3
optional int32 port = 4
optional string database = 5
optional int32 connect_timeout = 6
How long to wait for a connection to establish in seconds. Zero means infinite.
optional int32 max_idle = 7
Max number of idle connections.
optional int32 max_open = 8
Max open connections.
optional string ssl_mode = 9
"disable", "require", or "verify-full"
optional string schema_path = 20
message
config.proto:860Used in:
optional int32 polling_interval = 3
the interval to check for new desync reports to process, in seconds
message
config.proto:631Used in:
repeated echelon = 1
Define all ranking echelons in progression order (0=Carbon .. N-1=Legend)
optional int32 win_streak_bonus_minimum = 10
Number of wins in a streak for bonus to apply.
optional int32 win_streak_bonus_points = 11
Points to award for a win streak bonus.
message
config.proto:620Used in:
repeated int32 tier_points = 1
Points required to advance for each tier in this echelon.
optional bool ignore_loss = 2
If true, don't apply losses while in this echelon.
optional bool final = 3
If true, echelon has no tiers or points.
message
config.proto:820Used in:
optional int32 change_wait_timeout_ms = 10
Milliseconds that RPCs waiting on changes are allowed to wait before giving up.
optional int32 event_expiry_ms = 11
Default lifetime of time-limited events.
optional int32 user_key_expiry_sec = 12
Default lifetime of user event queue keys themselves.
message
config.proto:865Configuration for trimming database history tables which are accumulated externally.
Used in:
optional bool trim_enabled = 1
Whether database table trimming is enabled.
optional int32 min_age_days = 2
Don't look for records younger than this age.
optional int32 batch_size = 3
Process at most this many records at once.
optional int32 trim_interval_mins = 4
How often to trim the database.
message
config.proto:969Used in: ,
optional match_client = 1
Where to reach Match API servers.
optional string app_login = 2
Backend account to use for fetching application metadata.
optional string app_password = 3
optional int32 startup_wait_sec = 10
How long to wait for readyness on startup.
message
config.proto:998Run-time file for the tbfe web application server.
optional int32 http_port = 1
Port to listen on for HTTP requests.
optional session_key = 2
Session key(s) to use.
optional int32 session_timeout_secs = 3
Number of seconds after which idle sessions will expire.
optional int32 go_max_procs = 4
Number of cores Go runtime should use.
optional string json_access_log_path = 5
Where to write access records in JSON format.
optional monitor_config = 10
Monitoring configuration.
optional redis_config = 60
How to talk to Redis for sessions.
optional content_config = 61
Where to find and how to serve dynamic HTML content.
optional backend_config = 62
Where to reach backend API servers.
optional vanilla = 70
message
config.proto:916Used in:
optional string data_dir = 1
Directory containing templates and data files.
optional string static_dir = 2
Root for static web content (optional).
optional bool devel_mode = 3
If enabled, reload templates on every request.
optional string message_dir = 4
Directory where localization resources can be found. tb.properties must be present here.
optional string application_name = 5
Name of the application.
optional string recaptcha_site_key = 6
optional string recaptcha_secret_key = 7
optional string recaptcha_verify_url = 8
optional string recaptcha_proxy_url = 9
HTTP(s) proxy to use when querying the recaptcha URL.
optional int32 recaptcha_failure_threshold = 10
After how many form submission failures should you have to solve another CAPTCHA?
optional string canonical_hostname = 11
If set, send 301 redirect requests NOT using this host name.
optional string canonical_scheme = 12
URL scheme to use when redirecting to canonical_hostname.
optional string internal_error_template = 20
Template to use for content of a 503 Internal Server Error.
optional string not_found_template = 21
Template for 404 not found page content.
optional string login_redirect_path = 22
Path to redirect to when an authorized-only page is requested with no valid session.
optional string launcher_download_url = 30
Link to download the launcher for logged-in users.
optional string forum_url = 31
Link to the forum.
optional string landing_redirect_url = 40
If set, redirect requests to the landing page to here.
message
config.proto:137Defines a client feature flag.
Used in: ,
optional string tag = 1
Unique tag identifying the feature. Cannot be empty or contain spaces.
optional string description = 2
Free-form description of the feature.
message
config.proto:146Describes when a set of feature flags are enabled.
Used in: , ,
optional int64 rule_id = 1
Server-generated unique ID of the rule.
optional feature_set = 2
Feature tags and values enabled by the rule.
optional bool enabled = 3
Rule is only effective when enabled.
optional int32 priority = 4
Rules are evaluated in increasing priority order, with higher priority rules taking precedence in case of conflict on a feature tag.
optional string owner = 5
Who owns this rule?
optional string notes = 6
Free-form text about this rule.
optional int64 active_time_unix = 10
If set, time after which the rule becomes active.
optional int64 inactive_time_unix = 11
If set, time after which the rule becomes inactive.
message
config.proto:345Generic Google API access credentials
Used in:
optional string proxy_url = 1
optional string project_id = 2
optional GApiConfig.AuthType auth = 4
optional string gce_account = 10
Optional role account for auth == GCE
optional string sdk_account = 11
Optional account name for auth == SDK
Used in:
GCE = 1
SDK = 2
message
config.proto:363Where to store something on Google Cloud Storage.
Used in: ,
optional string proxy_url = 1
optional string project_id = 2
optional string bucket_name = 3
message
config.proto:650Used in:
optional float tau = 1
How deterministic are matches in this game (0.2 .. 1.2)
optional int32 rating_period_mins = 2
How many minutes in each rating period?
optional int32 check_period_mins = 3
How often should MatchMaker master check for new matches to rate?
optional float max_deviation = 10
Rating deviation (RD) for an unrated (or maximum lapsed) player.
optional float min_deviation = 11
Rating deviation (RD) never to drop below, to ensure some freedom of movement.
optional float deviation_decay_periods = 12
Number of rating periods must pass before an active player's deviation becomes as uncertain as that of an unrated player. Determines 'c' in Glicko paper. Default (for 30 minute period) is 3 weeks.
optional float typical_deviation = 13
Rating deviation of a "typical" active player for computation of 'c'.
message
config.proto:11Used in: ,
optional string req_build_version = 1
Build version required by the server to login. If blank, any build will be allowed.
message
account.proto:53Used in:
optional int64 time = 1
Unix timestamp of the handle change time.
optional string old = 2
Old handle.
optional string new = 3
New handle.
message
config.proto:606How an experience counter maps to increasing "levels". Level 1 starts at 0 XP.
Used in:
optional int32 baseline = 1
How much XP is required to reach level 2 from level 1.
optional double coefficient = 2
A level takes this much more XP to reach than the previous level.
optional int32 match_xp = 3
XP awarded for playing a match.
optional int32 win_bonus_xp = 4
XP awarded for winning a match.
message
config.proto:104Used in: ,
optional int32 max_members = 1
Max number of users to allow in a lobby.
optional int32 match_ttl = 2
Time-to-live for match keys generated by the lobby.
optional int32 lobby_ttl = 3
Time to live for lobby keys.
optional int32 active_match_timeout = 4
How long lobby matches remain in the active matches list if leaked.
message
config.proto:726Used in:
optional int32 join_code_length = 1
Number of characters in the join code.
optional int32 max_members = 2
Maximum number of members allowed in a single lobby.
message
match.proto:28Used in: ,
optional lobby = 1
optional string build_version = 10
optional int32 members = 11
optional int64 create_time_unix = 31
optional int64 last_active_time_unix = 32
optional double __deprecated_age = 21
optional double __deprecated_idle = 22
message
config.proto:120optional int32 match_log_ttl = 1
Time to live for log types in seconds.
optional int32 default_log_ttl = 20
Default time to live for unspecified log types
message
config.proto:451Used in:
repeated host = 1
optional bool tls = 3
optional bool insecure_skip_verify = 4
optional string auth_user = 5
Login credentials.
optional string auth_password = 6
optional string template_path = 7
Location of mail fragments and templates.
optional string include_path = 8
optional bool auto_reload = 9
Check for changes on disk when fetching a template.
optional vars = 20
message
config.proto:453SMTP hosts to connect to.
Used in:
optional string host = 1
optional int32 port = 2
message
config.proto:443Common mail template variables.
Used in:
optional string sender_address = 1
optional string site_name = 2
optional string sender_name = 4
optional string account_recovery_url = 3
message
config.proto:476Used in:
optional bool enabled = 1
Participate in election and poll queues when master?
optional int32 master_retry_interval_ms = 2
How often to try to become master when not.
optional int32 master_lock_expiry_ms = 3
Milliseconds after which the master lock should expire if not re-upped.
optional int32 poll_period_ms = 4
How often to run the polling script as master.
optional int32 error_retry_ms = 5
If the polling script fails, how long to back off.
message
config.proto:1038optional int32 http_port = 1
Port to listen on for HTTP requests.
optional string data_dir = 3
Directory containing templates and include files.
optional string static_dir = 4
Directory containing static content.
optional string geoip_dir = 6
Where to find GeoIP.dat
optional string msg_dir = 7
Where to load localization resources.
optional string session_dir = 8
Where to persist sessions.
optional desync_storage = 11
Where desyncs are stored.
optional crash_storage = 12
Where crash information is stored.
optional backend_config = 13
Where to reach backend API servers.
optional int32 poll_interval_sec = 21
How often to run statistical queries in seconds.
optional int32 session_count_max_age_sec = 31
Time cut-off for considering a session active.
optional int32 session_result_limit = 32
Max # of results to pull from the recent session table.
optional int32 lobby_result_limit = 41
Max # of lobbies to pull from active lobbies.
optional int32 active_match_result_limit = 42
Max # of active matches to retrieve.
message
match.proto:74Used in:
optional int64 account_id = 1
optional string handle = 2
optional int64 create_time_unix = 3
optional int64 modify_time_unix = 4
optional server_stats = 10
optional player_stats = 11
repeated rating = 20
message
match.proto:89Used in:
optional tbmatch.MatchType type = 1
optional double rating = 2
optional double deviation = 3
optional double volatility = 4
optional double session_rating = 5
optional int64 last_rating_time_unix = 10
message
match.proto:80Used in:
optional int32 attempts = 1
optional int32 complete = 2
optional int32 disconnects = 3
message
config.proto:19Used in: ,
optional int32 proposal_ttl = 1
Time to live for proposal keys in seconds.
optional int32 queue_ticket_ttl = 2
Time to live for queue tickets.
optional int32 select_size = 3
How many users to consider at once from top and bottom of time queue.
optional double echelon_dist_min = 4
Control how much echelon may differ to qualify.
optional double echelon_dist_max = 5
optional double echelon_dist_per_sec = 6
optional double echelon_score_coeff = 7
optional double echelon_dist_normalized_min = 36
optional double echelon_dist_normalized_max = 37
optional double point_dist_min = 8
Control how much total rank points may differ to qualify.
optional double point_dist_max = 9
optional double point_dist_per_sec = 10
optional double point_score_coeff = 11
optional double point_dist_normalized_min = 38
optional double point_dist_normalized_max = 39
optional double last_opp_exclude_time = 12
How long to prevent 2 players from repeating the same match-up.
optional double last_opp_timeout = 13
How long to remember the last opponent.
optional double cross_continent_exclude_time = 14
How long to wait before matching to a player on another continent.
optional double ping_score_min = 15
Ping score minimum and increase with wait time.
optional double ping_score_max = 16
optional double ping_score_per_sec = 17
optional double ping_score_coeff = 18
optional double ping_score_normalized_min = 30
optional double ping_score_normalized_max = 31
optional double geo_dist_min = 19
Geo distance minimum and increase with wait time.
optional double geo_dist_max = 20
25,000km should be further than any possible distance between two points on earth
optional double geo_dist_per_sec = 21
200 km per second gets from LA to NY in 20 seconds, covers the world in 2 mins
optional double geo_score_coeff = 22
optional double geo_dist_normalized_min = 32
optional double geo_dist_normalized_max = 33
optional double rating_dist_min = 23
Rating distance minimum and increase with wait time.
optional double rating_dist_per_sec = 25
optional double rating_score_coeff = 26
optional double rating_dist_normalized_min = 34
optional double rating_dist_normalized_max = 35
optional int32 maintenance_mode = 28
0==normal, 1==in maintenance mode: no one enters queue, message about server maintenance
optional double active_match_timeout = 29
Time after which old active matches are forcibly removed.
optional int32 wait_timeout_sec = 40
How long to wait in the queue before timing out.
optional double __deprecated_rating_dist_max = 24
Unused - rating dist keeps climbing forever
message
config.proto:676Behaviors of the Matching methods.
Used in:
optional int32 match_ready_timeout_ms = 2
How long to wait for an opponent to be ready to continue a match.
optional rank = 7
How to award players with the outcome of a match.
optional int32 max_recent_results = 8
Max recent match results to return from GetRecentMatches.
optional float max_packet_loss_ratio = 21
If we lost more than this percentage of packets during ping test, advise the user of network issues and don't record the result for matchmaking.
optional int32 desync_report_max_drift = 30
Max number of seconds between each player's desync report to qualify.
optional rating_config = 50
How to perform perform Glicko2 rating system updates.
optional float unrated_glicko_rating = 60
Glicko rating to assign to players with zero games played. Glicko ratings still assume 1500.
repeated float default_glicko_rating = 61
Glicko rating to assign to players with zero games played depending on their SkillEstimateType. SkillEstimateType acts as the index into the array.
optional float session_rating_adjust_coefficient = 65
Max portion of rating difference to adjust for win/loss, scaled by deviation.
optional int32 lua_config_cache_sec = 70
How long, in seconds, to re-use the last read values from lua config objects.
optional bool strict_game_sessions = 80
Require that only one game may be played at once, only one random match queue can be pending at a time, and cannot enqueue while in a custom lobby.
optional int32 __deprecated_get_ranked_timeout_ms = 1
deprecated
moved to lua config
optional bool __deprecated_provide_local_fsm = 3
optional string __deprecated_replay_path = 4
optional int32 __deprecated_match_lifetime_sec = 6
moved to lua config
optional int32 __deprecated_select_size = 9
moved to lua config
optional string __deprecated_desync_report_path = 5
optional int32 __ping_test_lifetime_sec = 20
optional int32 __deprecated_games_to_win = 40
message
config.proto:94Used in: ,
optional int32 ping_table_ttl = 1
Time to live for the ping table if we fail to clean up session.
optional int32 blacklist_ttl = 2
Time to live for the blacklist if we fail to clean up session.
message
stats.proto:45Used in:
optional string char_type = 1
Char type vs. opponent type.
optional string versus_type = 2
optional uint32 wins = 20
optional uint32 total = 21
message
config.proto:425Used in: ,
optional string vars_uri = 1
URI to access export variables.
optional string health_uri = 2
repeated string vars_allow_net = 3
List of allowed subnets in CIDR notation for vars_uri, desyncz_uri, appconfz_uri No entries allows access from any host.
repeated string health_allow_net = 4
Separate allowed subnets for health_uri.
optional string appconfz_uri = 21
Where to serve the loaded appconfig. Empty means don't serve.
message
shop.proto:11Optional restrictions for an order search.
Used in:
optional int64 account_id = 1
If set, restrict by owning account.
optional tbmatch.OrderStatus order_status = 2
If set, restrict by specific order status.
optional modify_time = 3
Restrict time range for last modify time.
optional min_total_amount = 5
Total amount range.
optional max_total_amount = 6
optional bool use_account_balance = 10
If set, orders that use account balance (or not).
optional bill_last_name = 11
Match billing fields.
optional bill_city = 12
optional bill_region = 13
optional string bill_country = 14
Limit to country.
message
config.proto:735How to interact with Authorize.Net API.
Used in:
optional int32 timeout_ms = 1
Amount of time to wait for calls before giving up.
optional string currency = 2
An Authorize.Net account works in a single currency type that is associated with the merchant account. Use this currency to format and verify input amounts. If none is given, uses the default system currency in AppConfig.
optional bool test_mode = 3
Whether to use transactionSettings/testRequest=TRUE. This is for phase 2 testing, connecting to the production API endpoint, but still submitting test requests.
optional PaymentConfig.Validation val_mode = 4
optional string direct_response_delimiter = 5
Character delimiting fields in APIs that return a "direct response". Authorize.Net sets this to comma by default, but we choose pipe and disallow pipe in most fields.
How to perform validation of payment profiles on creation and update. Maps to validationMode parameter of the CIM API. TEST and LIVE will generate e-mails, but only LIVE will reach the payment processor.
Used in:
NONE = 1
TEST = 2
LIVE = 3
message
config.proto:402Configuration for talking to payment gateway (Authorize.Net).
Used in:
optional string api_url = 1
URL where the API can be reached.
optional string api_login_id = 2
API Login ID.
optional string transaction_key = 3
Transaction Key.
message
config.proto:414How to talk to the Portal service via Redis.
Used in:
optional string request_queue = 1
List to enqueue (RPUSH) portal requests.
optional string report_queue = 2
List to consume (BLPOP) portal closure reports.
optional int32 response_timeout_ms = 3
Time to wait for response from a portal request.
message
match.proto:7Used in:
optional int64 account_id = 1
optional string handle = 2
optional string build_version = 3
optional network = 10
optional character = 11
optional double wait_time = 20
optional double rating = 21
optional int64 last_opp_id = 23
optional string last_opp_handle = 24
optional string continent_code = 25
optional double latitude = 26
optional double longitude = 27
optional int32 echelon = 30
optional int32 tier = 31
optional int32 points = 32
message
config.proto:377How to expose RPC methods.
Used in:
optional int32 http_port = 1
HTTP port to bind to.
optional string rpc_uri = 2
URI prefix to expose the tbmatch API.
optional session_key = 3
The 64-byte session key.
optional int32 session_timeout_secs = 4
How long before an idle session is discarded with no activity at all.
optional int32 session_active_window_secs = 5
Time window to consider "active" sessions, e.g. those invoking methods other than GetEvent.
optional int64 max_request_size = 6
Max content size of requests, to prevent denial of service
optional string json_log_path = 10
File to log JSON-format RPC records.
message
config.proto:642Used in:
optional player_progress = 1
optional char_progress = 2
optional echelon_config = 3
Define the ranking echelons.
message
stats.proto:54Used in:
optional int32 rating_cap = 1
Max Glicko2 rating for these matchups.
repeated matchup = 2
message
match.proto:47Used in: ,
optional int64 match_id = 1
optional int64 start_time_unix = 2
optional double duration_sec = 3
optional bool rated = 4
optional string build_version = 5
optional string log = 6
optional bool abandoned = 7
repeated player = 10
repeated game = 20
message
match.proto:65Used in:
optional game = 1
optional int32 win_slot = 2
optional int64 start_time_unix = 3
optional double duration_sec = 4
message
match.proto:56Used in:
optional int64 account_id = 1
optional string handle = 2
optional string game_char = 3
optional bool winner = 4
optional bool disconnect = 5
message
config.proto:320Used in: ,
optional string host = 1
optional int32 port = 2
optional string password = 3
optional int32 max_idle = 4
optional int32 database = 5
Switch to a non-default database index.
optional int32 connect_timeout_ms = 10
How long to wait for a new Redis connection in milliseconds.
optional int32 read_timeout_ms = 11
Read timeout in milliseconds. 0 = infinite.
optional int32 write_timeout_ms = 12
optional string lua_path = 13
Path containing Lua script files to load in Redis.
repeated string lua_include = 14
Extra Lua include search paths.
message
account.proto:170Used in:
optional int32 code_count = 1
How many codes to generate and include in the mail.
optional int32 access_flags = 2
Access flags the codes will bestow.
Used in:
ALPHA_ACCESS = 1
"Welcome to the Rising Thunder alpha!"
FRIEND_CODES = 2
Access codes to give out.
message
config.proto:503Server run-time config file. Tells this server how to launch and resolve service dependencies. May contain some credentials.
optional db_config = 1
optional rpc_config = 2
optional redis_config = 3
optional mail = 4
optional payment_creds = 5
optional portal_client = 6
optional match_maker = 7
optional monitor_config = 10
optional desync_storage = 11
optional crash_storage = 12
optional string stackwalk_binary_path = 13
optional match_log_storage = 14
optional string geolite_database_file = 20
optional google = 30
How to reach and authenticate to all Google APIs.
optional string bigquery_dataset = 31
optional string bigquery_prefix = 32
optional int32 go_max_procs = 40
Number of cores Go runtime should use.
optional bool portal_sim_enabled = 61
optional bool admin_server = 70
Enable admin RPC services.
optional admin_server_config = 71
message
config.proto:847Flags to provide (mainly) backwards compatibility during server rollouts.
Used in:
optional bool secure_portal_udp_traffic = 2
Provide hashing secret for clients, and check signatures of incoming UDP packets.
optional bool __deprecated_auto_resume_get_match = 1
Search for a ticket to get back into queue at an old spot even when using the GetMatch rpc. Purpose: backwards compatibility while waiting for client build to use ResumeGetMatch for auto-requeueing
message
stats.proto:19Used in:
optional int64 account_id = 1
optional string handle = 2
optional string email = 3
optional string build_version = 4
optional int64 start_time_unix = 5
optional int64 last_active_time_unix = 6
optional string remote_ip = 7
optional int32 type = 8
message
config.proto:369Used in: ,
optional string current = 1
Base64 encoded session key for signing new cookies.
optional string previous = 2
Base64 encoded alternate encoded key signature to accept.
message
config.proto:806Configuration for online store behaviors, limits, etc.
Used in:
optional payment = 1
optional currency = 2
optional int32 max_order_search_result = 10
Max number of orders to return from SearchPurchaseOrders.
optional int32 order_history_page_size = 11
Max number of results returned from GetAccountOrderHistory.
optional int32 max_balance_history_days = 12
Max number of days you can view balance history over.
message
report.proto:20optional string symbol_path = 1
The path on gcs
optional string app_name = 2
optional string build_version = 3
optional string symbol_directory = 4
The directory minidump_stackwalk will look for the symbol file in, retrieved from the first line of the sym file
message
stats.proto:12Used in:
optional tbrpc.Access role = 1
optional int64 count = 2
message
account.proto:21How to match a user search.
Used in:
optional email = 1
optional handle = 2
optional given_name = 3
optional family_name = 4
optional string country_code = 5
optional create_time = 10
optional modify_time = 11
optional last_login_time = 12
message
account.proto:35How to order a user search.
Used in:
optional UserSort.SortBy first = 1
optional UserSort.SortBy second = 2
optional bool descending = 3
Used in:
ACCOUNT_ID = 1
EMAIL = 2
HANDLE = 3
GIVEN_NAME = 4
FAMILY_NAME = 5
CREATE_TIME = 6
MODIFY_TIME = 7
LAST_LOGIN_TIME = 8
message
config.proto:981Used in:
optional string client_id = 1
optional string secret = 2
optional int32 max_age_secs = 3
optional string unauth_role = 4
Role for users with 0 forum access otherwise.
optional string bless_email_suffix = 10
Email suffix that enables the "blessed" role
optional string bless_role = 11
Role that is bestowed