Skip to content
Duckulus edited this page Jul 23, 2025 · 7 revisions

To access fingerprint and OS detection data, use the public API interface exposed by the plugin.

Getting the API Instance

SynSniffApi api = SynSniff.getApi();

At the moment the API provides a FingerprintService which lets you retrieve detailed information about the players Fingerprint and a prediction of their Operating System.

Check out the Javadoc for detailed information.

Example

Here is a simple Paper plugin which prints a players predicted Operating System on Join

public final class SynSniffTestplugin extends JavaPlugin implements Listener {

  @Override
  public void onEnable() {
    getServer().getPluginManager().registerEvents(this, this);
  }

  @EventHandler
  public void onPlayerJoin(PlayerJoinEvent e) {
    OS os = SynSniff.getApi().getFingerprintService().getPredictedOperatingSystem(e.getPlayer().getUniqueId());
    getLogger().info("%s joined using %s".formatted(e.getPlayer().getName(), os.name()));
  }

}

Clone this wiki locally