Prize Server

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

Prize Server

Basic Prize Server

What is it?

The K.R. Engineering Prize Server is an example open-source implementation of how to implement an awards system for K.R. Engineering Games.

Applicable K.R. Engineering Games will automatically attempt to communicate with any servers in the region that have the Server Module API script in them (included with this server). This allows game owners to implement high score boards, tournament counters, novelty prize awards or anything else they wish to do based on the outcome of a game. Please read the documentation in the "K.R. Engineering Prize Server (full perm)" script inside the prize server for more information. The server includes 3 examples of outcome-based awards built in and information on when these are legal to use under the Skill Gaming Policy issued by Linden Lab. K.R. Engineering & Associates can not be held responsible if you choose to use this API in a way that violates the Skill Gaming Policy or other Terms of Service.

Is this legal under the new Skill Gaming policy?

Depends! The Basic Prize server is not a complete implementation, it is merely an example script for you to expand upon for your own purposes. You can use this script in ways that do not violate the skill gaming policy (such as awarding objects, or awarding money for contests or games that did not require the player to pay in). You can also use it in ways that DO if you add more code to it, as it is open source. You are responsible for any code you add to this script being compliant with the Skill Gaming policy.

The Code

Click here to see the open-source prize server script.

Advanced Prize Server

What is it?

The Advanced Prize Server is an implementation of a complete prize server based on the K.R. Engineering Game Prize API built into K.R. Engineering Games. This has been available for some time with the basic prize server which includes both the API script as well as an open source example script for extending it to do anything you want based on game events. However, many people are not comfortable with modifying scripts, so the Advanced Prize Server is now available with a complete user interface and a variety of features built on top of the API. The Advanced server implementation is closed source, but it is built on top of the same exact API that is available in the regular prize server.

Is this legal under the new Skill Gaming policy?

No! The Advanced Prize Servers may not be used after August 1st, 2014. If you continue to use them after this date you will be in violation of the Second Life terms of service and your account may be subject to penalties, up to and including account suspension or termination. See the Skill Gaming wiki page for more information.

Configuration

Touch the advanced prize server (hereafter just 'server') to open the admin menu, owner only. Depending on which options you have enabled, you may not see all of the options discussed below.

  • Objects ON: This turns on the giving of random objects from the servers inventory as prizes to winners.
  • Objects OFF: This turns off the preceding option.
  • Fees ON: This turns on giving winners all or a portion of the pay-to-play fees the game collected as a prize.
  • Fees OFF: This turns off the preceding option.
  • Payout ON: This turns on giving an arbitrary (decided by you) cash prize to winners.
  • Payout OFF: This turns off the preceding option.
  • Betting ON: This turns on the use of the server as a 'player pot' that players can bet into during the game. All or a portion of the bets collected will be paid out to the winner.
  • Betting OFF: This turns off the preceding option.
  • Min Bet: Select this option to specify a minimum amount that players must bet at a time. If you wish to enforce a 'starting bet' for players to even play, use the Pay-To-Play option built into the games.
  • Rake: Select this option to specify what percentage of winnings (fees and betting) should be raked off for the house. House earnings don't 'go' anywhere, they simply aren't paid back out to the winner.
  • Part. ON: Require participation in betting. This is the default behaviour and effectively makes the prize server act as a 'tip jar' where you are not required to bet, but if you don't then you receive no share of the bet money if you win.
  • Part. OFF: Make participation optional. The winner will receive a share of the betting money whether or not they bet anything themselves.
  • Payout: Select this option to specify what the amount is in L$ for the arbitrary cash prize option.
  • Part. ON: Require participation in betting. This is the default behaviour and effectively makes the prize server act as a 'tip jar' where you are not required to bet, but if you don't then you receive no share of the bet money if you win.
  • Part. OFF: Make participation optional. The winner will receive a share of the betting money whether or not they bet anything themselves.
  • Min Players: Select this option to specify what the minimum number of players playing a game must be in order for the arbitrary cash prize to be paid. Defaults to 2, do not recommend setting it to 1, as players can player the game quickly and without challenge by themselves and still earn money.
  • Min Time: Select this option to specify what the minimum game duration is, in seconds, in order for the arbitrary cash prize to be paid to winners. Defaults to 5 minutes This option is to prevent players from finding friends to play a game and simply forfeit it repeatedly to earn the prize.
  • One Game: Select this option in order to restrict the prize server to giving prizes out for a single game, specified by supplying the game's object key. Betting only works if this is enabled.
  • All Games: This turns off the preceding option.

