AR/setAccountData - Revision history

EOFIK: Добавление языков

2021-04-12T15:46:59Z

Добавление языков

← Older revision		Revision as of 15:46, 12 April 2021
Line 51:		Line 51:
	[[ar:setAccountData]]		[[ar:setAccountData]]
	[[es:setAccountData]]		[[es:setAccountData]]
	~~[[zh-cn:setAccountData]]~~

EOFIK: Добавление языков

2021-04-12T15:45:43Z

Добавление языков

← Older revision		Revision as of 15:45, 12 April 2021
Line 48:		Line 48:

	[[en:setAccountData]]		[[en:setAccountData]]
			[[ru:setAccountData]]
			[[ar:setAccountData]]
	[[es:setAccountData]]		[[es:setAccountData]]
			[[zh-cn:setAccountData]]

Qaisjp: tweak note

2019-09-07T08:42:23Z

tweak note

← Older revision		Revision as of 08:42, 7 September 2019
Line 1:		Line 1:
	{{Server function}}		{{Server function}}
	__NOTOC__		__NOTOC__ {{Important Note\|You '''MUST''' use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}
	{{Important Note\|You '''MUST''' use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}
	This function sets a string to be stored in an account. This can then be retrieved using [[getAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account. Even if logged into a guest account, account data can be useful as a way to store a reference to your own account system, though it's persistence is equivalent to that of using [[setElementData]] on the player's element.		This function sets a string to be stored in an account. This can then be retrieved using [[getAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account. Even if logged into a guest account, account data can be useful as a way to store a reference to your own account system, though it's persistence is equivalent to that of using [[setElementData]] on the player's element.

Qaisjp: tweak note

2019-09-07T08:42:18Z

tweak note

← Older revision		Revision as of 08:42, 7 September 2019
Line 1:		Line 1:
	{{Server function}}		{{Server function}}
	__NOTOC__		__NOTOC__
	{{~~Note_box~~\|~~It is strongly recommended that you~~ use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}		{{Important Note\|You '''MUST''' use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}
	This function sets a string to be stored in an account. This can then be retrieved using [[getAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account. Even if logged into a guest account, account data can be useful as a way to store a reference to your own account system, though it's persistence is equivalent to that of using [[setElementData]] on the player's element.		This function sets a string to be stored in an account. This can then be retrieved using [[getAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account. Even if logged into a guest account, account data can be useful as a way to store a reference to your own account system, though it's persistence is equivalent to that of using [[setElementData]] on the player's element.

آحمد آلعلَي: /* See Also */

2013-10-09T12:11:50Z

آحمد آلعلَي: /* مثال */

2013-10-09T12:11:18Z

مثال

← Older revision		Revision as of 12:11, 9 October 2013
Line 21:		Line 21:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function onPlayerQuit ( )		function onPlayerQuit ( )
	-- ~~when a player leaves, store his current money amount in his account data~~		-- عندما يترك لاعب، متجره المبلغ من المال الحالية في بيانات حسابه
	local playeraccount = getPlayerAccount ( source )		local playeraccount = getPlayerAccount ( source )
	if ( playeraccount ) and not isGuestAccount ( playeraccount ) then -- ~~if the player is logged in~~		if ( playeraccount ) and not isGuestAccount ( playeraccount ) then -- إذا تم تسجيل اللاعب
	local playermoney = getPlayerMoney ( source ) -- ~~get the player money~~		local playermoney = getPlayerMoney ( source ) -- الحصول على المال الاعب
	setAccountData ( playeraccount, "piraterpg.money", playermoney ) -- ~~save it in his account~~		setAccountData ( playeraccount, "piraterpg.money", playermoney ) -- حفظها في حسابه
	end		end
	end		end

	function onPlayerLogin (_, playeraccount )		function onPlayerLogin (_, playeraccount )
	-- ~~when a player logins, retrieve his money amount from his account data and set it~~		-- عندما تسجيلات لاعب، استرداد له مبلغ من المال من بيانات حسابه وضعه
	if ( playeraccount ) then		if ( playeraccount ) then
	local playermoney = getAccountData ( playeraccount, "piraterpg.money" )		local playermoney = getAccountData ( playeraccount, "piraterpg.money" )
	-- ~~make sure there was actually a value saved under this key~~ (~~check if playermoney is not false~~).		-- تأكد من أن هناك فعلا قيمة المحفوظة تحت هذا المفتاح (معرفة ما اذا كان مال الاعب ليست كاذبة).
	-- ~~this will for example not be the case when a player plays the gametype for the first time~~		-- وهذا على سبيل المثال سوف لا يكون الأمر كذلك عندما لاعب يلعب قيم تايب لأول مرة
	if ( playermoney ) then		if ( playermoney ) then
	setPlayerMoney ( source, playermoney )		setPlayerMoney ( source, playermoney )

آحمد آلعلَي: /* Example */

2013-10-09T12:07:56Z

Example

← Older revision		Revision as of 12:07, 9 October 2013
Line 17:		Line 17:
	ترجع صحيح إذا تم تعيين بيانات حسابك، كاذبة إذا تم تحديد وسيطة غير صالحة.		ترجع صحيح إذا تم تعيين بيانات حسابك، كاذبة إذا تم تحديد وسيطة غير صالحة.

	==~~Example~~==		==مثال==
	~~For a pirate roleplaying gametype, the amount of money a player has is made persistent by storing it in his account~~. ~~Note the code uses~~ "piraterpg.money" ~~as key instead of just~~ "~~money~~"~~, as the player may be participating in other~~ gametypes ~~that also save his money amount to his account~~. If both gametypes would use "money" as the account key, they'd overwrite each other's data.		لقرصان الأدوار gametype، ويرصد مبلغ من المال لاعب الثابتة عن طريق تخزينه في حسابه. ملاحظة يستخدم رمز "piraterpg.money" كمفتاح بدلا من مجرد "المال"، كما يجوز المشاركة للاعب في gametypes الأخرى التي توفر أيضا له مبلغ من المال لله الحساب. If both gametypes would use "money" as the account key, they'd overwrite each other's data.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function onPlayerQuit ( )		function onPlayerQuit ( )

آحمد آلعلَي: /* Syntax */

2013-10-09T12:05:48Z

Syntax

← Older revision		Revision as of 12:05, 9 October 2013
Line 9:		Line 9:
	</syntaxhighlight>		</syntaxhighlight>

	===~~Required Arguments~~===		===العناصر المطلوبة===
	*'''theAccount:''' ~~The account you wish to retrieve the data from~~.		*'''theAccount:''' إن الحساب الذي تريد استرداد البيانات من.
	*'''key:''' ~~The key under which you wish to store the data~~		*'''key:''' مفتاح تحت التي كنت ترغب في تخزين البيانات
	*'''value:''' The value you wish to store. '''NOTE:''' you cannot store tables as values, but you can use [[toJSON]] strings.		*'''value:''' The value you wish to store. '''NOTE:''' you cannot store tables as values, but you can use [[toJSON]] strings.

	===Returns===		===Returns===
	~~Returns a ''true'' if the account data was set, ''false'' if an invalid argument was specified~~.		ترجع صحيح إذا تم تعيين بيانات حسابك، كاذبة إذا تم تحديد وسيطة غير صالحة.

	==Example==		==Example==

TAPL: Created page with "{{Server function}} NOTOC {{Note_box|It is strongly recommended that you use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents co..."

2012-08-30T14:21:22Z

Created page with "{{Server function}} __NOTOC__ {{Note_box|It is strongly recommended that you use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents co..."

New page

{{Server function}}
__NOTOC__
{{Note_box|It is strongly recommended that you use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}
This function sets a string to be stored in an account. This can then be retrieved using [[getAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account. Even if logged into a guest account, account data can be useful as a way to store a reference to your own account system, though it's persistence is equivalent to that of using [[setElementData]] on the player's element.

==Syntax==
<syntaxhighlight lang="lua">
bool setAccountData ( account theAccount, string key, string value )
</syntaxhighlight>

===Required Arguments===
*'''theAccount:''' The account you wish to retrieve the data from.
*'''key:''' The key under which you wish to store the data
*'''value:''' The value you wish to store. '''NOTE:''' you cannot store tables as values, but you can use [[toJSON]] strings.

===Returns===
Returns a ''true'' if the account data was set, ''false'' if an invalid argument was specified.

==Example==
For a pirate roleplaying gametype, the amount of money a player has is made persistent by storing it in his account. Note the code uses "piraterpg.money" as key instead of just "money", as the player may be participating in other gametypes that also save his money amount to his account. If both gametypes would use "money" as the account key, they'd overwrite each other's data.
<syntaxhighlight lang="lua">
function onPlayerQuit ( )
-- when a player leaves, store his current money amount in his account data
local playeraccount = getPlayerAccount ( source )
if ( playeraccount ) and not isGuestAccount ( playeraccount ) then -- if the player is logged in
local playermoney = getPlayerMoney ( source ) -- get the player money
setAccountData ( playeraccount, "piraterpg.money", playermoney ) -- save it in his account
end
end

function onPlayerLogin (_, playeraccount )
-- when a player logins, retrieve his money amount from his account data and set it
if ( playeraccount ) then
local playermoney = getAccountData ( playeraccount, "piraterpg.money" )
-- make sure there was actually a value saved under this key (check if playermoney is not false).
-- this will for example not be the case when a player plays the gametype for the first time
if ( playermoney ) then
setPlayerMoney ( source, playermoney )
end
end
end

addEventHandler ( "onPlayerQuit", getRootElement ( ), onPlayerQuit )
addEventHandler ( "onPlayerLogin", getRootElement ( ), onPlayerLogin)
</syntaxhighlight>

==See Also==
{{AR Account_functions}}

[[en:setAccountData]]
[[es:setAccountData]]

← Older revision		Revision as of 12:11, 9 October 2013
Line 45:		Line 45:
	</syntaxhighlight>		</syntaxhighlight>

	==~~See Also~~==		==انظر ايضا==
	{{AR Account_functions}}		{{AR Account_functions}}

	[[en:setAccountData]]		[[en:setAccountData]]
	[[es:setAccountData]]		[[es:setAccountData]]

AR/setAccountData - Revision history

EOFIK: Добавление языков

EOFIK: Добавление языков

Qaisjp: tweak note

Qaisjp: tweak note

آحمد آلعلَي: /* See Also */

آحمد آلعلَي: /* مثال */

آحمد آلعلَي: /* Example */

آحمد آلعلَي: /* Syntax */

TAPL: Created page with "{{Server function}} __NOTOC__ {{Note_box|It is strongly recommended that you use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents co..."

TAPL: Created page with "{{Server function}} NOTOC {{Note_box|It is strongly recommended that you use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents co..."