Feature:   Scoring

Unit Overview

Students extend their State structure to include a score, then modify their game code to change and display that score.


add translation

Product Outcomes:
  • Students add a score field to their gameState structure

  • Students modify their draw-state function to display the score on the screen

  • Students modify other parts of their code to increment or decrement the score

Standards and Evidence Statements:

Standards with prefix BS are specific to Bootstrap; others are from the Common Core. Mouse over each standard to see its corresponding evidence statements. Our Standards Document shows which units cover each standard.

  • BS-DS.1: The student is able to read data blocks

    • given a data block, use dot-accessors to access fields of the data structure

  • BS-DS.2: The student is able to solve problems using data structures

    • add fields to a pre-existing data structure

  • BS-M: The student models a problem in context and determines the data needed to describe the problem

    • identifying which quantities are fixed and which are variable

    • identifying the datatype of a given quantity, in context

  • BS-PL.1: The student is familiar with declaring values and applying built-in functions using the programming language

    • BS-PL.2: The student is comfortable using and writing Contracts for built-in functions

      • representing a function’s input and output using a contract

    • BS-PL.3: The student is able to use the syntax of the programming language to define values and functions

      • defining and retrieving values

    • BS-PL.4: The student is familiar with the syntax for conditionals

      • defining and using functions than involve conditionals

    • BS-R: The student is able to write interactive programs using the ’Reactor’ construct

      • identify how an updating function changes a data structure

      • identify how a drawing function creates a static image

      • identify how functions work together to create and maintain a complex program

      • modify parts of a complex program by altering functions or data structures

    Length: 45 Minutes
    • helper function: A small function that handles a specific part of another computation, and gets called from other functions

      • Student Games or the Pyret Ninja Cat file preloaded on students’ machines





      + - * / sqr sqrt expt

      1 ,4 ,44.6


      string-append string-length



      rectangle circle triangle ellipse star scale rotate put-image

      (circle 25 "solid" "red")

      Adding a Scoring System


      Students learn how to add a scoring system to their game

      Learning Objectives

      • BS-DS.1

      • BS-DS.2

      • BS-R

      Evidence Statementes

        Product Outcomes

        • Students add a score field to their gameState structure

        • Students modify their draw-state function to display the score on the screen

        • Students modify other parts of their code to increment or decrement the score



        • Student Games or the Pyret Ninja Cat file preloaded on students’ machines

        Adding a Scoring System (Time 45 minutes)

        • Adding a Scoring SystemIn Bootstrap:Algebra, the scoring system for your video game was included in the teachpack, code which ran "under the hood" in your game file. In Bootstrap:Reactive, however, you no longer need this hidden code, since you’ve learned enough to program your entire Bootstrap:Algebra game (and more) yourself! In this lesson, we’ll cover how to add a scoring system to your Bootstrap:Reactive game.

          This lesson is part of a series of features meant to come at the end of the Bootstrap:Reactive units. Once students have made a number of simple animations and games, they will have lots of ideas for what they want to make next and add to their existing games. We’ve included a number of the most requested features in these lessons. Because each students’ game will be different, we’ve used a Pyret version of the original Ninja Cat game as an example program, but the lesson can be adapted to add scoring to any game.

        • The score is something that will be changing in the game, so you can be sure that it has to be added to the ____State data structure. In our example Ninja Cat program, we’ve called our structure GameState, which currently contains the x and y-coordinates for our player, danger, and target, plus the speed of the danger, and speed of the target. Your game(s) will likely have different structures.
          • What data type is a score? Number, String, Image, or Boolean?

          • What would be the score in your starting game state? (we called this START in our game.)

          • Change the data structure in your game so it includes a score.

          Remember: Since your structure is changing, you now have to go through your game code—every time you call the constructor function for your structure (ours is game()), the score must be included. It may be helpful to add the score as the very first or last field of the structure, to make this easier.

          How would you get the score out of one of your instances?

          The GameState structure for our Ninja Cat game now looks like this:  

          Reminder: Your students will likely have radically different games at this point in the course. This lesson is not meant to be followed exactly, but rather used to give students an idea of what steps they should take to add a scoring system to their own games. For extra practice, students can work through adding a scoring system to the Ninja Cat program as well as their own games.

        • Now that the game has a score, that score needs to actually increase or decrease depending on what happens in the game. For our Ninja Cat game, we’ll say that the score should go up by 30 points when Ninja Cat collides with the ruby (target), and down by 20 points when she collides with the dog (danger).
          • Which of the if branches in your next-state-tick function checks whether your player has collided with another character?

          • How would you decrease the game’s score by 20 points if the player collides with the danger?

          • Hint: How many dangers does your game have? If there are multiple things your player could hit to lose points, remember to check for each possible collision condition!

          If you completed the optional challenge at the end of the Collisions Feature to write the function game-over, you already have your own helper function to check whether or not your game over condition is met. That will be the first condition inside next-state-tick, since we don’t want the game to continue if it’s already over! (In our Ninja Cat game, game-over returns true if the cat collides with the dog, AND the cat is on the ground.) After checking whether or not the game is over, the next three conditions in our next-state-tick function check whether the player has collided with the danger and target, as well as whether the player is jumping on the danger:


          Change your own game code so that your score increases and decreases depending on various game conditions: Maybe your score increases when the player collides with a target, reaches a specific area of the screen, or reaches a specific area only after picking up an item. Maybe your game’s scoring system isn’t a seprate score at all, but a timer that increases every tick, and represents how long someone has been playing your game. There are lots of ways to implement a scoring system, and which one you choose will depend on the specific mechanics of your individual game.

        • Now your scoring system is in place, but how will the person playing your game know what their score is? You’ll want to display the score on the screen.

          Which function handles how the game state is drawn?

          In the draw-state function, images are placed onto the background using put-image to draw the game. But the score is represented by a Number: we need a way to represent it as an Image. Thankfully, Pyret has some built-in functions that can help with this: the function num-to-string takes in a Number for its domain and returns a String representation of that number. This string can then be passed to the text function to return an Image that can be used in draw-state.

          Copy the following contracts into your workbook:

          • # num-to-string :: Number -> String

          • # text :: String, Number, String -> Image

          • How would you use the num-to-string and text functions together to draw the score into the game?

          • How do you get the score out of the game state?

          • How large should the text of the score be? Where should it be placed on your game scene?

          The expression:   will place the score (drawn in size 20 white text) onto the center of the BACKGROUND-IMG.

          Use these functions to draw the score onto your game screen. You could also use the string-append function to make it clear to players that the number they see is their score, like so: text(string-append("Score: ", num-to-string(g.score)), 20, "white")