PHPackages                             manialib/gbx - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. manialib/gbx

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

manialib/gbx
============

Manialib/Gbx is a PHP package to manipulate Maniaplanet Gbx files metadata

v5.0.0(3y ago)69.5k↓50%6[1 issues](https://github.com/manialib/gbx/issues)[2 PRs](https://github.com/manialib/gbx/pulls)MITPHPPHP ^8.0CI passing

Since Feb 16Pushed 3mo ago3 watchersCompare

[ Source](https://github.com/manialib/gbx)[ Packagist](https://packagist.org/packages/manialib/gbx)[ Docs](https://github.com/manialib/gbx)[ RSS](/packages/manialib-gbx/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)Dependencies (1)Versions (16)Used By (0)

Manialib\\Gbx
=============

[](#manialibgbx)

[![Packagist Version](https://camo.githubusercontent.com/0c7250f8ff9b9d6792fa04b9bea27f14645c9831ac6a6928d123e322795d9383/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d616e69616c69622f6762782e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/manialib/gbx)[![Total Downloads](https://camo.githubusercontent.com/a78fd7c52bf13185c48a2f14d055c873d722b7905636119fb2569b8058842e27/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d616e69616c69622f6762782e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/manialib/gbx)

Manialib\\Gbx is a PHP package for reading Gbx file metadata

Features
--------

[](#features)

- **Map.Gbx:** Access metadata with a simple object interface
- **Map.Gbx:** Extract JPG thumbnail

Beta
----

[](#beta)

- **This is a work in progress.**
- We might break stuff at any point.
- If you need a stable version, feel free to ask us.
- If you need a new feature, feel free to ask us.

Requirements
------------

[](#requirements)

- PHP 8.0+
- PHP GD extension

Install
-------

[](#install)

[Install via Composer](https://getcomposer.org/)

```
{
	"require": {
        "manialib/gbx": "^5.0"
    }
}
```

Usage
-----

[](#usage)

```
use Manialib\Gbx\Map;

$map = Map::loadFile('/path/to/my/map.map.gbx');

//save the map thumbnail
$map->getThumbnail()->saveJpg('/path/to/my/thumbnail.jpg');

//get map author
$author = $map->getAuthor();
```

Development guidelines
----------------------

[](#development-guidelines)

We follow best practices from the amazing PHP ecosystem. Warm kudos to [Symfony](http://symfony.com/), [The PHP League](http://thephpleague.com/), [the PHP subreddit](http://www.reddit.com/r/PHP/) and many more for inspiration and challenging ideas.

- We adhere to the best-practices put forward by [PHP The Right Way](http://www.phptherightway.com/)
- We comply to the standards of the [PHP-FIG](http://www.php-fig.org/)
- We distribute code via [Packagist](https://packagist.org/) and [Composer](https://getcomposer.org/)
- We manage version numbers with [Semantic Versioning](http://semver.org/)
- We [keep a changelog](http://keepachangelog.com/)
- We use `Manialib\` as our PHP vendor namespace
- We use `manialib/` as our Packagist vendor namespace
- We'll (try to) make documentation &amp; tests :)

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance50

Moderate activity, may be stable

Popularity31

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity76

Established project with proven stability

 Bus Factor1

Top contributor holds 57.8% 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 ~375 days

Recently: every ~364 days

Total

9

Last Release

1105d ago

Major Versions

4.1.2 → v5.0.02023-05-10

PHP version history (4 changes)4.0-betaPHP &gt;=5.5

4.1.0PHP ^7.1

4.1.2PHP ^7.1 || ^8.0

v5.0.0PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/194d53bc2cfc60dd7fc1d45d293fe0e732064c003f91716c9045cb09a985a8a4?d=identicon)[magnetik](/maintainers/magnetik)

![](https://avatars.githubusercontent.com/u/445622?v=4)[Maxime Raoust](/maintainers/gou1)[@gou1](https://github.com/gou1)

![](https://avatars.githubusercontent.com/u/1850524?v=4)[satanasdiabolo](/maintainers/satanasdiabolo)[@satanasdiabolo](https://github.com/satanasdiabolo)

---

Top Contributors

[![satanasdiabolo](https://avatars.githubusercontent.com/u/1850524?v=4)](https://github.com/satanasdiabolo "satanasdiabolo (26 commits)")[![magnetik](https://avatars.githubusercontent.com/u/345029?v=4)](https://github.com/magnetik "magnetik (13 commits)")[![gou1](https://avatars.githubusercontent.com/u/445622?v=4)](https://github.com/gou1 "gou1 (5 commits)")[![guillaume-bachelier](https://avatars.githubusercontent.com/u/25012549?v=4)](https://github.com/guillaume-bachelier "guillaume-bachelier (1 commits)")

---

Tags

ManiaPlanetShootManiaTrackManiaManiaLibUbisoftNadeo

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/manialib-gbx/health.svg)

```
[![Health](https://phpackages.com/badges/manialib-gbx/health.svg)](https://phpackages.com/packages/manialib-gbx)
```

###  Alternatives

[csharpru/vault-php

Best Vault client for PHP that you can find

8410.3M4](/packages/csharpru-vault-php)[laminas/laminas-config-aggregator

Lightweight library for collecting and merging configuration from different sources

384.0M124](/packages/laminas-laminas-config-aggregator)[composer-unused/contracts

Contract repository for composer-unused

115.7M2](/packages/composer-unused-contracts)[maniaplanet/dedicated-server-api

XML-RPC library to connect to Maniaplanet server

156.6k3](/packages/maniaplanet-dedicated-server-api)

PHPackages © 2026

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