home-assistant.io/source/_integrations/minecraft_server.markdown

2.4 KiB

title, description, ha_release, ha_category, ha_iot_class, ha_quality_scale, ha_config_flow, ha_codeowners, ha_domain, ha_platforms, ha_integration_type
title description ha_release ha_category ha_iot_class ha_quality_scale ha_config_flow ha_codeowners ha_domain ha_platforms ha_integration_type
Minecraft Server Instructions on how to integrate a Minecraft server into Home Assistant. 0.106
Binary Sensor
Sensor
Local Polling silver true
@elmurato
minecraft_server
binary_sensor
sensor
integration

Minecraft is a sandbox video game developed by Mojang Studios. Minecraft servers allow players to play the game online or via a local area network with other players. The Minecraft Server integration lets you retrieve information from a Minecraft server within Home Assistant.

Minecraft Java Edition servers must be version 1.7 or newer, since older versions don't expose any information.

Minecraft Bedrock Edition servers are not supported yet.

{% include integrations/config_flow.md %}

During setup you will be prompted to enter the name and the address of the server.

Server name

The server name can be chosen freely.

Default is Minecraft Server.

Server address

The server address is a combination of the hostname and the port, where the port is optional. For SRV records, the port is automatically extracted. For all other cases the default port 25565 is used, if the port is omitted. Here are some server address examples:

  • SRV record: hypixel.net
  • Hostname: mc.hypixel.net:25565 or mc.hypixel.net
  • IP address: 192.168.0.123:25565 or 192.168.0.123

Default is localhost:25565.

Binary sensors

This integration provides a binary sensor for the following information from a Minecraft server:

  • Connection status

Sensors

This integration provides sensors for the following information from a Minecraft server:

  • Latency
  • Version
  • Protocol version
  • Number of online players
    • Including player names list in the state attributes, if available (see note below).
  • Number of maximum players
  • World Message / Message of the Day (MOTD)

Depending on the server, the player names list may not be shown completely. Some servers and plugins limit or completely hide this list or even replace the player names with fake ones to show some custom messages there.