PHPackages                             refatbd/game-account-lookup - 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. [Templating & Views](/categories/templating)
4. /
5. refatbd/game-account-lookup

ActiveLibrary[Templating & Views](/categories/templating)

refatbd/game-account-lookup
===========================

Framework-independent PHP toolkit and local test template for resolving game account nicknames from player IDs through pluggable validation providers.

v1.0.1(today)00MITPHPPHP ^8.1CI passing

Since Aug 2Pushed todayCompare

[ Source](https://github.com/refatbd/game-account-lookup)[ Packagist](https://packagist.org/packages/refatbd/game-account-lookup)[ Docs](https://github.com/refatbd/game-account-lookup)[ RSS](/packages/refatbd-game-account-lookup/feed)WikiDiscussions main Synced today

READMEChangelog (2)Dependencies (1)Versions (3)Used By (0)

Game Account Lookup
===================

[](#game-account-lookup)

[![PHP](https://camo.githubusercontent.com/3e41095f4ad1c6ad78f988bd1c107f87972f334143c3ba814165a03e1f43a63c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312532422d3737374242343f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://www.php.net/)[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](LICENSE)[![Tests](https://github.com/refatbd/game-account-lookup/actions/workflows/tests.yml/badge.svg)](https://github.com/refatbd/game-account-lookup/actions)[![Maintainer](https://camo.githubusercontent.com/c53cff45a042e9f4bc4b251d7e5b412cc4585c786456dbe15298e5fa59cad2fe/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d61696e7461696e65722d526566617442442d626c7565)](https://github.com/refatbd)

A framework-independent PHP base package for building **game player-ID / UID to nickname checkers**. It combines data-driven game registration, provider fallback, dynamic provider tokens, caching, Laravel integration, and a clean extension API.

> **Maintainer / Developer:** [RefatBD](https://github.com/refatbd)

Why this repository exists
--------------------------

[](#why-this-repository-exists)

Most public game-name checker scripts are tied to one website, one game, or one temporary upstream endpoint. This package separates the reusable parts:

```
Your app or API
      |
      v
GameAccountLookup
      |
      +-- Game registry and aliases
      +-- Zone/server normalization
      +-- Provider fallback
      +-- Cache
      |
      +-- Garena Shop2Game direct adapter
      +-- Midasbuy xMidas direct adapter
      +-- GoPay Games adapter
      +-- Codashop classic adapter
      +-- Codashop dynamic-token adapter
      +-- Optional local browser-assisted adapters
      +-- Your own provider adapters

```

It is intended as a **base library**. Developers can use it in Laravel, plain PHP, WordPress, Symfony, or a custom API and add their own official or authorized providers without changing the core.

Important notice
----------------

[](#important-notice)

This is an unofficial developer tool. The bundled provider adapters interact with public account-validation flows exposed by third-party top-up services; they are not official game-publisher APIs. Those flows, payload fields, product IDs, regional restrictions, and anti-abuse rules can change without notice.

Use this package server-side, cache successful lookups, add rate limits, follow the provider's terms, and prefer official/authorized APIs whenever available. Do not use it to evade access controls or overload third-party services.

Features
--------

[](#features)

- PHP 8.1+ with no framework requirement
- 53 data-driven game definitions with a dated Codashop/GoPay availability catalog
- Direct Garena Shop2Game lookup for Free Fire, including normalized country/region output
- Configurable PHP/OpenSSL Midasbuy `xMidas` payload generation for any valid PUBG Mobile Player ID
- GoPay Games page-preflight/code discovery, Codashop classic and region-aware runtime-metadata adapters, plus optional Dancing Idol-compatible adapters
- Optional browser-assisted Codashop and Midasbuy validation for storefronts that require an interactive Chrome/Edge session
- Automatic fallback between configured providers and Codashop regional storefront profiles
- Strict single-provider execution and all-provider comparison mode
- Per-request cache bypass without clearing existing cached results
- Provider-scoped cache keys that prevent cross-provider cache contamination
- UID-only and UID + zone/server games
- Game aliases such as `ff`, `mlbb`, `pubgm`, `codm`, `hsr`, and `zzz`
- Runtime game and provider registration
- Pluggable cache contract
- Structured, JSON-serializable results
- Laravel auto-discovery, facade, configuration, and Laravel cache support
- CLI utility
- Standalone offline tests and PHPUnit tests
- GitHub Actions matrix for PHP 8.1–8.4
- Session-cookie continuity and runtime Codashop metadata discovery without committed short-lived JWT/SKU tokens
- Official product-page evidence, provider availability states, and a non-destructive provider audit CLI

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

[](#installation)

Core requirements:

- PHP 8.1 or newer
- PHP extensions: cURL, JSON, and OpenSSL
- Composer 2

OpenSSL is used by the direct PUBG Mobile Midasbuy provider. If it is missing, that provider reports `PROVIDER_NOT_CONFIGURED` and the remaining configured providers can still run.

After publishing the package on Packagist:

```
composer require refatbd/game-account-lookup
```

Before Packagist publication, add the GitHub repository to the consuming project:

```
{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/refatbd/game-account-lookup"
    }
  ],
  "require": {
    "refatbd/game-account-lookup": "dev-main"
  }
}
```

Then run:

```
composer update refatbd/game-account-lookup
```

The direct HTTP providers require no JavaScript runtime. The optional `codashop_browser` and `midasbuy_browser` providers additionally require Node.js 22 or newer, `proc_open`, and Google Chrome or Microsoft Edge. See [Browser-assisted providers](#browser-assisted-providers) before enabling those local fallbacks.

Direct PUBG Midasbuy lookup is available through the PHP-only `midasbuy`provider. This private build includes the current rotating values and also supports environment overrides. It generates an encrypted payload for each Player ID. See [`docs/MIDASBUY_DIRECT_SETUP.md`](docs/MIDASBUY_DIRECT_SETUP.md).

Run the included web tester
---------------------------

[](#run-the-included-web-tester)

From the repository root:

```
composer install
php -S 127.0.0.1:8765 -t template
```

Open `http://127.0.0.1:8765/`. Windows and Linux/macOS launchers are also available as `template/start.bat` and `template/start.sh`.

The tester supports Live, Demo, automatic fallback, one-provider-only, all providers, and per-request cache-bypass modes. Its API endpoints are:

EndpointMethodPurpose`/api/health.php`GETRuntime and extension health`/api/games.php`GETPublic game/provider registry`/api/check.php`GET or POSTAccount lookupThe template is a local development tool. See [`docs/WEB_TESTER.md`](docs/WEB_TESTER.md) before adapting it for public use.

Plain PHP quick start
---------------------

[](#plain-php-quick-start)

```