Pre-release
AdventureJS Docs Downloads Bundler Devlog Score: 0 Moves: 0

Class:Scorecard

Defined in: Adventure/Scorecard.js, line 5

Engine class

Description

Scorecard is a repository for game score options. Scorecard is created automatically by Game. This is an internal class that authors should not need to construct. However, authors can set scoring options from their game file as shown below, and call score updates from custom scripts.

Example:

var MyGame = new AdventureJS.Game( "MyGame", "GameContainer" );
MyGame.scorecard.set({
  points: {
    "unlock door": { value: 1, awarded: false, bonus: false, award_text: '', recorded: false },
    "unlock chest": { value: 1, awarded: false, bonus: false, award_text: '', recorded: false },
    "drink potion": { value: 1, awarded: false, bonus: false, award_text: '', recorded: false },
  }
});

Private Constructor:

var foo = new AdventureJS.Scorecard(game)

Parameters:

  • game Game
    A reference to the game instance.
Inherited Overrides

Methods Collapse all  |  Expand all

awardPoint
awardPoint(point, recurse) → {Boolean}

Defined in: Adventure/Scorecard.js, line 156

Parameters:

  • point String | Object
    An id string or object reference.
  • recurse Boolean
    Whether to award nested points.
Mark the selected point as complete and update the score.

Returns:

Boolean
clearPoint
clearPoint(point) → {Boolean}

Defined in: Adventure/Scorecard.js, line 203

Parameters:

  • point String
    A string matching an point key.
Mark the selected point as incomplete and update the score.

Returns:

Boolean
completePoint
completePoint(point) → {Boolean}

Defined in: Adventure/Scorecard.js, line 582

Parameters:

  • point String
    A string matching an point key.
This is a utility method that awards and also records a point. Meant for debugging so author can award a point in the console.

Returns:

Boolean
countAwardedPoints
countAwardedPoints()

Defined in: Adventure/Scorecard.js, line 221

Recursively count awarded points.
createPoint
createPoint() → {Object}

Defined in: Adventure/Scorecard.js, line 241

Create a new point object with default values.

Returns:

Object
findGoal
findGoal(key, root) → {Object|null}

Defined in: Adventure/Goalcard.js, line 122

Parameters:

  • key String
    A name or id to search for.
  • root Object
    The root object level to begin search.
Recursively find goal by name or key.

Returns:

Object | null
findGoalByName
findGoalByName(key, root) → {Object|null}

Defined in: Adventure/Goalcard.js, line 164

Parameters:

  • key String
    An object key to search for.
  • root Object
    The root object level to begin search.
Recursively find goal by its name.

Returns:

Object | null
findPointByKey
findPointByKey(key, root) → {Object|null}

Defined in: Adventure/Scorecard.js, line 264

Parameters:

  • key String
    An object key to search for.
  • root Object
    The root object level to begin search.
Find point by key. Looks recursively.

Returns:

Object | null
findPointByText
findPointByText(key, root) → {Object|null}

Defined in: Adventure/Scorecard.js, line 291

Parameters:

  • key String
    An object key to search for.
  • root Object
    The root object level to begin search.
Recursively find point by its text.

Returns:

Object | null
formatScore
formatScore()

Defined in: Adventure/Scorecard.js, line 315

Format the score/total before printing it to display.
getPoint
getPoint(point) → {Boolean}

Defined in: Adventure/Scorecard.js, line 327

Parameters:

  • point String | Object
    An id string or object reference.
Get a point by numerical key or by its text or if a point object is received pass it on.

Returns:

Boolean
itemizePoints
itemizePoints()

Defined in: Adventure/Scorecard.js, line 347

Get an itemized list of completed points.
listGoals
listGoals()

Defined in: Adventure/Goalcard.js, line 196

Get a printable list of goals.
listPoints
listPoints()

Defined in: Adventure/Scorecard.js, line 377

Get an itemized list of completed points.
processLonghand
processLonghand()

Defined in: Adventure/Scorecard.js, line 403

Process score data in longhand format.
processShorthand
processShorthand()

Defined in: Adventure/Scorecard.js, line 461

Process score data in shorthand format.
recordPoint
recordPoint(point) → {Boolean}

Defined in: Adventure/Scorecard.js, line 567

Parameters:

  • point String
    A string matching an point key.
Mark the selected point as recorded after updating the score.

Returns:

Boolean
restoreScore
restoreScore()

Defined in: Adventure/Scorecard.js, line 595

Restore the player's score from a saved file or undo.
set
set(props) → {AdventureJS.Scorecard}

Defined in: Adventure/Scorecard.js, line 651

Parameters:

  • props Object
    A generic object containing properties to copy to the instance.
Provides a chainable shortcut method for setting a number of properties on the instance.

Returns:

AdventureJS.Scorecard Returns the instance the method is called on (useful for chaining calls.)
stackUpdates
stackUpdates()

Defined in: Adventure/Scorecard.js, line 616

Print score updates in a stack.
summarizeUpdates
summarizeUpdates()

Defined in: Adventure/Scorecard.js, line 134

Print score updates in the aggregate.
updateScore
updateScore()

Defined in: Adventure/Scorecard.js, line 681

Update the player's score.

Properties  | 

award_text
award_text :Boolean

Defined in: Adventure/Scorecard.js, line 60

Default value: ""

Can be set to print when player is awarded any point.
diff
diff :Boolean

Defined in: Adventure/Scorecard.js, line 52

Default value: 0

Used to show the difference between old score and new score during score updates.
newscore
newscore :Boolean

Defined in: Adventure/Scorecard.js, line 44

Default value: 0

Used to compare old score vs new score during score updates.
noscore
noscore :Boolean

Defined in: Adventure/Scorecard.js, line 99

Default value: {}

If user has no points and types points print this.
overview
overview :Boolean

Defined in: Adventure/Scorecard.js, line 106

Default value: {}

If user types points print this as a leading overview.
points
points :Boolean

Defined in: Adventure/Scorecard.js, line 92

Default value: {}

Used to store the game's points.
score
score :Boolean

Defined in: Adventure/Scorecard.js, line 37

Default value: 0

Used to keep track of player's current score.
score_format
score_format :Boolean

Defined in: Adventure/Scorecard.js, line 67

Default value: {}

Can be used to set customized score printouts in the game display. score_format is subject to getStringArrayFunction() which means that it can be set to a string or an array or a function. For example, this returns a string: 
award_text: `{Our} score went up! `,
This returns a custom function: 
award_text: function(){
  return `Dude, you totally just got ${this.diff} points!`
},
Or maybe you just want to tweak the score display. By default score appears in 0/0 format, but let's say you'd like it to say "Score: 0 out of 0". 
score_format: function()
{
  return `Score: ${this.score} out of ${this.total}`;
}
summarize_updates
summarize_updates :Boolean

Defined in: Adventure/Scorecard.js, line 113

Default value: {}

summarize_updates determines how score updates are printed. With summarize_updates set to true, if multiple points occur in a turn, only one score update will be printed, with the cumulative score change. If summarize_updates are false, each score update will be printed, and will use unique award_text that may be provided.