PL/Client side scripts - Revision history

Tracer: Updated syntax

2022-06-25T17:44:03Z

Updated syntax

← Older revision		Revision as of 17:44, 25 June 2022
Line 25:		Line 25:
	'''Client-side:'''		'''Client-side:'''
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function recvRandomPlayer(~~randompn~~)		function recvRandomPlayer(player)
	outputChatBox("Serwer wylosował gracza o nazwie:" .. ~~randompn~~)		outputChatBox("Serwer wylosował gracza o nazwie: " .. player)
	end		end

Line 36:		Line 36:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	addEvent("recvRandomPlayer", true)		addEvent("recvRandomPlayer", true)
	addEventHandler("recvRandomPlayer", ~~getRootElement()~~,		addEventHandler("recvRandomPlayer", root, function ( player )
	function ( ~~randompn~~ )		outputChatBox("Serwer wylosował gracza o nazwie: " .. player)
	outputChatBox("Serwer wylosował gracza o nazwie:" .. ~~randompn~~)		end)
	end
	)
	</syntaxhighlight>		</syntaxhighlight>

	'''Server-side:'''		'''Server-side:'''
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	triggerClientEvent ( ~~gracz,~~ "recvRandomPlayer", ~~getRootElement()~~, getPlayerName( getRandomPlayer() ) )		triggerClientEvent ( "recvRandomPlayer", root, getPlayerName( getRandomPlayer() ) )
	</syntaxhighlight>		</syntaxhighlight>

	[[it:Script client-side]]		[[it:Script client-side]]

Darqnies: /* Jak to działa? */

2010-02-27T13:40:37Z

Jak to działa?

← Older revision		Revision as of 13:40, 27 February 2010
Line 17:		Line 17:
	</syntaxhighlight>		</syntaxhighlight>

	Komunikacja pomiędzy skryptami klienckimi i serwerowymi (i odwrotnie) odbywa się za pomocą funkcji [[triggerClientEvent]] i [[triggerServerEvent]]. Owe funkcje wysyłają żądanie wykonania danej funkcji (pierwszy/~~drugi~~ parametr funkcji [[triggerClientEvent]] i pierwszy [[triggerServerEvent]]).		Komunikacja pomiędzy skryptami klienckimi i serwerowymi (i odwrotnie) odbywa się za pomocą funkcji [[triggerClientEvent]] i [[triggerServerEvent]]. Owe funkcje wysyłają żądanie wykonania danej funkcji (pierwszy/trzeci parametr funkcji [[triggerClientEvent]] i pierwszy [[triggerServerEvent]]).
	Komunikacja polega na ''wywoływaniu zdarzeń''. Zanim jednak będziemy mogli wywołać przez serwer zdarzenie u klienta, należy zarejestrować zdarzenie w skrypcie klienckim - funkcją [[addEvent]]. Następnie do zdarzenia przypisujemy uchwyt (lub uchwyty bo liczba uchwytów do danego zdarzenia nie jest z góry ograniczona) - funkcją [[addEventHandler]]. W tym momencie serwer ma możliwość wywołania zdarzenia o podanej przez nas nazwie (przy użyciu addEvent/addEventHandler).		Komunikacja polega na ''wywoływaniu zdarzeń''. Zanim jednak będziemy mogli wywołać przez serwer zdarzenie u klienta, należy zarejestrować zdarzenie w skrypcie klienckim - funkcją [[addEvent]]. Następnie do zdarzenia przypisujemy uchwyt (lub uchwyty bo liczba uchwytów do danego zdarzenia nie jest z góry ograniczona) - funkcją [[addEventHandler]]. W tym momencie serwer ma możliwość wywołania zdarzenia o podanej przez nas nazwie (przy użyciu addEvent/addEventHandler).
	Jeżeli chcemy działać w drugą stronę (tzn. komunikować się z klienta do serwera) musimy powtórzyć powyższe kroki, z tym że do wywołania zdarzenia znajdującego się na serwerze klient musi użyć funkcji [[triggerServerEvent]].		Jeżeli chcemy działać w drugą stronę (tzn. komunikować się z klienta do serwera) musimy powtórzyć powyższe kroki, z tym że do wywołania zdarzenia znajdującego się na serwerze klient musi użyć funkcji [[triggerServerEvent]].

Darqnies: little mistake :P

2010-02-27T13:39:41Z

little mistake :P

