Skip to content

PowerShell script allowing to fetch basic server status data from modern versions of Minecraft server (1.7+)

Notifications You must be signed in to change notification settings

Dovias/ps-mc-status

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 

Repository files navigation

ps-mc-status

ps-mc-status is a PowerShell script, allowing to check the server state of the modern versions of Minecraft servers (Starting from version 1.7)

Usage 📝

Before you start, you need to make sure that you have the PowerShell version 5.1 or later installed on machine. If the machine uses Windows 10 or later, PowerShell 5.1 should be preinstalled already with the system.

This script provides several functions that allow you to retrieve the data from the Minecraft server:

Get-MCServerStatus -address <address> [-port <port number>] command allows to retrieve the basic server information about the current server state (server software name, version and players)
Get-MCServerStatusData -address <address> [-port <port number>] [-raw] command allows to retrieve the PowerShell server information object about the current server state (server response data)
Get-MCServerIcon -path <icon output path> -address <address> [-port <port number>] command allows to retrieve the current server icon from the server and save it as a file on a computer

Known issues 🦺

This implementation does not support DNS SRV record port number fetching. Some Minecraft servers use SRV records that allows them to dynamically provide the port number for the client without any explicit input from the client. Unfortunately, due to how .NET framework works, there's no way to parse the DNS SRV records data, since as of now, .NET only provides some methods for retrieval of IP addresses only. This means that some Minecraft servers from this script may show that they are offline, while in reality they are not. In this case, stating explicitly IP and port number of the server would solve this issue.

About

PowerShell script allowing to fetch basic server status data from modern versions of Minecraft server (1.7+)

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published