Leaderboards

From K.R. Engineering Support Wiki
Jump to: navigation, search

Leaderboards

K.R. Engineering games that are connected to Gaming.SL Live and have a scoring system as part of their normal gameplay will have Top Scores leaderboards included with them. All games will have Top Winners leaderboards included even if they have no scoring mechanic, as these simply show the number of games won. There may also be Top Ranked leaderboards on some games that shows the best ranked players for a particular game.

These devices allow you to view the top leaderboards for the game with varying levels of resolution.

External API

All of the types of Leaderboards default to having their External API disabled. If you turn this on, the leaderboards will use extra sim resources, but there are some cool benefits.

Leaderboards will auto-refresh themselves after a game ends with the External API turned on, otherwise they will refresh at set intervals throughout the day.

With External API turned on, leaderboards can optionally auto-switch between the game they are showing based on what your game rezzer is doing. If you have a game rezzer in the region, AND you have External API enabled on your leaderboard, AND the leaderboard is unlocked, AND the leaderboard is not showing scores only for a specific license, then the leaderboard will switch games automatically when the rezzer loads a new game. If you are playing Greedy, the leaderboards will show Greedy scores/ranks/wins. If you then unload Greedy and load Simopolis instead, the boards will switch to showing Simopolis scores/ranks/wins.

Top Scores

Click to download high-res template.

Top Scores boards display the current top scores for the game. Depending on the game, this may either be the lowest scores (e.g. Aught) or highest scores (e.g. Greedy Greedy).

Top Scores boards come in a "low prim" and "high prim" design. They both have exactly the same features, but the low-prim design displays information as floating text. The high-prim design displays information as letters on a prim face.

You can touch either version for an option/admin menu. This menu is only available to the owner of the Top Scores board.

Top Scores Option Menu

  • Cancel: This button does nothing except close the menu.
  • Help: The leaderboard will give you a notecard full of helpful information about itself.
  • Refresh: The leaderboards will refresh the information they show every 12 hours, or immediately when a nearby game is completed if ExtAPI is enabled. Using this button, you can force a refresh immediately, whenever you want.
  • Change: Change the game type that the leaderboard is showing. This lets you switch between, for example, Greedy Greedy and Simopolis.
  • Lock: Prevent the leaderboard from automatically changing game types when rezzers in the region load a new game.
  • Unlock: Allow the leaderboard to automatically changing game types when rezzers in the region load a new game.
  • ExtAPI ON: Enable the leaderboard to listen to API calls from nearby games. This defaults to OFF to reduce sim resource usage (listeners). ExtAPI will also neeed to be enabled on the game for this to work.
  • ExtAPI OFF: Disable the leaderboard from listening to API calls from games. Reduces sim resource usage.
  • Reset: This will reset all information on the leaderboard. (In practice, at least. What this actually does is causes the leaderboard to only show games finished after the time you reset it.)
  • Parcel Only: This will narrow the information on the leaderboard to only showing games that were completed on the same parcel that the leaderboard occupies. It is based off of the parcel's UUID, so even if the parcel name changes it should still load the correct scores. If you chop up a parcel then the parcel UUID may change.
  • Regional: This will set the leaderboard to show information on all games completed in the same region as the leaderboard, regardless of parcel lines.
  • Unique OFF: By default, the leaderboard will only show one entry per player, their highest score.
  • Unique ON: This will make the leaderboard show the "true" top scores for a game, which may include the same player more than once if they occupy multiple slots.
  • Solo OFF: Tells the leaderboard to ignore games where only 1 player was playing when it was completed.
  • Solo ON: Tells the leaderboard to show all games, even if only a single player was playing when they were completed.
  • Brand: Although the leaderboards are modifiable, many people are not comfortable with editing prims. This option allows them to place a logo or other graphic on the leaderboard without having to use the prim editor interface.
  • One Game: This option allows you to focus the leaderboard on a specific game license, rather than showing scores for a region or parcel. To use this feature, you will need to provide the leaderboard with the Gaming.SL License ID for the game you wish it to track. This is separate from the game's UUID or "key." The key for your table can be found by pressing the "Key" button in the admin menu, but this is not what the leaderboard needs. UUIDs (or Keys) in Second Life change every time you rez the table, which makes it unusable for tracking information about a specific game. Instead, the game is given a permanent and unique ID by Gaming.SL that stays the same between each rez. To find this permanent ID, you can touch the Gaming.SL logo on the table, and choose the "G.SL Info" button. Using the One Game feature will automatically lock the leaderboard from changing game types.
  • All Games: This reverts the leaderboard back to showing information for all games on the parcel/region.
  • One Rezzer: This option allows you to specify a specific rezzer (or "game system") that the leaderboard will listen to for the purposes of changing the game it is displaying.
  • All Rezzers: Clear the "One Rezzer" option.

Top Winners

Click to download high-res template.

Top Winners boards display the current top wins for the game. Unlike top scores, these are not specific high scores, but rather cumulative number of wins. In other words, who has won the most number of games.

Top Winners boards come in a "low prim" and "high prim" design. They both have exactly the same features, but the low-prim design displays information as floating text. The high-prim design displays information as letters on a prim face.

You can touch either version for an option/admin menu. This menu is only available to the owner of the Top Winners board.

