As of late 2021, we are in the process of updating Stencylpedia and fixing up outdated & broken content. Thanks for your patience!

111,731

Views

Beginner

Level

10

Comments

Game Attributes

by Ceric (Updated on 2012-07-24)


In the Attributes article, we introduced (Behavior) Attributes and discussed how they’re changeable values that are used within Stencyl's Behaviors.

Often times, however, we’ll want Attribute values to stick around longer than the lifetime of any particular Actor or Scene – sometimes even between gameplay sessions. For these cases, we can use a resource type called Game Attributes.

 

Contents

  • What are Game Attributes?
  • Game Attribute Types
  • Creating Game Attributes
  • Using Game Attributes
  • Saving
  • Loading

 

What are Game Attributes?

Game Attributes are changeable values that are stored along with a game and, thanks to saving and loading, can persist between gameplay sessions.

Like Behavior Attributes, Game Attributes have both a value and a type.

 

Game Attribute Types

Unlike the large number of types available to Behavior Attributes, Game Attributes can have one of four types:

  1. Number
  2. Text
  3. Boolean (Yes or No)
  4. List

Note: Unlike normal lists, Lists can only contain Numbers, Text and other Lists that contain the same. Although you can dump anything in, if you plan to save this data, avoid putting in unsupported data types.

 

Creating Game Attributes

Consider our familiar vertical shoot ‘em up game.

A perfect use case for using Game Attributes is to keep track of the player’s score, since presumably we want the score to persist between Scenes.

Let’s perform the following to create a new Score Attribute from the Dashboard:

Note: As of version 2.2, the process for creating Game Attributes has changed. The changes are reflected below.

To start, once you've opened a game, click the Settings button in the upper left to open the master Settings dialog window.

Stencyl 2.2 Settings Button

1-Click the Attributes button in the dialog.

2-Click the green Create New button in the upper right area in the dialog window.

3-Enter a name (“Score”) for the Game Attribute. The other fields can be left to their defaults.

4-Click OK.

Create new Game Attribute


The new Game Attribute appears in the listing off to the right, sorted by category.


 

Tip: Game Attributes can also be created directly from Design Mode by clicking the Create New Game Attribute button.

 

 

Using Game Attributes

Once they’re been created, Game Attributes can be used in Design Mode. You can find “getter” and “setter” blocks for each of them under Attributes > Game Attributes.

Tip: Game Attributes are always purple.



 

Note: If you want to use a new Game Attribute in a Behavior you already have open, you’ll need to reload the Behavior using Ctrl-R (Cmd-R on Mac).


Since this Game Attribute has the type Number, we can use it almost anywhere we could use any other number.

As an example, say we want to increase the player’s score by 100 anytime a bullet collides with an enemy. The following simple logic does the trick, using both the getter and setter blocks for the Score Game Attribute:

 

Saving

Saving a game amounts to storing Game Attributes.

If we want to keep track of a player’s progress between gameplay sessions, we can do so by storing any data that needs to persist into Game Attributes and then by using the save block.

Let’s say every time the player enters a new Scene, we want to save the game. All we need to do is to use the save block. Score (as well as any other Game Attributes) will get saved automatically.

 

Loading

Loading a game amounts to reading in all stored Game Attributes. The developer can then choose what happens next (e.g., changing Scenes accordingly).

To load a game, just use the load block.


 

Note: There’s no way to “opt-out” certain Game Attributes from being saved. If you want to reset a Game Attribute’s value after performing a load, you’ll need to do it manually.

 

Summary

  • Game Attributes are changeable values that are stored along with a game and, thanks to saving and loading, can persist between gameplay sessions.
  • Like Behavior Attributes, Game Attributes have both a value and a type.
  • Game Attributes can have one of four types: Number, Boolean (Yes/No), Text and List.
  • Saving a game amounts to storing Game Attributes.
  • Loading a game amounts to reading in all stored Game Attributes.
Disclaimer: Use comments to provide feedback and point out issues with the article (typo, wrong info, etc.). If you're seeking help for your game, please ask a question on the forums. Thanks!

10 Comments

Tanishq
i have deleted a setter attribute please help!!!
1 8 years, 4 months ago
jtech
It is cool but, do I just attach it to a Actor Type and than click on it to activate?
1 9 years, 1 week ago
danielle53
There are only 5 types.
What about creating new Game Attributes types :
there are no Colour type, or Control one.

-1 9 years, 3 weeks ago
martink95
How can i save lists and maps ??

1 9 years, 3 months ago
JohnGuySmith
How can you save or submit sores in to a remote data base that all players no mater what pc or mobile device they are using can submit there scores to?
2 10 years, 11 months ago
imspikey
The explanation was not very clear but here is the basic Idea.

1-you make a game variable (assuming its default value will be 0)

2-Assign it a value.

3-if you want that value to be saved next time you open the game insert save game and then- function otherwise the next time you open the game the value of the game variable will be zero(or the default value).

4- The next time you open the game you have to insert the load save file function otherwise the value of the game variable will remain zero (because although you have saved its value you didn't load it yet)

4 11 years, 10 months ago
coolernow123
my head hurts because this is all a little confusing, but I'm not giving in
0 11 years, 10 months ago
herpeslurpy
@xandramas, the logic can be made in either one, depending on what you need
2 11 years, 11 months ago
xandramas
where am I supposed to create the logic? Is it a scene behavior? Is it an actor behavior?
0 11 years, 12 months ago
MDuru80
This is cool, I get to create game Attributes without code, this is really helpful than a coding crud.
0 12 years, 7 months ago

Sign In to Comment