Skip to content

zhaodong-wang/pooltool

 
 

Repository files navigation

GitHub stars GitHub forks GitHub commit activity GitHub license Documentation Status

Intro

Pooltool is a general purpose billiards simulator crafted specifically for science and engineering.

Its core design principles focus on speed, flexibility, and the ease of visualization and analysis. With an interactive 3D interface, a robust API, and extensive documentation, pooltool aims to be a systemic tool in billiards-related research. Continuously evolving through active maintenance and bolstered by a growing community, this vision for pooltool emphasizes not just its current capabilities, but also its potential for growth and adaptation within billiards simulation.

Gallery

Installation / Documentation / API / Tutorials

Please check the documentation here.

Blog

I have blogged about many aspects of this project. Read the detailed account here.

Join the discussion

If you want to ask questions, get help, or contribute to the codebase, please join the Discord and introduce yourself.

Discord

If the Discord link is expired, please make an issue in this repo.

Contribute/collaborate

pooltool needs and welcomes contributors/collaborators of all skill levels who are excited about this project, but especially those who have skill or passion in:

  1. Game development (especially for the Panda3D game engine!)
  2. Creating 3D models (tables, balls, cues, rooms, etc)
  3. Projector/camera systems
  4. Computer vision / machine learning / reinforcement learning

Please reach out in the Discord.

About

A sandbox billiards game that emphasizes realistic physics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%