Awarding prizes - Revision history

Whirled vox: Text replacement - ">" to ">"

2018-09-04T11:24:00Z

Text replacement - ">" to ">"

← Older revision		Revision as of 11:24, 4 September 2018
Line 11:		Line 11:
	Because a game can award the same prize more than once if the player earns the prize in separate game sessions, a game that wishes to only award a prize once should couple the award of the prize with the [[awarding trophies\|award of a trophy]] and then structure their code like so:		Because a game can award the same prize more than once if the player earns the prize in separate game sessions, a game that wishes to only award a prize once should couple the award of the prize with the [[awarding trophies\|award of a trophy]] and then structure their code like so:

	<actionscript~~>~~		<actionscript>
	//Where _control is an instace of the GameControl Object		//Where _control is an instace of the GameControl Object
	//And the string argument (i.e. "special_award_avatar") is the identifier for the prize and not the name.		//And the string argument (i.e. "special_award_avatar") is the identifier for the prize and not the name.
Line 18:		Line 18:
	_ctrl.awardPrize("special_award_avatar");		_ctrl.awardPrize("special_award_avatar");
	}		}
	</actionscript~~>~~		</actionscript>

	To simultaneously award a prize with a trophy, the code looks like this:		To simultaneously award a prize with a trophy, the code looks like this:

	<actionscript~~>~~		<actionscript>
	//Where _control is an instace of the GameControl Object		//Where _control is an instace of the GameControl Object
	//And the string argument (i.e. "prizeone") is the identifier for the prize and not the name.		//And the string argument (i.e. "prizeone") is the identifier for the prize and not the name.
Line 30:		Line 30:
	_control.player.awardPrize(prizeone);		_control.player.awardPrize(prizeone);
	}		}
	</actionscript~~>~~		</actionscript>

	== Creating Prizes ==		== Creating Prizes ==

Whirled vox: Text replacement - "<" to "<"

2018-09-04T02:18:22Z

Text replacement - "<" to "<"

← Older revision		Revision as of 02:18, 4 September 2018
Line 11:		Line 11:
	Because a game can award the same prize more than once if the player earns the prize in separate game sessions, a game that wishes to only award a prize once should couple the award of the prize with the [[awarding trophies\|award of a trophy]] and then structure their code like so:		Because a game can award the same prize more than once if the player earns the prize in separate game sessions, a game that wishes to only award a prize once should couple the award of the prize with the [[awarding trophies\|award of a trophy]] and then structure their code like so:

	~~<~~actionscript>		<actionscript>
	//Where _control is an instace of the GameControl Object		//Where _control is an instace of the GameControl Object
	//And the string argument (i.e. "special_award_avatar") is the identifier for the prize and not the name.		//And the string argument (i.e. "special_award_avatar") is the identifier for the prize and not the name.
Line 18:		Line 18:
	_ctrl.awardPrize("special_award_avatar");		_ctrl.awardPrize("special_award_avatar");
	}		}
	~~<~~/actionscript>		</actionscript>

	To simultaneously award a prize with a trophy, the code looks like this:		To simultaneously award a prize with a trophy, the code looks like this:

	~~<~~actionscript>		<actionscript>
	//Where _control is an instace of the GameControl Object		//Where _control is an instace of the GameControl Object
	//And the string argument (i.e. "prizeone") is the identifier for the prize and not the name.		//And the string argument (i.e. "prizeone") is the identifier for the prize and not the name.
Line 30:		Line 30:
	_control.player.awardPrize(prizeone);		_control.player.awardPrize(prizeone);
	}		}
	~~<~~/actionscript>		</actionscript>

	== Creating Prizes ==		== Creating Prizes ==

Whirled vox: Text replacement - """ to """

2018-08-30T21:18:00Z

Text replacement - """ to """

← Older revision		Revision as of 21:18, 30 August 2018
Line 13:		Line 13:
	<actionscript>		<actionscript>
	//Where _control is an instace of the GameControl Object		//Where _control is an instace of the GameControl Object
	//And the string argument (i.e. ~~"~~special_award_avatar~~"~~) is the identifier for the prize and not the name.		//And the string argument (i.e. "special_award_avatar") is the identifier for the prize and not the name.

	if (_ctrl.awardTrophy(~~"~~special_award_trophy~~"~~)) {		if (_ctrl.awardTrophy("special_award_trophy")) {
	_ctrl.awardPrize(~~"~~special_award_avatar~~"~~);		_ctrl.awardPrize("special_award_avatar");
	}		}
	</actionscript>		</actionscript>