← Older revision		Revision as of 13:39, 27 February 2010
Line 1:		Line 1:
	Skrypty typu ''clientside'' to skrypty działające po stronie klienta. Oznacza to, że mają one dostęp do większej ilości informacji o grze (bo działają równolegle z nią), ale mniej o serwerze i innych graczach na nim się znajdujących.		Skrypty typu ''clientside'' to skrypty działające po stronie klienta. Oznacza to, że mają one dostęp do większej ilości informacji o grze (bo działają równolegle z nią), ale mniej o serwerze i innych graczach na nim się znajdujących.

	~~This is useful for things that need to be done client-side, such as visual effects, creation and manipulation of GUI elements.~~
	Są przydatne do rzeczy takich jak efekty wizualne (rysowanie funkcjami dx*), tworzeniem i modyfikowaniem elementów GUI.		Są przydatne do rzeczy takich jak efekty wizualne (rysowanie funkcjami dx*), tworzeniem i modyfikowaniem elementów GUI.

Darqnies: Added some new code modification and also translated all the page to Polish.

2010-02-27T13:24:47Z

Added some new code modification and also translated all the page to Polish.

New page

Skrypty typu ''clientside'' to skrypty działające po stronie klienta. Oznacza to, że mają one dostęp do większej ilości informacji o grze (bo działają równolegle z nią), ale mniej o serwerze i innych graczach na nim się znajdujących.

This is useful for things that need to be done client-side, such as visual effects, creation and manipulation of GUI elements.
Są przydatne do rzeczy takich jak efekty wizualne (rysowanie funkcjami dx*), tworzeniem i modyfikowaniem elementów GUI.

==Jak to działa?==
Skrypty ''clientside''owskie są bardzo podobne do skryptów ''serverside''owskich (tych działających po stronie serwera).

Skrypty serwerowe i klienckie bazują na bardzo podobnym systemie zdarzeń. Skrypty serwerowe i klienckie muszą znajdować się w różnych plikach, a każdy plik musi posiadać wpis w pliku meta.xml (tag <script> i atrybut ''type'' przyjmujący wartości ''server'' dla skryptów serwerowych i ''client'' dla skryptów klienckich).

Przykład (''meta.xml''):
<syntaxhighlight lang="xml">

<meta>
<script src="guitest.lua" type="client" />
<info author="IJs" />
</meta>
</syntaxhighlight>

Komunikacja pomiędzy skryptami klienckimi i serwerowymi (i odwrotnie) odbywa się za pomocą funkcji [[triggerClientEvent]] i [[triggerServerEvent]]. Owe funkcje wysyłają żądanie wykonania danej funkcji (pierwszy/drugi parametr funkcji [[triggerClientEvent]] i pierwszy [[triggerServerEvent]]).
Komunikacja polega na ''wywoływaniu zdarzeń''. Zanim jednak będziemy mogli wywołać przez serwer zdarzenie u klienta, należy zarejestrować zdarzenie w skrypcie klienckim - funkcją [[addEvent]]. Następnie do zdarzenia przypisujemy uchwyt (lub uchwyty bo liczba uchwytów do danego zdarzenia nie jest z góry ograniczona) - funkcją [[addEventHandler]]. W tym momencie serwer ma możliwość wywołania zdarzenia o podanej przez nas nazwie (przy użyciu addEvent/addEventHandler).
Jeżeli chcemy działać w drugą stronę (tzn. komunikować się z klienta do serwera) musimy powtórzyć powyższe kroki, z tym że do wywołania zdarzenia znajdującego się na serwerze klient musi użyć funkcji [[triggerServerEvent]].

Przykład:

'''Client-side:'''
<syntaxhighlight lang="lua">
function recvRandomPlayer(randompn)
outputChatBox("Serwer wylosował gracza o nazwie:" .. randompn)
end

addEvent("recvRandomPlayer", true)
addEventHandler("recvRandomPlayer", getRootElement(), recvRandomPlayer)
</syntaxhighlight>

lub jak kto woli prościej:
<syntaxhighlight lang="lua">
addEvent("recvRandomPlayer", true)
addEventHandler("recvRandomPlayer", getRootElement(),
function ( randompn )
outputChatBox("Serwer wylosował gracza o nazwie:" .. randompn)
end
)
</syntaxhighlight>

'''Server-side:'''
<syntaxhighlight lang="lua">
triggerClientEvent ( gracz, "recvRandomPlayer", getRootElement(), getPlayerName( getRandomPlayer() ) )
</syntaxhighlight>

[[it:Script client-side]]