Implement Frogger (#276)

Author: mcdemarco

locales/en/apgames.json

@@ -84,6 +84,7 @@
         "four": "A game in which four shapes in four colours are placed in a virtual grid according to four constraints. Be the last player able to place.",
         "fourinarow": "A simple game of getting four (or more) in a row with the twist: there is gravity.",
         "frames": "A simple \"get into the head of your opponent\" game where both players simultaneously select an empty cell on a Go board. The placements define a rectangle. The player with the most stones within that rectangle gets a point. Play to a certain number of points.",
+        "frogger": "A racing game for the Decktet inspired by the eponymous videogame and the classic boardgame Cartagena.  Move your frogs along a dangerous path to reach home first.",
         "furl": "Either furl up a row of your discs, or unfurl a stack. If you have a disc in your end row at the start of your turn, you win.",
         "garden": "Two wizards share a garden plot and try to harvest valuable reagents. Both are sharing the same pool of seeds. Planting a seed changes the plants around it. Form four in a row to harvest. Most harvests wins!",
         "gess": "In Gess, the 'pieces' are 3x3 patterns stones. A player can use any 3×3 portion of the board that contains at least one of their stones and none of their opponent's stones. If a 3x3 piece moves in such a way that it overlaps one or more stones (of either player), all stones that the piece moves onto are captured. Each player must maintain one piece that is a ring of eight stones around an empty square at all times. If one player is in a position where they no longer have such a ring anywhere on the board for any reason, they lose.",
@@ -235,6 +236,7 @@
         "emu": "More information on the Decktet system can be found on the [official Decktet website](https://www.decktet.com). Cards in players' hands are hidden from observers, and they are hidden from opponents until the deck is empty, at which point the players have perfect information, so the hands are revealed. Cards drawn from the discard pile are also always visible to opponents.",
         "entropy": "In this implementation, the players play two games simultaneously but with a single shared stream of randomized pieces. Each player places a piece on their *opponent's* Order board and then makes a move on their *own* Order board; players thus act as both Order and Chaos at the same time. The player with the greatest score wins! Since both players had the exact same placement choices, this provides the cleanest measure of relative skill.",
         "exxit": "Translations of the rules tend to omit certain nuances. This implementation conforms with the original French edition of the rules.\n\nBecause the board is built out as you play in irregular shapes, the hexes are labelled numerically instead of algebraically. This ensures that the labels don't change as the map grows.",
+        "frogger": "As in other Decktet games at Abstract Play, the deck is displayed at the bottom of the board and includes both cards in the deck and unknown cards in other players' hands.  After the first hand, all cards are drawn from the open market, so hands are then open.  The discards pile is also displayed.\n\nDue to how randomization works at Abstract Play, forced passes are needed for a player to refill the market in the middle of his turn.  These are handled by the server, but a couple of variants for the market have also been added to avoid forced passing.\n\nThe Crocodiles variant is by Jorge Arroyo, the translator of the English rules.  The Advanced rules and other minor variants are by P. D. Magnus; they appear in The Decktet Book, where the game is called Xing.",
         "garden": "To make it very clear what happened on a previous turn, each move is displayed over four separate boards. The first board shows the game after the piece was first placed. The second board shows the state after adjacent pieces were flipped. The third board shows any harvests. The fourth board is the final game state and is where you make your moves.\n\nIn our implementation, black is always the \"tome\" or tie-breaker colour. The last player to harvest black will have a `0.1` after their score.",
         "gyges": "The goal squares are adjacent to all the cells in the back row. The renderer cannot currently handle \"floating\" cells.",
         "homeworlds": "The win condition is what's called \"Sinister Homeworlds.\" You only win by defeating the opponent to your left. If someone else does that, the game continues, but your left-hand opponent now shifts clockwise. For example, in a four-player game, if I'm South, then I win if I eliminate West. But if the North player ends up eliminating West, the game continues, but now my left-hand opponent is North.",
@@ -1158,6 +1160,36 @@
                 "name": "Swap-5 opening"
             }
         },
