mirror of https://github.com/imjasonh/dodec synced 2026-07-07 01:32:17 +00:00

- Create GitHub Actions workflow to build TypeScript on push
- Deploy compiled files to GitHub Pages automatically
- Keep game.js out of main branch (stays in .gitignore)
- Update README with deployment instructions and game info

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-06-10 01:25:37 -04:00

2.1 KiB

Raw Permalink Blame History

Globetrotter

A 3D strategy game played on a snub dodecahedron planet. Control rovers to explore, conquer, and defend territories while building structures and engaging in tactical combat.

Play Online

Once GitHub Pages is set up, the game will be available at: https://[your-username].github.io/dodec/

Setup GitHub Pages

Go to your repository on GitHub
Click on "Settings" tab
Scroll down to "Pages" in the left sidebar
Under "Build and deployment":
- Source: Select "GitHub Actions"
Push to main branch or manually trigger the workflow
Wait a few minutes for the deployment
Your game will be live at the URL above!

Local Development

Prerequisites

Node.js (for TypeScript compilation)

Setup

Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```
Open index.html in your browser

Development Scripts

npm run build - Compile TypeScript to JavaScript
npm run dev - Watch mode for development (auto-rebuild on changes)
npm start - Build and open in browser

Project Structure

game.ts - TypeScript source code
game.js - Generated JavaScript (do not edit manually)
index.html - Main HTML file
tsconfig.json - TypeScript configuration
package.json - Project configuration and dependencies

Game Features

3D snub dodecahedron game board (92 faces)
Turn-based strategy for 2 players (Red vs Green)
Pentagon faces are strategic HQ spaces
Move, shoot, and fortify actions
Range-based combat with dice rolls
Fortifications block enemy movement
Win by eliminating all enemy rovers

Game Controls

Rotate Globe: Click and drag
Zoom: Scroll or pinch (limited range)
Select Unit: Click on your rover
Move: Click Move → Click adjacent face twice
Shoot: Click Shoot → Click enemy within range
Fortify: Click Fortify → Click empty adjacent space

Technical Features

Built with Three.js and TypeScript
Mathematical precision (60 vertices, 150 edges)
Mouse rotation controls
Face selection and highlighting
Click interactions for game logic
TypeScript for type safety

2.1 KiB Raw Permalink Blame History