How truetemm/bedrock-fingerprint works
bfp is a command-line fingerprinting tool for Minecraft: Bedrock servers. Its main workflow resolves a server address, collects RakNet status and handshake signals, optionally probes protocol acceptance and captures login network settings, then scores the observations against known core signatures and prints text or JSON. The graph separates probing, session capture, fingerprinting, and CLI/reporting, with packet/channel helpers shown as an internal layer. Some target orchestration is supported only by the source index and README; unsampled implementation details are not expanded.
Main entry points: main.rs Command workflow · fingerprint.rs Observation collection · target.rs Server target · session.rs Network settings capture
Components 18
CLI and reporting
- Argument parsing
src/cli.rs - Command workflow
src/main.rs - Text and JSON
src/report.rs
Wire probes
- Server target
src/target.rs - Address resolver
src/raknet.rs - Status ping
src/raknet/pong.rs - Handshake probe
src/handshake.rs - Reply1 parser
src/handshake/reply1.rs - Protocol range
src/handshake/protocol_range.rs - Deep protocol probe
src/handshake/probe.rs
Session capture
- Network settings capture
src/session.rs - Reliable channel
src/session/channel.rs - Session packets
src/session/packets.rs - Wire encoding
src/session/wire.rs
Fingerprinting
- Observation collection
src/fingerprint.rs - Known core signatures
src/fingerprint/database.rs - Weighted matching
src/fingerprint/signature.rs
Other components
- CLI user
Connections 26
- CLI user → Argument parsing: provides arguments
README.md - Argument parsing → Command workflow: parses commands
src/main.rs - Command workflow → Address resolver: resolves address
src/main.rs - Command workflow → Server target: runs probes
src/main.rs - Server target → Status ping: pings server
- Server target → Handshake probe: probes handshake
src/target.rs - Server target → Protocol range: checks acceptance
- Server target → Deep protocol probe: probes protocol
- Server target → Network settings capture: captures settings
src/target.rs - Handshake probe → Reply1 parser: requests reply
src/handshake.rs - Command workflow → Protocol range: checks range
src/main.rs - Command workflow → Deep protocol probe: optionally probes
src/main.rs - Command workflow → Observation collection: collects signals
src/main.rs - Command workflow → Known core signatures: loads signatures
src/main.rs - Command workflow → Text and JSON: prints result
src/main.rs - Network settings capture → Reply1 parser: opens connection
src/session.rs - Network settings capture → Reliable channel: sends datagrams
src/session.rs - Network settings capture → Session packets: builds and parses
src/session.rs - Network settings capture → Wire encoding: encodes fields
src/session.rs - Observation collection → Status ping: reads status
src/fingerprint.rs - Observation collection → Handshake probe: reads signals
src/fingerprint.rs - Observation collection → Network settings capture: reads settings
src/fingerprint.rs - Observation collection → Protocol range: reads acceptance
src/fingerprint.rs - Observation collection → Weighted matching: scores checks
src/fingerprint.rs - Known core signatures → Weighted matching: defines checks
src/fingerprint/database.rs - Text and JSON → Observation collection: formats signals
src/report.rs