promotional bannermobile promotional banner

PresenceAPI

This mod monitors player join and leave events and dispatches configurable HTTP requests with player data.

File Details
DownloadInstall

[1.3.0] PresenceAPI

Bysaunhardy
  • R
  • Apr 10, 2026
  • 14.79 KB
  • 11
  • 1.21.1
  • NeoForge

File Name

presenceapi-1.3.0.jar

Supported Versions

  • 1.21.1

Curse Maven Snippet

NeoForge

implementation "curse.maven:presenceapi-1438821:7905458"
Curse Maven does not yet support mods that have disabled 3rd party sharing

Learn more about Curse Maven

Version 1.3.0

Added

  • Added a periodic heartbeat that sends the full online player list to the backend at a configurable interval. This allows the backend to reconcile stale sessions caused by missed leave events.
  • The heartbeat interval is configurable via heartbeatIntervalMinutes in the config (default: 5 minutes, set to 0 to disable).

Changed

  • The endpoint config key has been replaced with three separate options: apiUrl (the base URL of your backend), presenceEndpoint (path for join/leave events, default /api/presence), and heartbeatEndpoint (path for heartbeat syncs, default /api/presence/heartbeat). Existing config files will need to be updated.
  • Backend error responses are now logged with the HTTP status code and any error message returned by the backend, making it easier to diagnose integration issues.

Fixed

  • Fixed HTTP/1.1 compatibility issues that caused errors with certain backend servers.
  • Fixed a missing config section bracket that could cause config parsing to fail silently.