PHPackages                             badmushroom/digstatsreader - 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. badmushroom/digstatsreader

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

badmushroom/digstatsreader
==========================

Tool for parsing Minecraft's NBT (Named Bindary Tag) data files.

v0.1.0(1y ago)03MITPHPPHP >=8.0

Since Dec 15Pushed 1y ago1 watchersCompare

[ Source](https://github.com/bad-mushroom/digstatsreader)[ Packagist](https://packagist.org/packages/badmushroom/digstatsreader)[ RSS](/packages/badmushroom-digstatsreader/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)DependenciesVersions (2)Used By (0)

DigStats Reader
===============

[](#digstats-reader)

Library for reading Minecraft's NBT data.

Example Usage
-------------

[](#example-usage)

```
use BadMushroom\DigStatsReader;

$filePath = '/Full/Path/To/level.dat';
$reader = DigStatsReader\TagReader::fromDatFile($filePath);

try {
    while (($tag = $reader->readTag()) !== null) {
        print_r($tag);
    }
} catch (\Exception $e) {
    print($e->getMessage());
}

```

Technical Notes
---------------

[](#technical-notes)

### NBT (Named Binary Tag)

[](#nbt-named-binary-tag)

It is the file format used by Minecraft to store structured game data in a compact, efficient, and hierarchical manner. NBT is designed to handle the vast amounts of data Minecraft needs to track, such as player stats, world metadata, entity data, and block states.

**TAG Data Format**

Tag TypeNameLength/FormatNotes0TAG\_EndNo dataMarks the end of a TAG\_Compound.1TAG\_Byte1 byte8-bit signed integer.2TAG\_Short2 bytes16-bit signed integer.3TAG\_Int4 bytes32-bit signed integer.4TAG\_Long8 bytes64-bit signed integer.5TAG\_Float4 bytes32-bit floating-point number.6TAG\_Double8 bytes64-bit floating-point number.7TAG\_Byte\_Array4 bytes (length) + length bytesArray of bytes.8TAG\_String2 bytes (length) + length UTF-8 charsUTF-8 string.9TAG\_List1 byte (type) + 4 bytes (length) + dataList of unnamed tags of the same type.10TAG\_CompoundSeries of named tags + TAG\_EndCompound structure.11TAG\_Int\_Array4 bytes (length) + length \* 4 bytesArray of 32-bit integers.12TAG\_Long\_Array4 bytes (length) + length \* 8 bytesArray of 64-bit integers.

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance39

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

518d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f1a3173fa999f6045bcd8de4920098e50fbcf72e976175c9254cce938d9f0253?d=identicon)[bad-mushroom](/maintainers/bad-mushroom)

---

Top Contributors

[![bad-mushroom](https://avatars.githubusercontent.com/u/381203?v=4)](https://github.com/bad-mushroom "bad-mushroom (5 commits)")

---

Tags

minecraftnbtparserparserNBTstatsminecraft

### Embed Badge

![Health badge](/badges/badmushroom-digstatsreader/health.svg)

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

###  Alternatives

[nikic/php-parser

A PHP parser written in PHP

17.4k902.6M1.8k](/packages/nikic-php-parser)[doctrine/lexer

PHP Doctrine Lexer parser library that can be used in Top-Down, Recursive Descent Parsers.

11.2k910.8M118](/packages/doctrine-lexer)[erusev/parsedown

Parser for Markdown.

15.0k151.8M732](/packages/erusev-parsedown)[league/commonmark

Highly-extensible PHP Markdown parser which fully supports the CommonMark spec and GitHub-Flavored Markdown (GFM)

2.9k404.0M702](/packages/league-commonmark)[masterminds/html5

An HTML5 parser and serializer.

1.8k242.8M229](/packages/masterminds-html5)[sabberworm/php-css-parser

Parser for CSS Files written in PHP

1.8k191.2M65](/packages/sabberworm-php-css-parser)

PHPackages © 2026

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