PHPackages                             furic/game-essentials - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. furic/game-essentials

ActiveLibrary

furic/game-essentials
=====================

The essentials and basic data for a gaming backend server.

1.0.6(5y ago)57412MITPHPPHP ^7.2

Since Nov 2Pushed 4y ago1 watchersCompare

[ Source](https://github.com/furic/laravel-game-essentials)[ Packagist](https://packagist.org/packages/furic/game-essentials)[ Docs](https://github.com/furic/laravel-game-essentials)[ Fund](https://paypal.me/furic)[ GitHub Sponsors](https://github.com/furic)[ RSS](/packages/furic-game-essentials/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)Dependencies (1)Versions (8)Used By (2)

laravel-game-essentials
=======================

[](#laravel-game-essentials)

[![Packagist](https://camo.githubusercontent.com/2877461866d850c18f121ba88d2133900744acf7729ebeb680ddb3ae2b651305/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f66757269632f67616d652d657373656e7469616c73)](https://packagist.org/packages/furic/game-essentials)[![Packagist](https://camo.githubusercontent.com/f4b8f543f8fbab1264de205768a5c260565dc87e48f4e2b92d53122a8be6928d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f66757269632f67616d652d657373656e7469616c73)](https://packagist.org/packages/furic/game-essentials)[![License](https://camo.githubusercontent.com/2afbc2bee108e4c5a32d4415c0fc74f50239ee8d4a1da8f2fba94c2f21bcee83/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f66757269632f6c61726176656c2d67616d652d657373656e7469616c73)](https://packagist.org/packages/furic/game-essentials)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/5356336c19b4896c6e73adf9909afced6a14fbe9d7ca7553f7efae2258988064/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f66757269632f6c61726176656c2d67616d652d657373656e7469616c732f6261646765732f7175616c6974792d73636f72652e706e673f623d6d61696e)](https://scrutinizer-ci.com/g/furic/laravel-game-essentials/?branch=main)[![Build Status](https://camo.githubusercontent.com/9c26bed5bd26e50478fbe1eab9a922c82fcc55d5144a60e5f6b19dc477bc4985/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f66757269632f6c61726176656c2d67616d652d657373656e7469616c732f6261646765732f6275696c642e706e673f623d6d61696e)](https://scrutinizer-ci.com/g/furic/laravel-game-essentials/build-status/main)

> Game Essentials for [Laravel 5.\*](https://laravel.com/). This package is required and used by few packages in [Sweaty Chair Studio](https://www.sweatychair.com) creating the basic data and essential functions for a gaming server backend. This provides functions such as registering players and assign the players to a game. After that the data can be used for analytics purpose.

> If you are using other packages that requires this package, this will be added automatically and you do not need to install it manually. However, you can still use this package alone without using other packages.

Table of Contents
-----------------

[](#table-of-contents)

- [Installation](#installation)
- [Configuration](#configuration)
- [Usage](#usage)
    - [Games Table](#games-table)
    - [Players Table](#players-table)
    - [GamePlayer Privot Table](#gameplayer-privot-table)
    - [API URLs](#api-urls)
- [TODO](#todo)
- [License](#license)

Installation
------------

[](#installation)

Install this package via Composer:

```
$ composer require furic/game-essentials
```

> If you are using Laravel 5.5 or later, then installation is done. Otherwise follow the next steps.

#### Open `config/app.php` and follow steps below:

[](#open-configappphp-and-follow-steps-below)

Find the `providers` array and add our service provider.

```
'providers' => [
    // ...
    Furic\GameEssentials\GameEssentialsServiceProvider::class
],
```

Configuration
-------------

[](#configuration)

To create table for game essentials in database run:

```
$ php artisan migrate
```

Usage
-----

[](#usage)

### Games Table

[](#games-table)

```
| Name            | Type     | Not Null |
|-----------------|----------|----------|
| id              | integer  |     ✓    |
| name            | varchar  |     ✓    |
| version_ios     | integer  |     ✓    |
| version_android | integer  |     ✓    |
| version_tvos    | integer  |     ✓    |
| created_at      | datetime |          |
| updated_at      | datetime |          |

```

- Name: The name of the game/app.
- iOS Version: The latest version number in iOS, used for force update in client.
- Android Version: The latest version number in Android, used for force update in client.
- tvOS Version: The latest version number in tvOS, used for force update in client.

### Players Table

[](#players-table)

```
| Name          | Type     | Not Null |
|---------------|----------|----------|
| id            | integer  |     ✓    |
| facebook_id   | varchar  |          |
| gamecenter_id | varchar  |          |
| playgames_id  | varchar  |          |
| udid          | varchar  |          |
| name          | varchar  |          |
| ip            | varchar  |     ✓    |
| created_at    | datetime |          |
| updated_at    | datetime |          |

```

- Facebook ID: The Facebook ID of a player. (Optional)
- Game Center ID: The Game Center ID of a player in iOS. (Optional)
- Google Play Games ID: The Google Play Games ID of a player in Android. (Optional)
- UDID: The unique device UDID of a player. If the player is using multiple devices, only the first device UDID is used here.
- Name: The name of the player input in game/app. (Optional)
- IP: The IP of the player when being first seen.

### GamePlayer Privot Table

[](#gameplayer-privot-table)

```
| Name       | Type     | Not Null |
|------------|----------|----------|
| id         | integer  |     ✓    |
| game_id    | integer  |     ✓    |
| player_id  | integer  |     ✓    |
| channel    | integer  |     ✓    |
| version    | integer  |     ✓    |
| is_hack    | tinyint  |     ✓    |
| created_at | datetime |          |
| updated_at | datetime |          |

```

- Game ID: The ID of a the game that player launched.
- Player ID: The ID of a player.
- Channel: The channel of the player getting into the game. Mostly used for Android players, e.g. Sumsung Store, Huawei App Gallery, etc. (Optional)
- Version: The current game version that the player device is running.
- Is Hacked: A boolean to mark if the player ever performed any hack in game, for analytics and limiting functions in client.

### API URLs

[](#api-urls)

GET `/api/games/{id}`Returns a JSON data from a given game ID, for debug usage only.

GET `/api/games/{id}/versions`Returns a JSON data containing the versions from a given game ID, for client checking the latest game version and perform force-update.

GET `/api/games/{id}/players`Returns a JSON array of all players from a given game ID, for debug usage only.

GET `/api/players/{id}`Returns a JSON data from a given player ID, for debug usage only.

GET `/api/players/name/{name}`Returns a JSON data from a given player name, for debug usage only.

POST `/api/players`Creates a JSON data of a player with given POST data. If the player is already exists with the given UDID, Facebook ID, or game servies IDs, it update the player data instead.

PUT `/api/players/{id}`Updates a JSON data of a player with a given player id.

GET `/api/players/{id}/games`Returns a JSON array of all players from a given game ID, for debug usage only.

API Document can be found [here](https://documenter.getpostman.com/view/2560814/TVmV6tm8#af5d8a40-b4ab-497f-af69-43f7ad95e5fe).

TODO
----

[](#todo)

- Create the web console to add/edit games.
- Add admin login for web console.
- Add tests and factories.

License
-------

[](#license)

laravel-game-essentials is licensed under a [MIT License](https://github.com/furic/laravel-game-essentials/blob/main/LICENSE).

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~8 days

Total

7

Last Release

1971d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/44884321?v=4)[Richard Fu](/maintainers/furic)[@furic](https://github.com/furic)

---

Top Contributors

[![furic](https://avatars.githubusercontent.com/u/44884321?v=4)](https://github.com/furic "furic (18 commits)")

---

Tags

phplaravelgameplayergaming server

### Embed Badge

![Health badge](/badges/furic-game-essentials/health.svg)

```
[![Health](https://phpackages.com/badges/furic-game-essentials/health.svg)](https://phpackages.com/packages/furic-game-essentials)
```

###  Alternatives

[laracraft-tech/laravel-xhprof

Easy XHProf setup to profile your laravel application!

235321.4k](/packages/laracraft-tech-laravel-xhprof)[mozex/anthropic-laravel

Anthropic PHP for Laravel is a supercharged PHP API client that allows you to interact with the Anthropic API

71226.4k1](/packages/mozex-anthropic-laravel)[kompo/kompo

Laravel &amp; Vue.js FullStack Components for Rapid Application Development

11812.4k21](/packages/kompo-kompo)[bavix/laravel-xhprof

Quick profiling of your code for Laravel

22156.6k](/packages/bavix-laravel-xhprof)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
