Welcome to the 3D Web Games Directory! This repository serves two purposes:
- Data source for the interactive 3D game browser at https://3dwebgames.com
- Traditional directory listing organized by category (see below)
๐ Full Index: View All Games
- Card & Board Games
- Horror Games
- MMO Games
- Puzzle Games
- Racing Games
- Sandbox Games
- Sports Games
- Survival Games
- Other Games
You only need to add one file. You can do it entirely in the GitHub website, no git required:
- Open the
gamesfolder and click Add file โ Create new file. - Name the file
games/your-game-name/game.json. Use lowercase letters, numbers, dots and dashes for the folder name, for examplegames/space-racer/game.json. - Paste this in and fill it out:
{ "title": "Your Game Title", "url": "https://your-game-url.com/", "description": "What the game is and why it's fun (20-600 characters).", "how_to_play": "Controls and goal, e.g. WASD to move, mouse to aim (10-600 characters).", "category": "Action" } - Click Commit changes โ Propose changes, then Create pull request.
An automatic check runs on your pull request and comments on anything that needs fixing. After the PR is merged, a screenshot and thumbnail are generated automatically, and the game shows up on 3dwebgames.com.
| Field | Required | Notes |
|---|---|---|
title |
yes | 2-80 characters |
url |
yes | Must start with https:// |
description |
yes | 20-600 characters, plain text (no HTML) |
how_to_play |
yes | 10-600 characters, plain text (no HTML) |
category |
yes | One of: Action, Adventure, Battle Royale, Card & Board, Death Match, Fighting, FPS, Horror, MMO, Platformer, Puzzle, Racing, RPG, RTS, Sandbox, Shooter, Simulator, Sports, Strategy, Survival, Other |
Don't add screenshot or thumbnail. They are generated for you. If your page has an og:image meta tag, it is used as the cover. Otherwise a screenshot of the page is taken.
- It's a 3D game that runs in a modern browser, with no download required.
- It's appropriate for a general audience.
- The URL goes straight to the game (or its landing page), not to an app store.
- The page doesn't use misleading ads, such as ads styled as "Play" or "Continue" buttons. Listings that pick these up later are removed.
Example game.json:
{
"title": "Bruno Simon Portfolio",
"url": "https://bruno-simon.com/",
"description": "An interactive 3D portfolio where you drive a car through a playful environment",
"how_to_play": "Use WASD or arrow keys to drive the car. Click and drag to look around. On mobile, use the virtual joystick!",
"category": "Other"
}- ๐จ 3D Interface: https://3dwebgames.com
- ๐ Category Pages: Browse the categories above
- ๐ Full Index: View All Games
Please be respectful and constructive when submitting games or interacting with the community. All submissions must be appropriate for a general audience and comply with our guidelines.
MIT License. See LICENSE for details.
Three GitHub Actions workflows handle everything:
- Validate games (
.github/workflows/validate.yml) runs on every pull request. It checks eachgame.json(required fields,https://URL, category, no HTML, no duplicates) and adds annotations to the PR explaining what to fix. It also warns if a submission changes files other than itsgame.json. - Process games (
.github/workflows/process-games.yml) runs when agame.jsonlands onmain. It takes the screenshot and thumbnail, rebuildsindex.jsonandcategories/*.md, and commits the result. The browser that opens contributor URLs runs with a read-only token. A separate job with write access commits only the generated files. If a game's site is down or returns an error, its existing screenshot is kept (a new game gets a grey placeholder). When a game is removed, it rebuilds the index without it. To redo a screenshot, run the workflow by hand from the Actions tab and enter the game ids, or leave the field blank to redo every game. - Audit games (
.github/workflows/audit-games.yml) runs monthly and opens an issue for listings that have gone offline or changed. See Monthly audit below.
So adding a game is: review the PR โ merge. 3dwebgames.com picks up the new index.json the next time its update script runs.
Audit games (.github/workflows/audit-games.yml) runs on the 1st of each month, or by hand from the Actions tab. It opens every listed game in a browser and grades it:
- down: the domain is gone, the server refuses connections, the certificate is invalid, or the page returns 404/410/5xx.
- needs a look: the address now goes to a different site or away from the game's page, the page title no longer mentions the game, the page is blank or looks parked, or the site blocked the request.
- ok: everything else.
When anything is flagged, it opens an issue titled "Game audit: games that need a look" (or adds a comment to the open one) with the list and reasons. Screenshots of every game are in the run's audit-report artifact; the contact sheets (sheet-1.jpg, ...) are the quickest way to spot a site that still responds but is no longer the game. Nothing is removed automatically: fix or delete the listing in a pull request.
"Needs a look" is often a healthy site that blocks automated visitors. Once you've confirmed a game is fine, add it to scripts/audit-ignore.json as "game-id": "reason" and it stops being flagged unless it actually goes down.
GitHub pauses scheduled workflows in a repository with no activity for 60 days, and emails you first. Re-enable it from the Actions tab if that happens.
Run it locally with npm run audit (add -- game-id for specific games, or -- --no-browser for a quick HTTP-only check). The report goes to audit-report/. npm run audit:docker does the same inside a container that has no access to your files, which is the safer way to open sites you don't know; it needs Docker running.
A scheduled Claude task on the maintainer's computer searches the web once a month for new 3D browser games and opens one pull request with candidates for you to prune. It loads candidate sites only inside a locked-down Docker container (npm run audit:docker), never in a browser on the computer itself. It follows docs/finding-new-games.md, which lists what qualifies, where it looks and what it must not do (it never merges). Games it rejected, and games you drop from its pull requests, go in scripts/search-declined.json so they aren't proposed again. To suggest games yourself, such as ones you saw on social media, open an issue titled "Games to check" and paste the links; the next search picks them up.
Each game has two images, both made by scripts/take-screenshots.js from the page's og:image (or a screenshot when there isn't one, or it's under 600px wide):
- the cover in
games/<id>/screenshots/: up to 1200px wide, shown in the store's game panel and in social previews; - the card at
games/<id>/images/thumb.jpg: exactly 800x420, shown on the list pages at 3dwebgames.com/games. Square or tall art is fitted on a blurred copy of itself rather than cropped.
npm run images rebuilds every card (and re-encodes any cover that isn't a JPEG up to 1200px wide) from the covers already in the repo, without visiting any site. Run it after changing scripts/lib/images.js. To replace a weak cover, put a better image in the game's screenshots/ folder under the same file name and run npm run images -- <id>.
Requires Node.js 20+ and PHP 8+.
npm install
npx puppeteer browsers install chrome # first time only
npm run validate # check every game.json
npm run process -- space-racer # validate + screenshot + rebuild index for one or more gamesscripts/update-games.sh (pull main, process games changed since .last_processed_commit, rebuild the index) still works for cron-style local runs, but the GitHub workflow makes it unnecessary.
The category list lives in scripts/categories.json and is shared by the validator and the category page generator.
GreenRobot Sites:
- GreenRobot LLC Homepage - GreenRobot LLC Homepage
- Robot Designs - Check out thousands of robot designs
- AI Careers - Find thousands of Artificial Intelligence and Machine Learning (AI/ML) careers. Updated every few hours with new jobs from VC funded companies.
- Longevity - Information, research and interactive tools focused on longevity.
- Launch Day - Get your site ready for launch with this collaborative marketing and tech validation check list.
- Remote Dev Jobs - Find thousands of Remote Developer/Engineer jobs. Updated every few hours with new jobs from VC funded companies.
- Mental Health Lawyers - Directory of Mental Health Lawyers in the USA for involuntary commitment and guardianship issues.
- 3D Web Games - Discover 3D web games in this curated directory in the style of a video game store/Blockbuster.
- 3D Tank Battle - Fun free tank survival game. No login or app required.
- Cartoonify - Turn Yourself Into A Cartoon for Free.
- Job Search - Discover jobs at portfolio companies backed by Venture Capitalists
- Wizard Writer - Automatically write blog posts
- Pirate Game - Ahoy! Sail the high seas in this pirate game.
- Open Space Game - Explore space in this open source space game for iOS and Mac.