PHPackages                             mayomi/minecraftserverstatus - 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. [DevOps & Deployment](/categories/devops)
4. /
5. mayomi/minecraftserverstatus

ActiveLibrary[DevOps & Deployment](/categories/devops)

mayomi/minecraftserverstatus
============================

Minecraft Server Status Query, written in PHP, with online players, motd, favicon and more server related informations without plugins and enable-query.

1.0(9y ago)6101BSDPHP

Since Nov 22Pushed 7y ago1 watchersCompare

[ Source](https://github.com/Mayomi/PHP-Minecraft-Server-Status-Query)[ Packagist](https://packagist.org/packages/mayomi/minecraftserverstatus)[ RSS](/packages/mayomi-minecraftserverstatus/feed)WikiDiscussions master Synced 2mo ago

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

\#Minecraft服务器状态获取

Minecraft服务器状态获取, 基于PHP + Composer + Bootsrap, 不通过插件/服务器设定来获取在线玩家、标题、图标等等服务器数据.

*测试支持 1.8~1.10 / BungeeCord / WaterFall 等等..*

### 安装方法 / 你需要先安装PHP + Composer

[](#安装方法--你需要先安装php--composer)

```
composer install

```

### 演示页面 / example.php

[](#演示页面--examplephp)

```
use MinecraftServerStatus\MinecraftServerStatus;

require 'vendor/autoload.php';

$response = MinecraftServerStatus::query('play.mc450.com', 25565);

if (! $response) {
    echo "The Server is offline!";
} else {
    echo "
        服务器地址：" . $response['hostname'] . "
		服务器版本：" . $response['version'] . "
		服务器状态：在线
        服务器人数：" . $response['players'] . " / " . $response['max_players'] . "
		服务器标语：" . $response['description'] . "
        服务器延迟：" . $response['ping'] . " 毫秒";
}

```

如果服务器离线 MinecraftServerStatus::query 将会返回 false. 否则将会返回一组数值. 特别注明: 这是原fork的默认页面

### 发布页面 / index.php

[](#发布页面--indexphp)

调试成功的基于 Bootsrap 的页面, 你可以在  获取更多帮助.

### 配置页面 / config.php

[](#配置页面--configphp)

```
			use MinecraftServerStatus\MinecraftServerStatus;

			require 'vendor/autoload.php';

			$response = MinecraftServerStatus::query('play.mc450.com', 25565);

			$server_ip = $response['hostname'] . ':' . $response['port'];
			$server_icon = $response['favicon'];
			$server_version = $response['version'];
			$server_online = $response['players'];
			$server_max = $response['max_players'];
			$server_motd = $response['description'];
			$server_ping = $response['ping'];

			$c_name = '';
			$c_desc = '';
			$c_beian = '';
			$c_website = '';

```

你需要配置IP/端口/服务器名称/副标题/备案信息/网站地址.

### 可用变量

[](#可用变量)

以下是原fork给出的所有变量

变量名描述```
'hostname'
```

输出为数字格式的IP, 例如127.0.0.1```
'port'
```

端口返回值, 例如25565```
'ping'
```

网站到服务器的延迟```
'version'
```

服务端核心版本
(例如: 1.9)```
'protocol'
```

服务端核心协议
(例如: 107)```
'players'
```

当前在线的玩家数量```
'max_players'
```

最大设置的玩家数量```
'description'
```

服务端所设置的标语/motd - 输出为带颜色的字体```
'description_raw'
```

服务端所设置的标语/motd - 输出为带颜色符号的字体```
'favicon'
```

服务器图标的 base64 字符串
(你可以使用 html 的 img 标签来显示该图标)```
'modinfo'
```

关于插件的信息

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 68.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

Unknown

Total

1

Last Release

3461d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5a594e5559461008d6fc076010852f5815716c40bf9de936a5cde0c557266aa7?d=identicon)[Mayomi](/maintainers/Mayomi)

---

Top Contributors

[![Mayomi](https://avatars.githubusercontent.com/u/6521307?v=4)](https://github.com/Mayomi "Mayomi (11 commits)")[![mariogrip](https://avatars.githubusercontent.com/u/1642635?v=4)](https://github.com/mariogrip "mariogrip (2 commits)")[![TuxCoding](https://avatars.githubusercontent.com/u/1957196?v=4)](https://github.com/TuxCoding "TuxCoding (2 commits)")[![Metrakit](https://avatars.githubusercontent.com/u/3305600?v=4)](https://github.com/Metrakit "Metrakit (1 commits)")

---

Tags

serverstatusminecraft

### Embed Badge

![Health badge](/badges/mayomi-minecraftserverstatus/health.svg)

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

###  Alternatives

[spatie/laravel-webhook-server

Send webhooks in Laravel apps

1.1k8.8M22](/packages/spatie-laravel-webhook-server)[felixfbecker/language-server-protocol

PHP classes for the Language Server Protocol

22476.7M6](/packages/felixfbecker-language-server-protocol)[sarfraznawaz2005/servermonitor

Laravel package to periodically monitor the health of your server and website.

19513.2k1](/packages/sarfraznawaz2005-servermonitor)[laminas/laminas-server

Create Reflection-based RPC servers

2423.1M23](/packages/laminas-laminas-server)[phpfastcgi/fastcgi-daemon

A FastCGI daemon written in PHP

33011.4k4](/packages/phpfastcgi-fastcgi-daemon)[phpfastcgi/speedfony-bundle

A bundle to integrate a FastCGI daemon with the symfony2 framework

909.5k](/packages/phpfastcgi-speedfony-bundle)

PHPackages © 2026

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