github.com/alkanife/fakemcserver ↗
A java program which simulates a minecraft server, to display information in the server list
Open this visualization on its own page →
Contributors
6
Lines of Code
85
From
2014-05-30
To
2023-04-08
About alkanife/fakemcserver
Fake Minecraft Server is a Java application that simulates a Minecraft server for display purposes in the server list. When Minecraft clients query the server, they receive customizable information including a server icon, message of the day, protocol version, player count and sample names, and a kick message that displays when players attempt to connect. The program operates as a socket server and can be configured to respond to specific Minecraft versions or all client versions.
The project provides both a command-line tool and a library for Java developers. It uses a JSON configuration file that allows users to set the listening host and port, specify the advertised server IP, customize player samples with color formatting, and provide a server icon either as a file path or base64-encoded data. The MOTD and kick messages support MiniMessage formatting for rich text display. The application requires Java 21 or higher and can be run standalone or integrated into other projects as a dependency.
The tool is useful for creating fake servers for testing purposes, displaying custom server information without running an actual Minecraft server, or developing Minecraft client applications. It handles the Minecraft server ping protocol directly, parsing client requests and responding with the configured server details according to the protocol specification.