PHPackages                             rogiel/star-map - 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. [Parsing & Serialization](/categories/parsing)
4. /
5. rogiel/star-map

ActiveLibrary[Parsing & Serialization](/categories/parsing)

rogiel/star-map
===============

A StarCraft II map parser in PHP

0.1.2(9y ago)1231BSD-2.0PHPPHP >=5.5CI failing

Since Jul 24Pushed 5y ago1 watchersCompare

[ Source](https://github.com/Rogiel/star-map)[ Packagist](https://packagist.org/packages/rogiel/star-map)[ Docs](https://rogiel.com/portfolio/star-map)[ RSS](/packages/rogiel-star-map/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (2)Versions (4)Used By (0)

Star Map
========

[](#star-map)

This library allows you to read StarCraft II map files from PHP.

A object-oriented API is provided to browse through the metadata and the minimap image.

Features
--------

[](#features)

- Read .SC2Map files from all public game versions
- **Minimap**: Allows to read the embeded minimap image

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

[](#installation)

The recommended way of installing this library is using Composer.

```
composer require "rogiel/star-map"

```

This library uses [php-mpq](https://github.com/Rogiel/php-mpq) to parse and extract compressed information inside the map file.

Example
-------

[](#example)

```
use Rogiel\StarMap\Map;

// Parse the map
$map = new Map('Ruins of Seras.SC2Map');

// Get the map name in multiple locales
$documentHeader = $map->getDocumentHeader();

echo sprintf('Map name (English): %s', $documentHeader->getName()).PHP_EOL; // english is default
echo sprintf('Map name (French): %s', $documentHeader->getName('frFR')).PHP_EOL;

// Get the map size
$mapInfo = $map->getMapInfo();
$x = $mapInfo->getWidth();
$y = $mapInfo->getHeight();
echo sprintf('Map size: %sx%s', $x, $y).PHP_EOL;

// Export Minimap image as a PNG
$map->getMinimap()->toPNG('Minimap.png');
```

The output to the snippet above is the following:

```
Map name (English): Ruins of Seras
Map name (French): Ruines de Seras
Map size: 224x192

```

Have fun!

###  Health Score

24

—

LowBetter than 31% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity50

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 ~0 days

Total

3

Last Release

3628d ago

### Community

Maintainers

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

---

Top Contributors

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

---

Tags

blizzardgamingStarCraft IIMap parsing

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/rogiel-star-map/health.svg)

```
[![Health](https://phpackages.com/badges/rogiel-star-map/health.svg)](https://phpackages.com/packages/rogiel-star-map)
```

###  Alternatives

[mck89/peast

Peast is PHP library that generates AST for JavaScript code

19037.7M41](/packages/mck89-peast)[sauladam/shipment-tracker

Parses tracking information for several carriers, like UPS, USPS, DHL and GLS by simply scraping the data. No need for any kind of API access.

9642.0k](/packages/sauladam-shipment-tracker)[moonshine/layouts-field

Field for repeating groups of fields for MoonShine

107.9k](/packages/moonshine-layouts-field)[tcds-io/php-jackson

A lightweight, flexible object serializer for PHP, inspired by FasterXML/jackson

112.9k10](/packages/tcds-io-php-jackson)

PHPackages © 2026

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