+        "frogger": {
+            "#market": {
+		"description": "The market does not refill until the next player's turn.",
+                "name": "No refills"
+            },
+            "advanced": {
+		"description": "The advanced game has a shorter track anda more restrictive movement rule.",
+                "name": "Advanced"
+            },
+            "continuous": {
+		"description": "The market is smaller but refills after each turn.",
+                "name": "Continuous market"
+            },
+            "courtpawns": {
+		"description": "For variety, the roles of pawns and courts may be reversed.",
+                "name": "Courts for Pawns"
+            },
+            "courts": {
+		"description": "The four courts are added to the draw deck.  When playing a court, advance a frog to the next available spot in your choice of the three suits (even in the advanced game).  When swapping courts for pawns, pawns will be added instead.",
+                "name": "Courts"
+            },
+            "crocodiles": {
+		"description": "Add hungry crocodiles to the pawn cards.  Crocodiles advance at the end of each round, sending any frog on their new space back to the Excuse.  This variant is intended for a two-player game, but you may add crocodiles at any player count.",
+                "name": "Crocodiles"
+            },
+            "refills": {
+		"description": "The market may be refilled during a player's turn, by splitting their actions over two turns.",
+                "name": "Refills"
+            }
+        },
         "gliss": {
             "#board": {
                 "name": "16x16 board"
@@ -4066,6 +4098,47 @@
         "frames": {
             "INITIAL_INSTRUCTIONS": "Click an empty cell to add a piece to the board."
         },
+	"frogger": {
+            "ADDITIONAL_INSTRUCTIONS": "You may make up to three moves.  Choose another card or frog to start another move, or press the complete move button to finish your turn.",
+            "CARD_FIRST": "Please select a hand card before moving a frog forward.",
+            "CARD_NEXT": "You may click on a market card to add it to your hand, or submit your move.",
+            "CARD_NEXT_OR": "You may click on a market card to add it to your hand, or start another move.",
+            "INITIAL_INSTRUCTIONS": "Click a card in your hand to use to move a frog forward.",
+            "LATER_INSTRUCTIONS": "Click a card in your hand to use to move a frog forward, or click a frog to move it back (and possibly draw a market card).",
+            "INVALID_MARKET_CARD": "Your chosen market card must not include the suit your frog landed on.",
+            "INVALID_FROG": "You may only move your own frogs.",
+            "INVALID_HOP_FORWARD": "When advancing, your frog must land on the first available spot of a given suit.",
+            "INVALID_HOP_FORWARD_ADVANCED": "Under the advanced rules, when playing a two-suited card from your hand, your frog must land on the first available spot of either suit (not your choice).  If both suits are present on the same board card (that is, in the same column), you may choose either spot.",
+            "INVALID_HOP_BACKWARD": "When hopping back, your frog must land on the nearest available card.  If there is more than one spot available in that column, you may choose any one of them.",
+            "INVALID_MOVE": "The move '{{move}}' could not be parsed.",
+            "INVALID_NON-MOVE": "Unless you're blocked, you must move a frog on each of your moves.",
+            "LABEL_MARKET": "Market cards",
+            "LABEL_REMAINING": "Cards in deck",
+            "LABEL_DISCARDS": "Discard pile",
+            "LABEL_STASH": "Player {{playerNum}}'s hand",
+            "MISPLACED_REFILL": "Please request a refill before you move a frog backward.",
+            "MUST_HOP_FORWARD": "When using a hand card, your frog must hop forward.",
+            "MUST_MOVE": "Your frog must move to a different card/column.",
+            "MUST_PASS": "You must pass to allow another player to complete their turn.",
+            "NO_CHOICE_BLOCKED": "If, at the start of your turn, you have no hand cards and none of your frogs can move back, you must draw a single card from the market and end your turn.",
+            "NO_MOVE_BLOCKED": "You cannot move after claiming a card for being blocked.",
+            "NO_PASSING": "There is no passing as such in Frogger.  If you are blocked, you must draw a single card from the market.",
+            "NO_REFILLS": "Refilling the market is not allowed in this variant.",
+            "NO_RETURN": "Frogs may not leave home once they've reached it.",
+            "NO_SUCH_HAND_CARD": "The card \"{{card}}\" does not appear to be in your hand.",
+            "NO_SUCH_MARKET_CARD": "The card \"{{card}}\" does not appear to be in the market.",
+            "NOT_BLOCKED": "You're not blocked, so you must move back before claiming a market card.",
+            "OCCUPIED": "Only one frog per suit space.",
+            "OFF_BOARD": "Frogs must be placed on locations with suits, at home, or at the Excuse.",
+            "OFFSIDES": "Please click on your desired suit space, not the informational icons on the top row.",
+            "PIECE_NEXT": "Click on a frog to move it forward or backwards.",
+            "PLACE_NEXT": "Click on a new location for your frog.",
+	    "TOO_HOPPY": "You may not make more than {{count}} moves on your turn.",
+            "TOO_EARLY_FOR_REFILL": "Please submit your refill request before making your remaining moves.",
+	    "TOO_LATE_FOR_BLOCKED": "You do not count as blocked if you've already moved on this turn.",
+            "TOO_LATE_FOR_REFILL": "There is no need to force a market refill after your third move.  It will refill automatically after your turn."
+        },
+
         "furl": {
             "CAPTURE4UNFURL": "You signalled a capture unfurl move, but {{to}} not is occupied by the opponent. Use \">\" to denote non-capture unfurl.",
             "FURL4UNFURL": "You signalled a furl move with \"<\", but the selected stack has a height of {{size}}, which is greater than 1.",
@@ -5448,7 +5521,7 @@
         }
     },
     "INITIAL_UNDO": "You can't undo the initial starting position of the game.",
-    "MOVES_GAMEOVER": "You cannot make moves in concluded games",
+    "MOVES_GAMEOVER": "You cannot make moves in concluded games.",
     "MOVES_INVALID": "The move '{{move}}' is invalid. Please check the rules and try again.",
     "MOVES_SIMULTANEOUS_PARTIAL": "In simultaneous games, both players' moves must be submitted at the same time."
 }

