gitwtfhub

wtf is gameengines?

fraserscottmorrison/gameengines — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · vibe coderComplexity · 2/5Setup · easy

TL;DR

A command-line, AI-built simulation of a Carcassonne-style tile placement board game played entirely by computer personas.

Mindmap

mindmap
  root((GameEngines))
    What it does
      Simulates tile game
      Scores roads and cities
      Logs every turn
    Tech stack
      Python
      JSON game state
      Markdown logs
    Use cases
      Watch AI personas play
      Study game engine logic
      Run automated matches
    Audience
      Hobbyist coders
      Board game fans
      AI experimenters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run a simulated Carcassonne-style board game between AI personas from the command line

REASON 2

Watch turn-by-turn logs to see how tiles, roads, and cities get scored

REASON 3

Study a fully AI-generated Python game engine as a coding example

REASON 4

Play or continue a game session by asking an AI assistant through the bundled skill

What's in the stack?

Python

How it stacks up

fraserscottmorrison/gameengines0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencevibe codergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires Python 3.10 or newer, no external packages needed.

No license information is provided in the repository, so default copyright rules apply and reuse permissions are unclear.

Wtf does this do

GameEngines is a text-based digital version of a tile-placement board game very similar to Carcassonne, built entirely by an AI language model. The author describes reading the rulebook, analyzing photos of the physical tiles, and writing all of the Python code through AI prompting alone, without personally writing any of it by hand. The game engine runs from the command line and simulates a full game between computer-controlled players. Ten different AI player personas are included, each with its own difficulty level and playing style, ranging from a cautious novice who builds small roads to an advanced player focused on blocking opponents. Players are set up as a comma-separated list when starting a new game, and the engine automatically draws tiles, places them, adds meeples where useful, and scores completed roads, cities, and monasteries turn by turn. Every game session is saved to its own folder containing a JSON file with the full game state and a readable Markdown log recording each turn's tile, placement, and score changes. A short summary table is produced at the end of a completed game showing final rankings and scores. The engine can be driven turn by turn, several turns at once, or all the way to completion in one command, and there are additional commands for checking legal moves, current scores, and the state of the tile deck. The project can also be played through an AI assistant using a bundled skill, letting a user simply ask the AI to start or continue a game rather than typing commands directly. The tool requires Python 3.10 or newer and has no external dependencies. As the author notes plainly, the game currently has no visual interface, no option for a human player to join, and the computer opponents do not always play well, especially at the higher difficulty settings.

Yoink these prompts

Prompt 1
Help me start a new GameEngines Carcassonne-style match with three personas
Prompt 2
Explain how the ten AI personas differ in difficulty and playing style
Prompt 3
Walk me through the turn-log.md and game-state.json files this engine produces
Prompt 4
Show me how to play a full game to completion using auto-play
Prompt 5
Explain how tile placement and scoring work in this engine's Python code

Frequently asked questions

wtf is gameengines?

A command-line, AI-built simulation of a Carcassonne-style tile placement board game played entirely by computer personas.

What language is gameengines written in?

Mainly Python. The stack also includes Python.

What license does gameengines use?

No license information is provided in the repository, so default copyright rules apply and reuse permissions are unclear.

How hard is gameengines to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is gameengines for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.