Differences

This shows you the differences between two versions of the page.

--- scripting:subgames [2020/01/29 11:55] – created mit
+++ scripting:subgames [2025/05/28 18:58] (current) – external edit 127.0.0.1
@@ Line 13: / Line 13: @@
 === Basic Subgame Example ===
-TBD \\
+A general overview of an implementation of a RC duel subgame. (The full script for this as used on Lovelace will be available in the script examples sections):
+- Firstly - we'll choose an ID number for the subgame. If you've only got one subgame on the world, just using subgame 0 is fine, but if you want to have multiple games running simultaneously you'll need to allocate them different numbers. Might be good to set that up using a global variable so its easy to change later.. for this example we'll use **global $kCrowDuelSubgameID = 0**.
+- Now we get the two players into the subgame together e.g.
+<code>
+	SubgameJoin( $kCrowDuelSubgameID, $player1 )
+	SubgameJoin( $kCrowDuelSubgameID, $player2 )
+</code>
+<note>(In this example, $player1 and $player2 are the player IDs for the two players who want to play in the subgame. There are various techniques we can use to collect the IDs of the players involved - e.g. Send out a global notification message and join the $gPlayerID of everyone who accepts the prompt.. or you could use the [[scripting::subgames:SubgameDuels|Subgame Duels system]].)
+</note>
+- .. next we set up the RC game state ; setting the players spawn positions and lives, and locking the weapons
+<code>
+	*crowspawn $playerName1 176 75
+	*crowspawn $playerName2 177 70
+	*crowlives $playerName1 2
+	*crowlives $playerName2 2
+	*lockweapons $playerName1
+	*lockweapons $playerName2
+</code>
+- When we're ready to start (again, the [[scripting::subgames:SubgameDuels|Subgame Duels system]] provides helpers for controlling this), we activate the scoreboard and trigger an event for both the players in the duel..
+<code>
+	SubgameActivateScoreboard( $kCrowDuelSubgameID, 0 )
+	SubgameEventAll( $kCrowDuelSubgameID, "DuelStart", "" )
+</code>
+- We'll create the custom 'DuelStart' event to put the players in RC mode, get them players ready, unlock their weapons and set a timer for the end of the game, e.g:
+<code>
+Event( "Subgame", "DuelStart" )
+{
+	*gocrow %PLAYER%
+	*centraltext %PLAYER% Ready up. Round starts in 10 seconds..
+	Sleep( 70 )
+	*countdown %PLAYER% 3 0
+	Sleep( 30 )
+	*onscreentimer %PLAYER%,0,180
+	*unlockweapons %PLAYER%
+	SubgameSetTimer( $kCrowDuelSubgameID, 0, 180, "CrowDuelEndTimer", 0 )
+}
+</code>
+- While the players are duelling, the script listens in to **"RobocrowKill"** events, and tallies up the player scores using **SubgameIncrementScore**. Here we might also implement logic such as finishing the game if a player gets to a certain number of kills.
+- When the 'CrowDuelEndTimer'  expires (or some other winning criteria is met), we check the scores, award prizes and then finish off the subgame using **SubgameReset( $kCrowDuelSubgameID )**
+\\
 \\