Customization

The scripts in the prize server can be copied into any other object if you wish to customize the appearance.

Jackpot Prize Server

What is it?

The Jackpot Prize Server is an implementation of a complete prize server based on the K.R. Engineering Game Prize API built into K.R. Engineering Games. This has been available for some time with the regular prize server which includes both the API script as well as an open source example script for extending it to do anything you want based on game events. However, many people are not comfortable with modifying scripts, so the Jackpot Prize Server is now available with a complete user interface and a variety of features built on top of the API. The Jackpot server implementation is closed source, but it is built on top of the same exact API that is available in the regular prize server.

No really, what is it?

The Jackpot Prize Server will track the top high scores for a given table or type of game (such as Greedy Greedy, SLopoly, etc) and after a specified number of days have elapsed (default is 1 day) then it will pay a prize to the people or persons with the highest score(s). A prize may be given for up to the top ten scores, but only required for the top 1. A variety of options are available to customize the behaviour.

Is this legal under the new Skill Gaming policy?

Yes! As long as it is used in conjunction with a table that does not accept money from players. The jackpot prize server is totally legal for awarding merit-based (high score) players with anything you like, as long as they did not have to pay any money in to the game or to you to qualify for the jackpot board.

Configuration

Touch the jackpot prize server (hereafter just 'server') to open the admin menu, owner only. Depending on which options you have enabled, you may not see all of the options discussed below.

  • Game: Change the game that this jackpot server monitors, such as Greedy Greedy or SLopoly or Pentadee.
  • Days: Adjust the interval of the jackpot payout. 1 day means a daily prize, 2 days means the cumulative high scores over the course of 48 hours will determine the jackpot, and so on. May not set lower than 1 day.
  • Target: Adjust the target score for the jackpot. If the winning score is below this target score, then it is not eligible to be entered into the jackpot. Set to 0 to disable target scoring.
  • Jackpots: Change the number and value of jackpot placings. You may have up to 10 jackpot placings by entering comma-separated prizes for each placing. For example, if you just enter 1000 then there will be 1 placing that is worth 1000 Lindens, whoever has the very highest score. If you enter 1000,500,250, there will be a 2nd Place prize for the next highest score as well, worth 500 Lindens, and a 3rd Place prize for the third highest score worth 250 Lindens.
  • Text ON: Enable hover text over the prize server. Hover text includes jackpot options and the current high scores.
  • Text OFF: Disable hover text over the prize server.
  • Unique ON: Players may only win a single placing on the jackpot. If they attain a new, higher score, then their old score will be removed and replaced by the next runner-up.
  • Unique OFF: Disables the preceding option.
  • Min Players: Select this option to specify what the minimum number of players playing a game must be in order for the arbitrary cash prize to be paid. Defaults to 2, do not recommend setting it to 1, as players can player the game quickly and without challenge by themselves and still earn money.
  • One Game: Select this option in order to restrict the prize server to giving prizes out for a single game, specified by supplying the game's object key. Betting only works if this is enabled.
  • All Games: This turns off the preceding option.

Customization

The scripts in the prize server can be copied into any other object if you wish to customize the appearance.

Disclaimer

As of the writing of this, it is a violation of the Second Life Terms of Service for the prize server to award prizes of any value (L$ or objects otherwise considered to have value) to game winners if the winner of that game had to pay a 'consideration' (pay-to-play fee) to the game in order to participate. Novelty objects or other prizes of little or no value may be given to players as prizes LEGALLY if consideration was taken. If no consideration is taken (free to play) your prize server may do whatever you wish. K.R. Engineering can not be held liable if you choose to use it in a way that violates this policy.

External Links

Template:Game Add-Ons