PuzzleJAX: A Benchmark for Reasoning and Learning

Sam Earle, Graham Todd, Yuchen Li, Ahmed Khalifa, Muhammad Umair Nasir +3 more
8/22/2025
cs.AIcs.LG

No official code found. Best implementation: smearle/script-doctor (31 stars, MIT, last commit 2026-05-04).

Abstract

We introduce PuzzleJAX, a GPU-accelerated puzzle game engine and description language designed to support rapid benchmarking of tree search, reinforcement learning, and LLM reasoning abilities. Unlike existing GPU-accelerated learning environments that provide hard-coded implementations of fixed sets of games, PuzzleJAX allows dynamic compilation of any game expressible in its domain-specific language (DSL). This DSL follows PuzzleScript, which is a popular and accessible online game engine for designing puzzle games. In this paper, we validate in PuzzleJAX several hundred of the thousands of games designed in PuzzleScript by both professional designers and casual creators since its release in 2013, thereby demonstrating PuzzleJAX's coverage of an expansive, expressive, and human-relevant space of tasks. By analyzing the performance of search, learning, and language models on these games, we show that PuzzleJAX can naturally express tasks that are both simple and intuitive to understand, yet often deeply challenging to master, requiring a combination of control, planning, and high-level insight.

View on arXivView PDF

Code Implementations(1)

MIT

Code for PuzzleJAX, a benchmark for reasoning and learning, that reimplements PuzzleScript, a concise and expressive DSL and game engine for grid-based puzzle games, in JAX.

316C++, CSSMar 20, 20255 months agoMIT

Similar Papers

Cite this paper

@article{earle2025puzzlejax,
  title  = {PuzzleJAX: A Benchmark for Reasoning and Learning},
  author = {Sam Earle and Graham Todd and Yuchen Li and Ahmed Khalifa and Muhammad Umair Nasir and Zehua Jiang and Andrzej Banburski-Fahey and Julian Togelius},
  year   = {2025},
  eprint = {2508.16821},
  archivePrefix = {arXiv},
  url    = {http://arxiv.org/abs/2508.16821v1}
}

Add a badge to your README

Shows whether official code is linked for this paper.

Code of Paper badge
[![Code of Paper](https://codeofpaper.com/badge/2508.16821.svg)](https://codeofpaper.com/paper/2508.16821)

Discussion