Zombie Mode - Revision history

Thoun: /* Implementing the Zombie mode */

2025-09-25T17:26:04Z

Implementing the Zombie mode

← Older revision		Revision as of 19:26, 25 September 2025
Line 54:		Line 54:
	Example of Zombie level 1		Example of Zombie level 1
	<pre>		<pre>
	function zombie(int $playerId): void {		function zombie(int $playerId, array $args): void {
	~~$args = $this->getArgs();~~

	// random choice over possible moves		// random choice over possible moves
	$zombieChoice = $this->getRandomZombieChoice($args['playableCardsIds']);		$zombieChoice = $this->getRandomZombieChoice($args['playableCardsIds']);
Line 67:		Line 65:
	Example of Zombie level 2		Example of Zombie level 2
	<pre>		<pre>
	function zombie(int $playerId): void {		function zombie(int $playerId, array $args): void {
	~~$args = $this->getArgs();~~
	$possibleSpaces = $args['possibleSpaces'];		$possibleSpaces = $args['possibleSpaces'];
	$playerCards = $this->getPlayerCards($playerId);		$playerCards = $this->getPlayerCards($playerId);

Thoun at 08:10, 23 September 2025

2025-09-23T08:10:37Z

← Older revision		Revision as of 10:10, 23 September 2025
Line 38:		Line 38:
	* The idea is NOT to develop an artificial intelligence for the game.		* The idea is NOT to develop an artificial intelligence for the game.
	* Do not try to end the game early, even in a two-player game. The zombie is there to allow the game to continue, not to end it.		* Do not try to end the game early, even in a two-player game. The zombie is there to allow the game to continue, not to end it.

			When you have developed the Zombie Mode, you can indicate the level you made in the Game Metadata Manager. If some parts are one level and some are another level, indicate the predominant one. In case of a tie, indicate the lowest one.

	== Implementing the Zombie mode ==		== Implementing the Zombie mode ==

Thoun: /* Testing the Zombie mode */

2025-09-19T15:02:13Z

Testing the Zombie mode

← Older revision		Revision as of 17:02, 19 September 2025
Line 108:		Line 108:
	}		}
	</pre>		</pre>
	Click on the debug icon on the top right, select "playToEndRound", and see the bot playing automatically until it reaches the ~~ST_MULTIPLAYER_BEFORE_END_ROUND state~~!		Click on the debug icon on the top right, select "playToEndRound", and see the bot playing automatically until it reaches the round 2!

	== Implementing the Zombie mode (if you're not using State classes) ==		== Implementing the Zombie mode (if you're not using State classes) ==

Thoun: /* Testing the Zombie mode (if you're not using State classes) */

2025-09-19T15:01:58Z

Testing the Zombie mode (if you're not using State classes)

← Older revision		Revision as of 17:01, 19 September 2025
Line 215:		Line 215:
	}		}
	</pre>		</pre>
	Click on the debug icon on the top right, select "playToEndRound", and see the bot playing automatically until it reaches the ~~ST_MULTIPLAYER_BEFORE_END_ROUND state~~!		Click on the debug icon on the top right, select "playToEndRound", and see the bot playing automatically until it reaches the round 2!

	[[Category:Studio]]		[[Category:Studio]]

Thoun: /* The different Zombie levels */

2025-09-19T09:54:21Z

The different Zombie levels

← Older revision		Revision as of 11:54, 19 September 2025
Line 31:		Line 31:


	Ideally, aim for level 1 or 2 for your implementation. For solo-only games, there's no need for a smart zombie, so ~~you~~ level 0 is fine.		Ideally, aim for level 1 or 2 for your implementation. For solo-only games, there's no need for a smart zombie, so level 0 is fine.

	While developing your zombie mode, keep in mind that:		While developing your zombie mode, keep in mind that:

Thoun at 09:41, 19 September 2025

2025-09-19T09:41:38Z

← Older revision		Revision as of 11:41, 19 September 2025
Line 110:		Line 110:
	Click on the debug icon on the top right, select "playToEndRound", and see the bot playing automatically until it reaches the ST_MULTIPLAYER_BEFORE_END_ROUND state!		Click on the debug icon on the top right, select "playToEndRound", and see the bot playing automatically until it reaches the ST_MULTIPLAYER_BEFORE_END_ROUND state!

	== Implementing the Zombie mode (~~before~~ State classes) ==		== Implementing the Zombie mode (if you're not using State classes) ==

	Each time a zombie player must play, your "zombieTurn" method is called.		Each time a zombie player must play, your "zombieTurn" method is called.
Line 193:		Line 193:
	'''Very important''': your zombie code will be called when the player leaves the game. The server will handle the Zombie turn, so there is no current player associated to this action. In your zombieTurn function, you must '''never''' use <code>getCurrentPlayerId()</code> or <code>getCurrentPlayerName()</code>, but use <code>$active_player</code> or <code>$this->getPlayerNameById($active_player)</code> instead.		'''Very important''': your zombie code will be called when the player leaves the game. The server will handle the Zombie turn, so there is no current player associated to this action. In your zombieTurn function, you must '''never''' use <code>getCurrentPlayerId()</code> or <code>getCurrentPlayerName()</code>, but use <code>$active_player</code> or <code>$this->getPlayerNameById($active_player)</code> instead.

	== Testing the Zombie mode ==		== Testing the Zombie mode (if you're not using State classes) ==
	Create a table in Friendly mode (the infinite time symbol if you're starting from the game page) and Express Start.		Create a table in Friendly mode (the infinite time symbol if you're starting from the game page) and Express Start.

Thoun: /* Implementing the Zombie mode */

2025-09-19T09:40:47Z

Implementing the Zombie mode

← Older revision		Revision as of 11:40, 19 September 2025
Line 54:		Line 54:
	function zombie(int $playerId): void {		function zombie(int $playerId): void {
	$args = $this->getArgs();		$args = $this->getArgs();
	$zombieChoice = $this->getRandomZombieChoice($args['playableCardsIds']); ~~// random choice over possible moves~~
	~~return $this->actPlayCard($zombieChoice, $playerId, $args);~~ // this function will return the state to go to, so we return it to end the zombie function		// random choice over possible moves
			$zombieChoice = $this->getRandomZombieChoice($args['playableCardsIds']);

			// this function will return the state to go to, so we return it to end the zombie function
			return $this->actPlayCard($zombieChoice, $playerId, $args);
	}		}
	</pre>		</pre>
Line 68:		Line 72:
	$possibleAnswerPoints = [];		$possibleAnswerPoints = [];
	foreach ($possibleSpaces as $choice) {		foreach ($possibleSpaces as $choice) {
	$possibleAnswerPoints[$choice] = $this->getPointsFromState3Choice($playerCards, $choice); ~~// for each possible choice, compute the points the player/Bot would immediately gain~~		// for each possible choice, compute the points the player/Bot would immediately gain
			$possibleAnswerPoints[$choice] = $this->getPointsFromState3Choice($playerCards, $choice);
	}		}

	~~$zombieChoice = $this->getBestZombieChoice($possibleAnswerPoints);~~ // get top choice over possible moves		// get top choice over possible moves
	~~return~~ $this->~~actPlayCard~~($~~zombieChoice, $playerId, $args~~); // this function will return the state to go to, so we return it to end the zombie function		$zombieChoice = $this->getBestZombieChoice($possibleAnswerPoints);

			// this function will return the state to go to, so we return it to end the zombie function
			return $this->actPlayCard($zombieChoice, $playerId, $args);
	}		}
	</pre>		</pre>

Thoun at 09:39, 19 September 2025

2025-09-19T09:39:40Z

@@ Line 40: / Line 40: @@
 == Implementing the Zombie mode ==
 Each time a zombie player must play, your "zombieTurn" method is called.
@@ Line 137: / Line 200: @@
        while ($this->globals->get(ROUND) == $currentRound && $security < 100) {
          $security++;
-         $state = intval($this->gamestate->state_id());
+         foreach($this->gamestate->getActivePlayerList() as $playerId) {
-        $playerId = intval($this->getActivePlayerId());
+            $playerId = (int)$playerId;
-        switch ($state) {
+             $this->zombieTurn($this->gamestate->getCurrentState($playerId)->toArray(), $playerId);
+         }
+       }

Thoun at 09:25, 19 September 2025

2025-09-19T09:25:58Z

← Older revision		Revision as of 11:25, 19 September 2025
Line 30:		Line 30:


	Ideally, aim for level 1 or 2 for your implementation.
			Ideally, aim for level 1 or 2 for your implementation. For solo-only games, there's no need for a smart zombie, so you level 0 is fine.

	While developing your zombie mode, keep in mind that:		While developing your zombie mode, keep in mind that:

Thoun: /* The different Zombie levels */

2025-09-09T13:38:00Z

The different Zombie levels

← Older revision		Revision as of 15:38, 9 September 2025
Line 12:		Line 12:
	:Just pass to the next step without doing any action		:Just pass to the next step without doing any action
	:''For example, in 7 wonders, take a random card and discard it (we cannot just pass in this game as it would mess with the next player hand)''		:''For example, in 7 wonders, take a random card and discard it (we cannot just pass in this game as it would mess with the next player hand)''
			:''For example, in Catan, roll the dice and pass''

	;<nowiki>Level 1: the random zombie</nowiki>		;<nowiki>Level 1: the random zombie</nowiki>
	:Code a random possible action		:Code a random possible action
	:''For example, in 7 wonders, take a random card and play it''		:''For example, in 7 wonders, take a random card and play it''
			:''For example, in Catan, roll the dice and take a random possible action''

	;<nowiki>Level 2: the greedy zombie</nowiki>		;<nowiki>Level 2: the greedy zombie</nowiki>
	:Take the action that will bring the most value given the visible information. Isn't planning for future move, nor remember previously known information. Does not try to take a lower value in order to block the opponent.		:Take the action that will bring the most value given the visible information. Isn't planning for future move, nor remember previously known information. Does not try to take a lower value in order to block the opponent.
	:''For example, in 7 wonders, take a card that will bring the most points to the players. If there is a tie, the one that will cost less. If there is still a tie, randomly in the subset''		:''For example, in 7 wonders, take a card that will bring the most points to the players. If there is a tie, the one that will cost less. If there is still a tie, randomly in the subset''
			:''For example, in Catan, roll the dice and play the action that will bring the most points to the players''

	;<nowiki>Level 3: the smart zombie</nowiki>		;<nowiki>Level 3: the smart zombie</nowiki>
	:Can plan and/or remember previously revealed information.		:Can plan and/or remember previously revealed information.
	:''For example, in 7 wonders, it could remember which cards could be back in the next turn to make the best move.''		:''For example, in 7 wonders, it could remember which cards could be back in the next turn to make the best move.''
			:''For example, in Catan, instead of declining all trades for zombie, trade only if it's in the benefit of the zombie player''