{"repo":"swapnil404/mineSQL","free":true,"listed":false,"github":"https://github.com/swapnil404/mineSQL","clone":"git clone https://github.com/swapnil404/mineSQL.git","description":"A relational database using a minecraft world as storage.","language":"Go","stars":33,"topics":["database","database-engine","go","golang","minecraft","minecraft-mod","mvcc","postgres","postgresql","relational-database"],"license":"MIT","category":"databases-storage","readme_excerpt":"mineSQL A relational database engine that uses a Minecraft world as its physical storage backend. Connect with psql or chat /sql in-game. Run real SQL. Watch your data persist as blocks in the ground. --- Getting Started Prerequisites - Go 1.22+ - Docker + Docker Compose - psql (or any Postgres client) Run Wait for Minecraft to finish loading ( 30s), then connect: Dev Mode --- What It Is mineSQL is a Postgres-wire-compatible relational database engine written in Go. It implements real database internals — WAL, MVCC, a query executor, and a SQL parser — but instead of writing to disk, it stores every row as a strip of banner blocks and signs standing on grass in a live Minecraft world. Any tool that speaks Postgres works out of the box. psql , database drivers in any language, ORMs — none of them know they are talking to a Minecraft world. --- How Storage Works The world is the database. Spawn is the origin. Walk east — you are walking through your tables. Each table occupies a Z region on the surface starting at Z=0. Every row is a horizontal strip of standing banners and signs. Banner blocks encode INT, BIGINT, and BOOLEAN columns as heraldic pattern layers (6 bytes per banner, pattern type = high nibble, dye color = low nibble). Signs hold TEXT columns (64 chars per sign). Each row strip stands on the grass at Y=64, visible from above. Walk west — you are walking through the transaction log. Each WAL entry is a lectern block holding a written book. Open any lectern and read","default_branch":null,"files":null,"tree":[],"storefront":"/r/swapnil404","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/swapnil404/mineSQL/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}