locales/en/apresults.json

@@ -22,6 +22,7 @@
     "ANNOUNCE": {
         "biscuit": "The following cards were in opposing hands: {{cards}}.",
         "deckfish": "{{player}} was unable to move and must pass from now on.",
+        "frogger": "{{player}} chose to refill the market.  Other players must pass so he can take his {{moves}} remaining move(s).",
         "quincunx": "Player {{playerNum}} had the following cards left in their hand: {{cards}}.",
         "stawvs": "{{player}} was unable to move and must pass from now on.  Their pieces remain on the following pyramids: {{pyramids}}."
     },
@@ -134,6 +135,7 @@
         "fnap_col": "{{player}} claimed column {{where}}.",
         "fnap_fnap": "{{player}} has claimed the FNAP token.",
         "fnap_row": "{{player}} claimed row {{where}}.",
+        "frogger": "{{player}} was blocked and drew {{card}} from the market.",
         "jacynth": "{{player}} exerted influence at {{where}}.",
         "logger": "{{player}} claimed a protestor from the tree felled at {{where}}.",
         "majorities_line": "{{player}} claimed the line {{where}}.",
@@ -167,12 +169,14 @@
         "biscuit": "The next player was unable to play any cards in their hand, so they drew a card.",
         "emu_deck": "{{player}} drew a face-down card from the deck.",
         "emu_discard": "{{player}} drew the {{what}} from the top of the discard pile.",
+        "frogger": "The market was refilled.",
         "quincunx_one": "{{player}} drew {{count}} card.",
         "quincunx_other": "{{player}} drew {{count}} cards."
     },
     "DECLARE": {
         "biscuit": "{{player}} has gone out!",
         "emu": "Year {{year}} has ended.",
+        "frogger": "The crocodiles advanced.",
         "mchess": "{{player}} has \"called the clock.\" If no capture is made in the next seven turns, the game will end and be scored.",
         "renju": "{{player}} has declared {{count}} tentative fifths."
     },
@@ -214,6 +218,8 @@
     "EJECT": {
         "assembly": "The production line moved forward {{distance}} spaces.",
         "deckfish": "{{player}} pushed a piece from {{from}} to {{to}}.",
+        "frogger_card": "{{player}} played an Ace or Crown and returned a frog from {{from}} to {{to}}.",
+        "frogger_croc": "The frog at {{from}} was eaten by crocodiles (and returned to {{to}}).",
         "penguin_ball": "{{player}} kicked the ball from {{from}} to {{to}}.",
         "penguin_penguin": "A penguin was pushed from {{from}} to {{to}}."
     },
@@ -295,6 +301,8 @@
         "fightopia_2": "{{player}} moved a tank from {{from}} to {{to}}.",
         "fightopia_4": "{{player}} moved their giant from {{from}} to {{to}}.",
         "fightopia_pivot": "{{player}} pivoted a tank from {{from}} to {{to}}.",
+        "frogger_back": "{{player}} moved a frog back from {{from}} to {{to}}, and drew {{card}} from the market.",
+        "frogger_forward": "{{player}} used {{card}} to move a frog forward from {{from}} to {{to}}.",
         "gess_one": "{{player}} moved a 3x3 piece containing {{count}} stone from {{from}} to {{to}}.",
         "gess_other": "{{player}} moved a 3x3 piece containing {{count}} stones from {{from}} to {{to}}.",
         "hexentafl_king": "{{player}} moved the king from {{from}} to {{to}}.",
@@ -337,6 +345,7 @@
         "deckfish": "{{player}} was unable to move.",
         "entropy": "{{player}} chose not to move any pieces this turn.",
         "forced": "{{player}} was forced to pass.",
+        "frogger": "{{player}} passed to permit a market refill.",
         "pie": "{{player}} accepted the komi offer and will continue playing second.",
         "pigs": "{{player}} idles.",
         "simple": "{{player}} passed.",