tile-match-gym 1.0.5

A set of reinforcement learning environments for tile matching games, consistent with the OpenAI Gymnasium API.

Tile Matching Reinforcement Learning Environments

Welcome to the Reinforcement Learning Environments for Tile Matching Games repository! Here you can find a collection of tile matching game environments (like Bejeweled or Candy Crush), poised to push reinforcement learning research forwards.

This genre of games is characterised by the following features, which we find useful for reinforcement learning research:

• Large action spaces
• Intuitive action hierarchies
• Procedurally generated levels
• Structured complex stochasticity in transition dynamics

Installation

You can install the package via pip:

pip install tile-match-gym

Example Usage

We follow the the Farama Foundation Gymnasium API:

from tile_match_gym.tile_match_env import TileMatchEnv

env = TileMatchEnv(
  num_rows=10, 
  num_cols=10, 
  num_colours=4, 
  num_moves=30, 
  colourless_specials=["cookie"], 
  colour_specials=["vertical_laser", "horizontal_laser", "bomb"], 
  seed=2
  render_mode="human",
  )

obs, _ = env.reset()

while True:
    action = env.action_space.sample()
    next_obs, reward, done, truncated, info = env.step(action)
    env.render()
    if done:
        break
    else:
      obs = next_obs

Citation

We'd love it if you use our package for your research! If you do use code from this repository please cite us as below:

@software{tile_match_gym,
  author = {Patel, Akshil and Elson, James},
  title = {{Tile Matching Game Reinforcement Learning Environments}},
  url = {https://github.com/akshilpatel/tile-match-gym},
  version = {1.0.5},
  year = {2023}
  }