Top Winners Option Menu

  • Cancel: This button does nothing except close the menu.
  • Help: The leaderboard will give you a notecard full of helpful information about itself.
  • Refresh: The leaderboards will refresh the information they show every 12 hours, or immediately when a nearby game is completed if ExtAPI is enabled. Using this button, you can force a refresh immediately, whenever you want.
  • Change: Change the game type that the leaderboard is showing. This lets you switch between, for example, Greedy Greedy and Simopolis.
  • Lock: Prevent the leaderboard from automatically changing game types when rezzers in the region load a new game.
  • Unlock: Allow the leaderboard to automatically changing game types when rezzers in the region load a new game.
  • ExtAPI ON: Enable the leaderboard to listen to API calls from nearby games. This defaults to OFF to reduce sim resource usage (listeners). ExtAPI will also neeed to be enabled on the game for this to work.
  • ExtAPI OFF: Disable the leaderboard from listening to API calls from games. Reduces sim resource usage.
  • Parcel Only: This will narrow the information on the leaderboard to only showing games that were completed on the same parcel that the leaderboard occupies. It is based off of the parcel's UUID, so even if the parcel name changes it should still load the correct scores. If you chop up a parcel then the parcel UUID may change.
  • Regional: This will set the leaderboard to show information on all games completed in the same region as the leaderboard, regardless of parcel lines.
  • Solo OFF: Tells the leaderboard to ignore games where only 1 player was playing when it was completed.
  • Solo ON: Tells the leaderboard to show all games, even if only a single player was playing when they were completed.
  • Brand: Although the leaderboards are modifiable, many people are not comfortable with editing prims. This option allows them to place a logo or other graphic on the leaderboard without having to use the prim editor interface.
  • One Game: This option allows you to focus the leaderboard on a specific game license, rather than showing scores for a region or parcel. To use this feature, you will need to provide the leaderboard with the Gaming.SL License ID for the game you wish it to track. This is separate from the game's UUID or "key." The key for your table can be found by pressing the "Key" button in the admin menu, but this is not what the leaderboard needs. UUIDs (or Keys) in Second Life change every time you rez the table, which makes it unusable for tracking information about a specific game. Instead, the game is given a permanent and unique ID by Gaming.SL that stays the same between each rez. To find this permanent ID, you can touch the Gaming.SL logo on the table, and choose the "G.SL Info" button. Using the One Game feature will automatically lock the leaderboard from changing game types.
  • All Games: This reverts the leaderboard back to showing information for all games on the parcel/region.
  • One Rezzer: This option allows you to specify a specific rezzer (or "game system") that the leaderboard will listen to for the purposes of changing the game it is displaying.
  • All Rezzers: Clear the "One Rezzer" option.

Top Ranked

Click to download high-res template.

Top Ranked boards display the current top ranked players for the game. Top Ranked players are players who are consistently playing the game at the highest level of difficulty against opponents who are similarly skilled.

Top Ranked boards come in a "low prim" and "high prim" design. They both have exactly the same features, but the low-prim design displays information as floating text. The high-prim design displays information as letters on a prim face.

You can touch either version for an option/admin menu. This menu is only available to the owner of the Top Ranked board.

Top Ranked Option Menu

  • Cancel: This button does nothing except close the menu.
  • Help: The leaderboard will give you a notecard full of helpful information about itself.
  • Refresh: The leaderboards will refresh the information they show every 12 hours, or immediately when a nearby game is completed if ExtAPI is enabled. Using this button, you can force a refresh immediately, whenever you want.
  • Change: Change the game type that the leaderboard is showing. This lets you switch between, for example, Greedy Greedy and Simopolis.
  • Lock: Prevent the leaderboard from automatically changing game types when rezzers in the region load a new game.
  • Unlock: Allow the leaderboard to automatically changing game types when rezzers in the region load a new game.
  • ExtAPI ON: Enable the leaderboard to listen to API calls from nearby games. This defaults to OFF to reduce sim resource usage (listeners). ExtAPI will also neeed to be enabled on the game for this to work.
  • ExtAPI OFF: Disable the leaderboard from listening to API calls from games. Reduces sim resource usage.
  • Parcel Only: This will narrow the information on the leaderboard to only showing games that were completed on the same parcel that the leaderboard occupies. It is based off of the parcel's UUID, so even if the parcel name changes it should still load the correct scores. If you chop up a parcel then the parcel UUID may change.
  • Regional: This will set the leaderboard to show information on all games completed in the same region as the leaderboard, regardless of parcel lines.
  • Brand: Although the leaderboards are modifiable, many people are not comfortable with editing prims. This option allows them to place a logo or other graphic on the leaderboard without having to use the prim editor interface.
  • One Game: This option allows you to focus the leaderboard on a specific game license, rather than showing scores for a region or parcel. To use this feature, you will need to provide the leaderboard with the Gaming.SL License ID for the game you wish it to track. This is separate from the game's UUID or "key." The key for your table can be found by pressing the "Key" button in the admin menu, but this is not what the leaderboard needs. UUIDs (or Keys) in Second Life change every time you rez the table, which makes it unusable for tracking information about a specific game. Instead, the game is given a permanent and unique ID by Gaming.SL that stays the same between each rez. To find this permanent ID, you can touch the Gaming.SL logo on the table, and choose the "G.SL Info" button. Using the One Game feature will automatically lock the leaderboard from changing game types.
  • All Games: This reverts the leaderboard back to showing information for all games on the parcel/region.
  • One Rezzer: This option allows you to specify a specific rezzer (or "game system") that the leaderboard will listen to for the purposes of changing the game it is displaying.
  • All Rezzers: Clear the "One Rezzer" option.