PL/givePlayerMoney: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Tłumaczenie napisane od początku, na podstawie wersji angielskiej.)
Line 1: Line 1:
{{Server client function}}
__NOTOC__
__NOTOC__
{{PL/Shared function}}
Ta funkcja dodaj piedziądze graczom. Żeby ustawić pieniądze gracza na daną liczbę użyj [[PL/SetPlayerMoney|setPlayerMoney]].
Dzięki tej funkcji możemy <u>dodać</u> graczowi dowolną ilość pieniędzy, bez uprzedniego sprawdzania stanu jego konta. Do <u>zmieniania</u> ilości pieniędzy, korzysta się z funkcji [[setPlayerMoney]].<br>
{{PL/Note|Używanie tej funkcji po stronie klienta (niepolecane) nie wpłynie na stan konta gracza po stronie serwera.}}


==Składnia==  
==Składnia (syntax)==  
<section name="Server" class="server" show="true">
<section name="Serwer" class="server" show="true">
<syntaxhighlight lang="lua">bool givePlayerMoney ( player thePlayer, int amount )</syntaxhighlight>  
<syntaxhighlight lang="lua">bool givePlayerMoney ( player thePlayer, int amount )</syntaxhighlight>  
 
{{OOP||[[player]]:giveMoney|money}}
===Wymagane argumenty===  
===Wymagane argumenty===  
*'''thePlayer:''' [[PL/Player|Gracz]], któremu chcesz dać pieniądze.
*'''thePlayer:''' element reprezentujący [[player|gracza]], który otrzyma pieniądze.
*'''amount:''' Liczba pieniędzy, którą chcesz dać.
*'''amount:''' dodatnia liczba całkowita, określająca ile pieniędzy otrzyma gracz.
</section>
</section>
<section name="Klient" class="client" show="true">
<section name="Klient" class="client" show="true">
<syntaxhighlight lang="lua">bool givePlayerMoney ( int amount )</syntaxhighlight>  
<syntaxhighlight lang="lua">bool givePlayerMoney ( int amount )</syntaxhighlight>  
 
{{OOP||[[Player]].giveMoney}}
===Wymagane argumenty===  
===Wymagane argumenty===  
*'''amount:''' Liczba pieniędzy, którą chcesz dać.
*'''amount:''' dodatnia liczba całkowita, określająca ile pieniędzy otrzyma gracz.
</section>
</section>


===Zwracanie===
==Wynik==
Zwraca ''true'' jeżeli pieniądze zostały dodane lub ''false'' jeżeli wpisaliśmy złe argumenty.
Zwraca ''true'', jeżeli pieniądze zostały pomyślnie dodane. Zwraca ''false'', jeżeli któryś z argumentów jest nieprawidłowy.


==Przykłady==   
==Przykłady==   
<section show="true" name="Przykład 1 - Klient i Serwer" class="server">
<section show="true" name="Przykład nr 1: Serwer oraz klient" class="server">
Ten przykłąd daje pieniądze graczom, którzy użyją komendy ''givecash''
Ten przykład tworzy komendę "pieniadze", dzięki której gracz może dać sobie dowolną ilość pieniędzy korzystając z niej, np. /pieniadze 100
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function consoleGiveCash ( thePlayer, command, amount )  
function dajMiPieniadze ( thePlayer, command, amount ) -- tworzymy funkcję dającą pieniądze...
givePlayerMoney ( thePlayer, amount )  
  givePlayerMoney ( thePlayer, amount ) -- ...dajemy graczowi tyle pieniądzy, ile sobie zażyczył...
end
end
addCommandHandler ( "givecash", consoleGiveCash  )  
addCommandHandler ( "pieniadze", dajMiPieniadze ) -- ...ale oczywiście nie zapominamy podłączyć funkcji pod commandHandler
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>


<section show="true" name="Przykład 2 - Serwer" class="server">
<section show="true" name="Przykład nr 2: Serwer" class="server">
Ten przykład daje graczowi 1000$, jako nagrodę za zabicie innego gracza.
Ten przykład daje graczowi 1000$ po zabiciu innego gracza.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function rewardOnWasted ( ammo, killer, killerweapon, bodypart )
function nagrodaZaZabicie ( amunicja, zabojca )
if ( killer ) and ( killer ~= source ) then  
  -- jeżeli znaleziono zabójcę i nie jest ona ofiarą...
givePlayerMoney ( killer, 1000 )  
  if ( zabojca ) and ( zabojca ~= source ) then
end
      givePlayerMoney ( zabojca, 1000 ) -- ...to dajemy mu pieniądze...
  end
