Skip to content

⛳️ realgolf.games: The first and only trainings platform for golfers ⛳️

License

Notifications You must be signed in to change notification settings

realgolf/realgolf

Repository files navigation

RealGolf.Games Banner

Read this in other languages.

Deutsch Español Français Italiano Português

CI/CD Dynamic JSON Badge CodeQL Test Golf Codespell Build Kit Build Server
Issues GitHub issues by-label GitHub issues by-label GitHub issues by-label
Stats Crowdin GitHub repo size Lines of code wakatime GitHub package.json version

RealGolf is a trainings platform for Golfers, you can play three different games to have more fun training. It is the first golf trainings platform.

It features three different games: 4Winning, Exact, and Precision. Each game has its own unique set of rules and objectives, providing a diverse and engaging experience for players. RealGolf also offers local multiplayer functionality, allowing users to compete against each other on the same device. The platform includes user authentication with MongoDB, enabling players to create accounts and track their progress. RealGolf is designed to be accessible and user-friendly, making it easy for golfers of all skill levels to enjoy the games and improve their skills.

RealGolf written in Svelte, relies on SvelteKit as well as NodeJS. NodeJS is used to provide a asynchronous node server for cross-client and database communication. SvelteKit is used as the full stack version of Svelte. Web Socket connections are handled by the Node server directly. MongoDB is used to store user accounts as well as course data. HTTP requests are handled by Render. The web client is written in TypeScript and Svelte. The server is written in TypeScript and compiled into JavaScript. SASS is used to generate CSS. Please help us translate RealGolf with Crowdin.

Production Architecture (as of April 2024)

RealGolf server site production architecture diagram

Usage and Features

RealGolf.Games Web offers the following features:

  • 3 different Golf Games, which include
    • 4Winning
    • Exact
    • Precision
  • Local multiplayer functionality for users to play against each other on the same device.
  • User Authentication with MongoDB
  • Trainings Planner
  • Golf Course Score Tracker Development paused #714
  • Feature issue #715 raised for implementing remote multiplayer, enabling users to compete against each other online.
  • Feature issue #802 raised for implemening a swing analyzer tool, allowing users to analyze their swings and improve their technique.
  • Feature issue #726 raised for implementing a Quiz App about Golfrules, allowing users to improve their knowledge of the rules.
  • Feature issue #719 raised for implementing a global leberboard for Precision.

Games

  • 4Winning
  • Exact
  • Precision
View information about all the games

4Winning

In 4Winning, the objective is to strategically connect four pieces in a row. Our version of the game features a larger board than the standard 4x4 layout, with 8 columns and 9 rows. The additional columns on each side introduce a challenge: players must hit a specific distance within the lateral deviation. This aspect becomes more pronounced in Silver Mode and above, adding complexity and requiring players to carefully consider their moves.

4Winning Game

Exact

Exact is a game where the objective is to hit 100 or below while scoring the most points. Players earn points based on the following criteria: Achieving exactly 100 meters awards 5 points, hitting multiples of ten earns 3 points, numbers with repeating digits score 2 points. Additionally, hitting the same row doubles the points earned. However, any other number exceeding 100 or falling below 5 results in a deduction of 1 point. Every other number between 5 and 100 scores 1 point. The challenge lies in balancing accuracy with maximizing points to achieve the highest score.

Exact Game

Precision

Precision is a game where the objective is to get as close to the targets as possible. For every meter you miss the target, you will receive a deduction of one point. The winner of the game is the player with the highest points at the end. The game concludes until only one player has points remaining. You can observe the distance you need to shoot and the current team, along with the remaining points for each team.

Precision Game

License

RealGolf is licensed under the All Rights Reserved License.

Contact

For inquiries or feedback, feel free to reach out:

Thank you for being a part of the RealGolf community!