Line 24:		Line 24:
	<actionscript>		<actionscript>
	//Where _control is an instace of the GameControl Object		//Where _control is an instace of the GameControl Object
	//And the string argument (i.e. ~~"~~prizeone~~"~~) is the identifier for the prize and not the name.		//And the string argument (i.e. "prizeone") is the identifier for the prize and not the name.

	if(!_control.player.holdsTrophy(trophyone)){		if(!_control.player.holdsTrophy(trophyone)){
Line 38:		Line 38:
	#Choose '''Games &rarr; My Games''' to see the Games you own.		#Choose '''Games &rarr; My Games''' to see the Games you own.
	#Click the Edit link below the name of the game you want to make a prize for.		#Click the Edit link below the name of the game you want to make a prize for.
	#Select the ~~"~~Prizes~~"~~ tab.		#Select the "Prizes" tab.
	#Click on the ~~"~~Create~~"~~ button to get the prize creation interface. [[Image:Stuff-Create_prize.png\|none\|thumb\|400px\|Prize creation interface.]]		#Click on the "Create" button to get the prize creation interface. [[Image:Stuff-Create_prize.png\|none\|thumb\|400px\|Prize creation interface.]]
	##Click on the '''Name''' field and enter a name for your prize.		##Click on the '''Name''' field and enter a name for your prize.
	##Click on the '''Identifier''' field and enter an identifier for your prize. This string is used to identify this prize in your game code.		##Click on the '''Identifier''' field and enter an identifier for your prize. This string is used to identify this prize in your game code.
Line 47:		Line 47:
	#You can then click on '''Save''' to add your prize to the Prizes tab.		#You can then click on '''Save''' to add your prize to the Prizes tab.

	Once all the desired prizes have been created, the prizes should be shown on the Prizes tab. You will need to click ~~"~~View~~"~~ for each prize and ~~"~~List item~~"~~ in order to publish them so they are accessible by your game. The prizes will not be visible items in the Shop.		Once all the desired prizes have been created, the prizes should be shown on the Prizes tab. You will need to click "View" for each prize and "List item" in order to publish them so they are accessible by your game. The prizes will not be visible items in the Shop.

	== See Also ==		== See Also ==

Dragawn: Created page with "The Prizes tab for a game.This tutorial will guide you through the process of '''awarding and activating prizes''' for y..."

2018-08-25T17:16:59Z

Created page with "thumb|right|450px|The Prizes tab for a game.This tutorial will guide you through the process of '''awarding and activating prizes''' for y..."

New page

[[Image:Games-Edit_Game-Prizes.png|thumb|right|450px|The Prizes tab for a game.]]This tutorial will guide you through the process of '''awarding and activating prizes''' for your game.

Note: Once you add a prize to the Prizes tab in the game editor, you cannot delete it.

__FORCETOC__
== Coding the Prizes ==
When you want to award a prize, just call _control.player.awardPrize(ident), where ident is the identifier you set below.

You can award prizes at the same time as trophies by doing something like this:

Because a game can award the same prize more than once if the player earns the prize in separate game sessions, a game that wishes to only award a prize once should couple the award of the prize with the [[awarding trophies|award of a trophy]] and then structure their code like so:

<actionscript>
//Where _control is an instace of the GameControl Object
//And the string argument (i.e. "special_award_avatar") is the identifier for the prize and not the name.

if (_ctrl.awardTrophy("special_award_trophy")) {
_ctrl.awardPrize("special_award_avatar");
}
</actionscript>

To simultaneously award a prize with a trophy, the code looks like this:

<actionscript>
//Where _control is an instace of the GameControl Object
//And the string argument (i.e. "prizeone") is the identifier for the prize and not the name.

if(!_control.player.holdsTrophy(trophyone)){
_control.player.awardTrophy(trophyone);
_control.player.awardPrize(prizeone);
}
</actionscript>

== Creating Prizes ==

After you have listed your game with the prize calls, you should then create your prizes. First, you need to upload an item that will be your prize. '''[[List]] the item in the shop (can be hidden) and take note of the item's shop ID''' (http://www.whirled.com/#shop-l_5_347 has 347 as its shop ID). The item that is used as a prize needs to be uploaded & listed by you.

#Choose '''Games &rarr; My Games''' to see the Games you own.
#Click the Edit link below the name of the game you want to make a prize for.
#Select the "Prizes" tab.
#Click on the "Create" button to get the prize creation interface. [[Image:Stuff-Create_prize.png|none|thumb|400px|Prize creation interface.]]
##Click on the '''Name''' field and enter a name for your prize.
##Click on the '''Identifier''' field and enter an identifier for your prize. This string is used to identify this prize in your game code.
##Use the dropdown menu in '''Prize Type''' to indicate what type of item your prize is. It can be: Avatar, Furniture, Backdrop, Toy, Pet, Launcher, Level Pack, Item Pack, Image, Audio, Video, or Prop.
##Click on the '''Prize Shop ID''' field and enter the shop ID number. For example, http://www.whirled.com/#shop-l_5_347 has 347 as its shop ID.
##Confirm that you own the copyrights to the item or have authorization to upload it.
#You can then click on '''Save''' to add your prize to the Prizes tab.

Once all the desired prizes have been created, the prizes should be shown on the Prizes tab. You will need to click "View" for each prize and "List item" in order to publish them so they are accessible by your game. The prizes will not be visible items in the Shop.

== See Also ==
*[http://www.whirled.com/code/asdocs/com/whirled/game/PlayerSubControl.html#awardPrize() PlayerSubControl's awardPrize section]
*[[Awarding trophies]]
*[[Create and sell game packs]]

[[Category:Game tutorials]]