Warlords#
This environment is part of the Atari environments. Please read that page first for general information.
Import  | 
  | 
|---|---|
Actions  | 
Discrete  | 
Parallel API  | 
Yes  | 
Manual Control  | 
No  | 
Agents  | 
  | 
Agents  | 
4  | 
Action Shape  | 
(1,)  | 
Action Values  | 
[0,5]  | 
Observation Shape  | 
(210, 160, 3)  | 
Observation Values  | 
(0,255)  | 
Four player last man standing!
Defend your fortress from the ball and hit it towards your opponents.
When your fortress falls, you receive -1 reward and are done. If you are the last player standing, you receive +1 reward.
Environment parameters#
Environment parameters are common to all Atari environments and are described in the base Atari documentation .
Action Space (Minimal)#
In any given turn, an agent can choose from one of 6 actions.
Action  | 
Behavior  | 
|---|---|
0  | 
No operation  | 
1  | 
Fire  | 
2  | 
Move up  | 
3  | 
Move right  | 
4  | 
Move left  | 
5  | 
Move down  | 
Version History#
v3: Minimal Action Space (1.18.0)
v2: Breaking changes to entire API (1.4.0)
v1: Fixes to how all environments handle premature death (1.3.0)
v0: Initial versions release (1.0.0)
Usage#
AEC#
from pettingzoo.atari import warlords_v3
env = warlords_v3.env(render_mode="human")
env.reset(seed=42)
for agent in env.agent_iter():
    observation, reward, termination, truncation, info = env.last()
    if termination or truncation:
        action = None
    else:
        # this is where you would insert your policy
        action = env.action_space(agent).sample()
    env.step(action)
env.close()
Parallel#
from pettingzoo.atari import warlords_v3
env = warlords_v3.parallel_env(render_mode="human")
observations, infos = env.reset()
while env.agents:
    # this is where you would insert your policy
    actions = {agent: env.action_space(agent).sample() for agent in env.agents}
    observations, rewards, terminations, truncations, infos = env.step(actions)
env.close()