end
end
addEventHandler ( "onPlayerWasted", getRootElement(), rewardOnWasted )  
addEventHandler ( "onPlayerWasted", getRootElement(), nagrodaZaZabicie ) -- ...i nie zapominamy podłączyć funkcji pod eventHandler
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>
--[[User:MACIEKW89|MACIEKW89]] 02:15, 21 December 2013 (UTC)MACIEKW89
<section show="true" name="Przykład nr 3: Serwer" class="server">
Ten przykład tworzy pickup o symbolu dolara, który daje graczowi 100$ po wejściu w niego.
<syntaxhighlight lang="lua">
local pickup = createPickup ( 1896.4000244141, -1950.9000244141, 13, 3, 1274, 10000 ) -- tworzymy pickup...
function poWejsciuWPickup ( gracz )
  givePlayerMoney ( gracz, 100 ) -- ...oraz funkcję dającą graczowi pieniądze...
end
addEventHandler ( "onPickupUse", pickup, poWejsciuWPickup ) -- ...a następnie podłączamy ją pod eventHandler</syntaxhighlight>
</section>
 
<br/>
''Autor: [[User:GabWas|GabWas]]; utworzono: 22:30, 20 Lip 2016 (CEST)''
<br/>''Author: [[User:GabWas|GabWas]]; created: 20:30, 20 Jul 2016 (UTC)''
 
==Zobacz także==
{{Player functions}}
[[en:givePlayerMoney]]
[[ru:GivePlayerMoney]]

Revision as of 20:30, 20 July 2016

Dzięki tej funkcji możemy dodać graczowi dowolną ilość pieniędzy, bez uprzedniego sprawdzania stanu jego konta. Do zmieniania ilości pieniędzy, korzysta się z funkcji setPlayerMoney.

[[{{{image}}}|link=|]] Notatka: Używanie tej funkcji po stronie klienta (niepolecane) nie wpłynie na stan konta gracza po stronie serwera.

Składnia (syntax)

Click to collapse [-]
Serwer
bool givePlayerMoney ( player thePlayer, int amount )

OOP Syntax Help! I don't understand this!

Method: player:giveMoney(...)
Variable: .money


Wymagane argumenty

  • thePlayer: element reprezentujący gracza, który otrzyma pieniądze.
  • amount: dodatnia liczba całkowita, określająca ile pieniędzy otrzyma gracz.
Click to collapse [-]
Klient
bool givePlayerMoney ( int amount )

OOP Syntax Help! I don't understand this!

Method: Player.giveMoney(...)


Wymagane argumenty

  • amount: dodatnia liczba całkowita, określająca ile pieniędzy otrzyma gracz.

Wynik

Zwraca true, jeżeli pieniądze zostały pomyślnie dodane. Zwraca false, jeżeli któryś z argumentów jest nieprawidłowy.

Przykłady

Click to collapse [-]
Przykład nr 1: Serwer oraz klient

Ten przykład tworzy komendę "pieniadze", dzięki której gracz może dać sobie dowolną ilość pieniędzy korzystając z niej, np. /pieniadze 100

function dajMiPieniadze ( thePlayer, command, amount ) -- tworzymy funkcję dającą pieniądze...
   givePlayerMoney ( thePlayer, amount ) -- ...dajemy graczowi tyle pieniądzy, ile sobie zażyczył...
end
addCommandHandler ( "pieniadze", dajMiPieniadze ) -- ...ale oczywiście nie zapominamy podłączyć funkcji pod commandHandler
Click to collapse [-]
Przykład nr 2: Serwer

Ten przykład daje graczowi 1000$ po zabiciu innego gracza.

function nagrodaZaZabicie ( amunicja, zabojca )
   -- jeżeli znaleziono zabójcę i nie jest ona ofiarą...
   if ( zabojca ) and ( zabojca ~= source ) then
      givePlayerMoney ( zabojca, 1000 ) -- ...to dajemy mu pieniądze...
   end
end
addEventHandler ( "onPlayerWasted", getRootElement(), nagrodaZaZabicie ) -- ...i nie zapominamy podłączyć funkcji pod eventHandler
Click to collapse [-]
Przykład nr 3: Serwer

Ten przykład tworzy pickup o symbolu dolara, który daje graczowi 100$ po wejściu w niego.

local pickup = createPickup ( 1896.4000244141, -1950.9000244141, 13, 3, 1274, 10000 ) -- tworzymy pickup...
function poWejsciuWPickup ( gracz )
   givePlayerMoney ( gracz, 100 ) -- ...oraz funkcję dającą graczowi pieniądze...
end
addEventHandler ( "onPickupUse", pickup, poWejsciuWPickup ) -- ...a następnie podłączamy ją pod eventHandler


Autor: GabWas; utworzono: 22:30, 20 Lip 2016 (CEST)
Author: GabWas; created: 20:30, 20 Jul 2016 (UTC)

Zobacz także

Shared