Skip to content

♟ Web Implementation of GamesmanClassic ♟(Most of the games are currently broken as we are transitioning to a new version of data format.)

License

Notifications You must be signed in to change notification settings

liou-avery/GamesmanUni

 
 

Repository files navigation

GamesmanUni is a web implementation of GamesmanClassic in C, developed as part of GamesCrafters research and development group at University of California, Berkeley. Gamesman is a finite, two-person, perfect-information game generator based on Master thesis by Professor Dan Garcia.

Installation

  1. Clone GamesmanUni repository on GitHub.
  2. Install Yarn node package manager.
  3. Navigate to the root of the repository.
  4. Install external libraries.

The detailed installation process may be different depending on whether you already have Git, Homebrew and/or Yarn installed previously, how you have configured to use on your device, and the medium through which you wish to install them.

Personally, I connect to GitHub with SSH and use Homebrew. So, below is my installation process as an example.

git clone git@github.com:GamesCrafters/GamesmanUni.git uni
brew install yarn
cd uni
yarn install

Usage

Development Version

  • Open the repository in your prefered editor.
  • Start the development local server (and optionally launch the site automatically and locally in the default browser upon the server is ready).
  • Follow the contributing section below starting from coding all the way to pull request.

Personally, I use Visual Studio Code Insider with Vetur and Prettier in their default settings for syntax highlighting and pre-commit linting. So, below is my usual process as an example.

code-insider uni
yarn serve --open

Deployment/Production Version

  • Build the project and production ready GamesmanUni to be deployed/distributed will be automatically generated in dist folder in the project root directory.

Personally, I follow Vue CLI's deployment guide to deploy production ready GamesmanUni locally. I use node package serve to locally run the production version of GamesmanUni, which I installed globally using Yarn: yarn global add serve. So, below is my usual deployment as an example.

yarn build
serve -s dist

Documentation

For more information about the project and contribution guide, please visit GamesmanUni Documentation.

License

GPL-3.0

Acknowledgment

I started this project initially under code name uni after I first joined GamesCrafters Undergraduate Research and Development Group under Professor Dan Garcia at University of California, Berkeley. It was inspired by the old front end JQuery project, GamesmanGui, developed in collaboration with the back end team using Universal Web API, GamesCraftersUWAPI, through a weekly agile software development cycle. I would love to thank Prof. Dan for guiding all of us with computational game theory research, Seth and his back end teams for working in tandem with the front end team patiently (especially with my constant nudges! 😅), the newly formed design team for the new and exciting UI/UX updates to come, and last but not least my amazing front end team members for bearing with difficult me throughout this whole engineering, designing and development journey!!!

❣️ Developed with 💙 at University of California, Berkeley. ❣️

🐻 Go Bears! 🐻

🐼 Shein Lin Phyo 🐧

About

♟ Web Implementation of GamesmanClassic ♟(Most of the games are currently broken as we are transitioning to a new version of data format.)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Vue 61.2%
  • TypeScript 32.4%
  • SCSS 3.9%
  • JavaScript 2.0%
  • Other 0.5%