TheGamDevStore.com Online API

TGDSO Scoreboards

TGDSO Scoreboards

TGDSO Tournaments are Game competitions in which Players compete against each other for Best Score to occupy a Winning Position: 1st, 2nd, 3rd, 4th, etc. Player Scores are managed on Scoreboards (syn Leaderboards). Scoreboards are the foundation of Tournaments. TGDSO supports two (2) Scoreboard Formats: Linear and Tree.

Linear Scoreboards

A Linear Scoreboard is the simplest form of Scoreboard, arranging a list of Player/Teams Names, Scores, Prizes from Best to Worst order. The Linear Scoreboard’s sort direction is based on a Sort Value as in some games the lowest point value is best score (ie: Golf).

Linear Scoreboards can be set for Unique, Limited, or Unlimited Scores. Unique Linear Scoreboards maintain the single best score from a particular player. Limited Linear Scoreboards maintain a specified number of best scores from a particular player. Unlimited Linear Scoreboards maintain the best scores regardless of the player.

 

RankPlayerScorePrize(tentative)
1techlordx1000$100
2gamaster900$50
3blastradii850$25
4em2sq800 
5rpgwizkid123775 
6maulthrad700 
7C3p0_r2d2600 
8komodofufu6525 

 

Tree Scoreboards

A Tree Scoreboard is a hierarchical arrangement of Player/Teams Names, Scores, Prizes from Sub-Tournaments played during an Elimination Tournament.

A Sub-Tournament contains a minimum of two (2) Players managed with a Linear Scoreboard. The Best Scorers proceed to form a new Sub-Tournament, while the Worst Scorers are eliminated. This process continues until a single Tournament remains.

Multi-tier Bracket

Tie-Breaker Tournaments

In most Tournaments, only a single player/team is allowed to occupy a specified Winning Position. To resolve a Tie, the Primary Tournament is put on hold and Player/Teams with Best Tied Scores must compete in a Tie-breaker Tournament.

Tie-breakers Tournaments are a type of Elimination Tournament, in which Best Tied Scorers proceed to form a new Sub-tournament, while the worst Scorers are eliminated. This process continues until a single Best Scorer remains, proceeding into the Primary Tournament.

Multiple Scoreboards

Multiple Scoreboards can be created providing a Scoreboard for each Game Level, as well as a Global Linear or Tree Scoreboard. Multiple Scoreboards can be also be created to Rank players by other Statistics, such as time, kills, or cookies eaten.

Multiple Points

TGDSO Scoreboards support multiple point scoring in which more than one type of score can used be used to determine ranking on a Scoreboard.  For example, players may need to collect the highest number of Cubes and lowest number of Spheres.

Progress Scoreboards

TGDSO Contests are Game competitions in which Players complete a specified objective to occupy a Winning Position. Timing is often used to determine winning conditions, not Points Scoring. Dependent on the objective, prizes are won based achieving the objective firstly or lastly. Contests may use Scoring to Track progress. Scoreboards can be use to present Tracking.

Tiered Winning Positions/Prizes

TGDSO Contents supports a tiered Winner/prizes for 1st, 2nd, 3rd, 4th, etc Place distribution. We encourage having more winners in Contests.

Prize Types: Fixed, Progressive, Degressive

Fixed Prizes can be pre-calculated based on Prize Pool = Startup Prize Amount + (Admission Fee % x Player Slots). In a Fixed Prized Contest, when Player slots have been filled, prizes are paid out and the contest is closed.

In Progressive Prize Contests, the Player Slots are unlimited, allowing Admission Fee % to be continuously added to the Prize Pool increasing its value. The prize will continue to increase until a winner is determined. Optionally, a maximum limit the prize can increase to can be set which may or may not be advertised.

Degressive Prize is a Full Prize amount established at the start of the Contest that decreases with over time until a winner is determined. Optionally, a minimum limit the prize can decrease to can be set which may or may not be advertised.

Score Update

Scores may be updated at regular intervals, on-demand  (See Session NOTIFY Transaction) or after the end of the competition. Its recommended that Scoreboard be updated and displayed to players during game-play to further drive competition and counter anti-cheating.


GET

Returns a list of scores either for a user OR a list of high score tables for a game.

Request

JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"method":"Scoreboard_GET",   Service Transaction Method.
"params":{    
 "signature":"6e73861fd2d75a76e54b472e609eaf98",xhashPrevious Signed Authentication Token issued by TGDSO Contest Server.
 "id": 44345, integerThe id of the Scoreboard that you want to get high scores for. If left blank the scoreboards from the Scoreboard Table group will be returned.
 "limit":99, integerThe number of scores you’d like to return. The default value is 10 scores. The maximum amount of scores you can retrieve is 100.
 "game_id":1,xintegerGame ID.
 "group":"all" string 
},    
"id": 4}    

Response

JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"result": {    
 "signature":"3208fde0470719372f8313ddd5884a75",xhashSigned Authentication Token issued by TGDSO Contest Server.
 "scoreboards":[{xarrayList of Users start here
 "notprimary":0,tbdboolWhether or not this is the default high score table. High scores are submitted to the primary table by default.
 "name":"TopScorers",xstringThe developer-defined high score table name.
 "description":"The Best of the Best",xstringThe developer-defined high score table description.
 "scores":[   
 {"score":"1",xstringThe score string.
 "sort":1,xintegerThe score’s numerical sort value..
 "extradata":"",xstringAny extra data associated with the score.
 "username":"techlordx",xstringIf this is a user score, this is the display name for the user.
 "user_id":"ArcadeKomodo Developer",xstringIf this is a user score, this is the user’s ID.
 "guess":"", stringIf this is a guest score, this is the guest’s submitted name.
 "logged":"03/07/2016"}xstringReturns time the score was logged by the user..
 ]   
 }]  Additional Users objects follow.
},    
"id": 4}    
JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"result":{    
 "failure":1xintegerFailure Code 1: Authentication Failed. Incorrect Username/Password Combination.
},    
"id": 4}    

CREATE

Creates a score for a user or guest.

Request

JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"method":"Scoreboard_CREATE",   Service Transaction Method.
"params":{    
 "signature":"6e73861fd2d75a76e54b472e609eaf98",xhashPrevious Signed Authentication Token issued by TGDSO Contest Server.
 "id":99,  Scoreboard ID to submit to score to.
 "score": 4400,xintegerThis is a string value associated with the score. Example: “234 Jumps”..
 "sort":99, integerThis is a numerical sorting value associated with the score. All sorting will work off of this number. Example: “234”..
 "extradata":99  Use as this variable. Any extra data associated with the score.
},    
"id": 4}    

Response

JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"result": {    
 "signature":"3208fde0470719372f8313ddd5884a75"xhashSigned Authentication Token issued by TGDSO Contest Server.
},    
"id": 4}    
JSON-RPCParametersRequiredDatatypeDescription
{"jsonrpc":"2.0",    
"result":{    
 "failure":1xintegerFailure Code 1: Authentication Failed. Incorrect Username/Password Combination.
},    
"id": 4}    

Submit a Comment

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Pin It on Pinterest