Fake Minecraft Server

Lightweight Rust implementation of a fake Minecraft server. It supports server list responses (status/ping) and connection attempts, useful for testing clients or as a placeholder server.

Installation

Pre-built binaries

You can download pre-built binaries for Windows, macOS, and Linux from the Releases page.

Docker

docker run --name fake-server -d -p 25565:25565 -v "$(pwd)/config.yml:/config.yml" ghcr.io/oreqr/fake-minecraft-server:latest

Configuration

Server uses a YAML configuration file (config.yml). If no configuration is found, default values will be used.

You can specify a custom path to the configuration file by setting the CONFIG_PATH environment variable.

Example configuration file with comments is provided in config.example.yml.

Default values:

debug: false

host: 0.0.0.0
port: 25565

status:
  version:
    same: true

  players:
    max: 20
    online: 0

  motd: "§cFake Minecraft Server"
  favicon: server-icon.png

kick_message: "§c§lThis is a fake server!\n§eIt only responds to ping requests."

Debugging

To enable debug logging, you can either:

1. Set the environment variable:

   DEBUG=true
   # or Rust lang
   RUST_LOG="debug"

2. Or enable debug in the config file:

   debug: true

License

MIT