View source for Canoga

[[Image:Canoga_Logo_Maybe_Small.png|frame|Canoga game logo.]]

= Canoga A.K.A. Shut the Box =

== Introduction ==
Canoga is a simple, relatively quick game for 2 to 8 players. Players must compete to get the lowest possible score each round by elimination of playing pieces. The first player to win 4 accumulated rounds is the winner of the game! Can also be played to 7 wins.

== Also Known As ==
Canoga is known by many other names, including Blitz, Bakarat, Shut The Box, Klackers, Batten Down the Hatches, Kingoball, Trictrac, Cut Throat.

{{:House Rules}}

{{:Getting Started}}

{{:Purchasing}}

{{:Joining The Game}}

== Game Play ==
The first player to be seated will play first, regardless of their player number. Once they have completed their play, the turn will advance counter-clockwise around the table. Once play comes back to the first player, the 'round' is finished and a winner is declared.

Players start their turn by clicking on the dice to roll.  They must then select 1 or 2 playing pieces in the center of the board that have not already been used, and which add up to the same amount as the dice. To select pieces, simply click on the number you want to use. To unselect it, simply click it again.

Example: You roll a 3 and 5, which adds up to 8. You may select either (3 and 5), (6 and 2), (7 and 1), or (8) by itself. All of these combinations add up to 8, and are therefore legal. They may not all be possible, however, if you have used some of the numbers from previous rolls.

Once you have made your selection, you may roll again by clicking the dice. Your selection from the previous roll will turn solid, and you are presented with a new number on the dice to try and eliminate from the pieces. If you eliminate all of the pieces, or if you roll a number that there are no valid combinations for, then your turn is over, and your score is the sum of all the pieces you failed to eliminate.

Once all players have taken a turn, the player with the lowest score wins the round, and the next round begins.

Once a player has accumulated 4 total wins (or 7, if 'Long Game' is enabled) then they are declared the winner of the game.

== Variants ==
Game variants can be enabled or disabled from the game's Administration menu, or by touching the matching button on the game surface.

=== Tug of War ===

In Tug of War mode, players will be competing against each other. One player will be required to move all tokens UP to score, while the next player will be required to move all tokens DOWN. This means players are constantly trying to undo what the previous player was doing, and as a result you may be starting your turn with some tokens already "used up."

{{:Bug Fixes & Upgrades}}

{{:Changing Theme}}

{{:Player Experience}}

{{:Gaming.SL Live Integration}}

{{:Game Rezzer System}}

== Administration ==
To access the game's administrative menu, simply click and hold your mouse button down on any part of it for 2 seconds and a menu will pop up on your screen displaying current settings and providing options to change them. (In slow simulators, this may take slighter longer than 2 seconds, just hold the mouse button down until you see a menu.)

It's likely that you may accidentally open the THEME/REZZER's administrative menu instead of the GAME's administrative menu, depending on where you clicked. This is okay! If you are in the THEME/REZZER's admin menu, you can switch directly over to the GAME's admin menu by pressing the "Game ↗" button. Likewise if you open the GAME menu by mistake, and wish to switch over to the THEME/REZZER menu, you can simply press the "↙ Rezzer" button.

Some elements of the administration menu are accessible only by the owner, while others can be accessed by anyone who is considered an administrative user, either explicitly added or implicitly through the Group Admin feature.

There are too many options to fit in a standard dialog window, so the window has been divided into pages. You can use the <<< and >>> buttons at the bottom of the admin menu to change which page of options you are currently viewing. If you don't see the option you want then it is on another page!

=== Rezzer Options ===

