EnvironmentWrapper

​

Properties

​

observation_space

• FrameDataRaw or None: The FrameDataRaw object from the last response, or None if no response has been set yet.

obs = env.observation_space
if obs:
    print(f"Game state: {obs.state}")
    print(f"Levels completed: {obs.levels_completed}")

​

action_space

• list[GameAction]: A list of GameAction objects representing available actions. Returns an empty list if no response has been set yet.

actions = env.action_space
print(f"Available actions: {[a.name for a in actions]}")

​

info

• EnvironmentInfo: The EnvironmentInfo object for this environment.

info = env.info
print(f"Game ID: {info.game_id}")
print(f"Title: {info.title}")
print(f"Tags: {info.tags}")

​

Methods

​

reset()

• FrameDataRaw or None: FrameDataRaw object with initial game state, or None if reset failed.

obs = env.reset()
if obs:
    print("Environment reset successfully")

​

step()

• action (GameAction): The game action to perform (e.g., GameAction.ACTION1, GameAction.ACTION2).
• data (dict[str, Any], optional): Optional action data dictionary. For complex actions, should contain "x" and "y" coordinates.
• reasoning (dict[str, Any], optional): Optional reasoning dictionary to include in recordings.

• FrameDataRaw or None: FrameDataRaw object with updated game state, or None if step failed.

from arcengine import GameAction

# Simple action
obs = env.step(GameAction.ACTION1)

# Complex action with coordinates
obs = env.step(
    GameAction.ACTION6,
    data={"x": 32, "y": 32},
    reasoning={"thought": "clicking center of screen"}
)

# Check game state after step
if obs and obs.state == GameState.WIN:
    print("Game won!")