Many options that were formerly in the game admin menu have been moved to the rezzer admin menu! These are options that are game-independent, such as admin users, branding, sound volume, and updating. These options are now set on the rezzer/theme and apply automatically to whatever game is being played on that rezzer. For details on accessing the rezzer admin menu and what options are in it, please see the [[#Game Rezzer System|Game Rezzer System]] section.

=== Owner-Only Options ===

* Indicators: A menu for changing the color of the turn indicator lights on the game board.

* Color: An alternate way to access the color/theme menu for the table. This is the same as pressing the Color button on the table top.

=== Administrative User Options ===

* ↙ Rezzer: This button will directly open the rezzer's administrative menu instead of the game's menu.

* Players: Access the player management menu to skip or evict players from the game.

* Abandoned: Select this button to change the number of seconds the table waits to reset an abandoned game after all players have left.

* Timeout: Select this button to change the number of seconds the table waits for idle players to begin their turn. If they don't roll before the timeout occurs, the game will skip them for this round.

* Quiet: Enable quiet mode, reducing the amount of chatter that the game will send to local chat.

* Chatty: Disable quiet mode.

* Limit Join: When on limit join, no new players may join after the first roll has been made and anyone who leaves the game has five minutes to return before the game considers them gone. When free player join is off and all players have left the game will automatically reset.
 
* Free Join: Turns the game back to free join mode, anyone may join at any point during the game. The game will skip abandoned seats and automatically give any newcomers the chance to roll on the next round. 

* Evict On: Turn on evicting of players who are idle on their turn, as dictated by the Timeout function above.

* Evict Off: Turn off evicting of players who are idle on their turn. Players who are idle will be skipped instead.

* Long Game: Select this option to change the winning criteria to 7 accumulated wins instead of 4.
 
* Short Game: Select this option to change the winning criteria to 4 accumulated wins, the default.

{{:Branding}}

{{:Leaderboards}}

{{:Betting}}

== Frequently Asked Questions (FAQ) ==

=== Canoga ===

==== [[Image:Wiki_FAQ_Q_Icon.png]] Do you offer upgrades on my version of Canoga? ====
:* Yes, upgrades are available for ALL versions.

==== [[Image:Wiki_FAQ_Q_Icon.png]] How do I get my table upgraded? ====
:* If your table is v2.0.0 or later, you cannot update the game directly! Instead, you should update any themes that you own. Updated themes include the latest version of all games supported by that theme.
:** Click and hold your mouse button on part of the theme for 3 seconds until a menu appears, click 'Update.'
:** If you don't see the "Update" button, try pressing the <<< button until you see it. The admin menu has multiple pages.
:** If you cannot find an "Update" button, you may have opened the GAME's admin menu instead of the THEME's Admin menu. You can switch between these with the "Game ?" and "? Rezzer" buttons.
:** A new, updated theme should be sent to you from our update servers within a few minutes. If it's not, please try again. If you are unable to get an update, please contact us for assistance.
:* If your table is older than v2.0.0, click and hold your mouse button on part of the table for 3 seconds until a menu appears, click 'Update.' If you do not see an "Update" button then you are probably looking at the wrong page. Click the <<< or >>> buttons to change pages and see more buttons.
:** If you don't see the "Update" button, try pressing the <<< button until you see it. The admin menu has multiple pages.
:** Your table will disappear (delete itself) and you will receive a new table. Delivery of new table may take up to 5 minutes.

{{:Games FAQ}}

== Changelog ==

* Version 1.0 [October 2008]:
** Initial release.

* Version 1.01 [October 2008]:
** Fixed a bug where players could choose pieces before they rolled on their turn. This caused some seemingly inexplicable glitches after they did roll.
 
* Version 1.02 [November 2008]:
** Added option to admin menu to switch table between old style and new style. Purely aesthetic, no gameplay changes. Prim count unchanged.

* Version 1.03 [February 2009]:
** Fixed a bug where the camera perspective of players was not properly updated when one player stood up. This is a compensation for a bug in the Second Life camera system that incorrectly affects all seated avatars' cameras.

* Version 1.04 [June 2010]:
** Drastic script reduction and performance improvements thanks to new scripting functions added to Second Life by server version 1.38. Game now uses about half of the script time of previous versions when idle.
** Moved Branding menu to Admin Menu to avoid customer support problems. Admin menu now appears regardless of where you click and hold on the table, instead of a different menu coming up on the centerboard.
** By popular demand, added an option to toggle phantom on/off on the table.
** Prize Server API now sends an update whenever a player's score changes.
** Added a beautiful gothic black wood option by popular request.

* Version 1.1 [June 2012]:
** Decreased prim count on table from 40 to 32, and script count from 27 to 21.
** Created Pocket Canoga that is 12 prims instead of 32, and 13 scripts instead of 21.
** Admin users can now access the administrative menu, but do not have all the options that owners do.
** Added new Group Admin option, defaults to off, allowing anyone in the same group as the table to be considered admins without having to be added manually.
** Updated to support the Display Names feature on newer Second Life viewers.
** Game now has OPTIONAL internal prize server with buyin and betting options that give games more control over how these events occur. External prize servers are still fully functional and now receive more information than before. Internal prize server now responsible for communicating with external prize servers. External API can be enabled/disabled independently of internal prize server features.
** 5 new poses in each seat.
** Compensated for a bug in SL where when you sit down, SL sends random keystrokes to the game, even if you pressed nothing. This was relatively harmless, but resulted in the animation menu randomly coming up, or your camera view not defaulting to birdseye when it should.
** No longer required to reset between games, displacing all the players. Once a game has ended, simply press ROLL again to start a new game with everyone seated.
** Changed the "tintable" branding preset to something less hideous.
** Added option to put table into Group Play mode, where only members of the same group as the table are allowed to play it. Must have group tag active to work.
** Game owner now gets notified when they play the game if there are any new News posts on Gaming.SL about their specific game.
** Added support for addons to be installed into the game after purchase.
** Old Style/New Style buttons in admin menu considered deprecated, and removed. Theme switching occurs in the color menu now as part of a brand new theme engine.
** Used new Gaming.SL addon support to create installable themes for the game that are universal for all compatible tables (buy a theme once, use it with all compatible tables).
** Added toggle button for fullbright in branding menu.
** Slightly increased the distance of the centerboard off of the table to make the games more resistant to high altitude rounding errors in drawing geometry.
** Added an option to have players evicted rather than skipped if they don't take their turn in a specified amount of time. This should help with Pocket games especially, for when people join and then wander off and stop playing.
** Updated to support the new llRegionSayTo function that Linden Lab recently added. This allows for less spam when playing, since "error" messages (such as invalid moves) are sent only to the current player, rather than having to be whispered to everyone at the table.

* Version 1.11 [November 2013]:
** Cleaned up additional instances of table not defaulting back to Legacy Names when Display Names return ???. (Internal prize server)
** Opt Out button in Gaming.SL menu is now Opt Out|In for clarity. Also spawns an ARE YOU SURE confirmation dialog with more information.
** Added ambient sound support to Gaming.SL addon themes. When a theme has an active sound, a Sound ON|OFF button appears in the Modify submenu.
** Table owners can now set the color and/or texture of seats individually on their table. This is retroactive for all themes.
** Table owners can now set the color and/or texture of other parts of the table more discretely where they were not able to before, such as cushions/lights/other accents.
** Changed theme menu to (almost) always have a Close button present, instead of having to click Back multiple times to return to the parent menu before closing. More user friendly.
** Pocket games only: Frame OFF|ON buttons moved to Modify submenu.
** Switched both Table and Pocket games to Convex Hull physics, reducing table to 28 prims and Pocket to 9 prims.

* Version 1.12 [July 2014]:
** Fixed a bug where the game can ask for buyins twice when they are enabled on the internal prize server.

* Version 1.2 [August 2014]:
** Table reduced from 28 PE to 24 PE on default theme.
** Color button added in Admin Menu that brings up the same menu as pressing Color on the table top.
** Chairs should no longer get messed up if you rotate the table while it is in the process of changing themes.
** Theme engine updated to allow themes to adjust the physics shape of individual pieces, on a per-theme basis. This may cause minor fluctuations in prim count when changing themes.
** Script count reduced by 7 on the Table version, now only 14 scripts for entire game.
** ALL PRIZE FUNCTIONS HAVE BEEN REMOVED to comply with the new [[Skill Gaming]] policy from Linden Lab. As a result, table no longer requests debit permissions on rez.
** Changed the way games fetch addons from the server to reduce the number of HTTP requests being made, since LL is throttling them.
** Added new option for themes to specify whether they are normal sitting, ground sitting or laying down themes, and added 4 new poses.
** Updated Prize Server and Jackpot Prize Server for the new Skill Gaming Policy. Advanced Prize Server is not legal under the new policy and will not be included.
** Game will now attempt to restore previous settings on new table from before an update.
** Camera and poses no longer controlled by keyboard, now accessed through "POSE" button on table top. Table no longer takes over your controls at all.

* Version 1.3 [January 2015]:
** Added support for specular and normal maps to theme engine. Also includes alpha mode support.
** Themes that include specular information will now use this for Shiny On/Off options in themes, instead of old style shiny.
** New Theme Engine is backwards compatible with non-materials addons. Material addons are not backwards compatible with old tables.
** Added the ability for table owners to save new default camera settings from the Pose/Camera menus.

* Version 2.0.0 [June 2018]
** Changed to a new multipoint versioning system, so industry standard!
** Changed permissions from no-copy/transfer to copy/no-transfer!
** Converted from a Sculpted prim addon theme system to a Mesh themed game rezzer system.
** New Mesh themes mean that themes can have custom scripting and unique animations in each theme.
** Games are no longer 'objects' and instead are now 'licenses' that work on any compatible themed game rezzer.
** Older 'object' based games can be converted to licenses for free by using the migration system in the store.
** Switched from old Gaming.SL website/backend to entirely new Gaming.SL LIVE website/backend.
** Addons, achievements, games, and scores can be migrated from old Gaming.SL to new Gaming.SL Live if desired.
** Entirely new External API system for external/third-party game addons. External API defaults to OFF.
** Many game settings have been moved from the games to the rezzers now.
** Updating is now a function of the rezzers, not the games. Updating a rezzer updates all compatible games inside it.
** New Gaming.SL Live now allows players to log in to the website and change their profiles and view/control their purchased products.
** New redelivery system available in store and on the website, since games are copy/no-transfer permissions now.
** Games can now be made PUBLIC and will show up on the website's LIVE page. All games default to PRIVATE.
** Updated backend means that all games can have top winners boards even if they have no scoring system, and these wins no longer expire off.
** New Top Ranked system ranks how well you play against other people based on the game performance of all participants.
** Games no longer have a 'hard reset' where they eject all sitting players. Players can still be ejected from the admin menu if desired.
** Tournaments are not curently supported on Gaming.SL Live, as nobody used it on the old system. An entirely new in-world based tournament system is being planned.
** Players are not prevented from sitting down even if they are not allowed to play. They will be added on the next game instead.
** Added a new Tug Of War game mode that pits players directly against each other.

* Version 2.0.1 [July 2018]
** Fixed a bug where a table might say "Admin menu is currently in use." to people who click on the table while playing.
** Added support for external Leaderboards to lock onto specific game rezzers rather than just specific games.

* Version 2.0.2 [August 2018]
** Added the ability to access the MIGRATE system by touching the Gaming.SL logo on the game, rather than having to visit the store.

* Version 2.0.3 [September 2018]
** Fixed a bug that was preventing admins added to the rezzer from propagating correctly to the game.
** Added floating text over the table when the game is unlicensed, and also includes a helpful message for fixing it in the case of improperly shut down games.

* Version 2.0.4 [January 2019]
** Fixed a bug that could cause the admin menu to not timeout correctly.

* Version 2.0.5 [January 2020]
** Fixed long game option not properly setting the game to 7 wins.
** Changed the messaging around the licensing not being loaded to make it less scary.
** Changed it so that no matter where you click and hold, you always get the rezzer/theme menu first for consistency.