promotional bannermobile promotional banner

PresenceAPI

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

[1.3.0] PresenceAPI

File namepresenceapi-1.3.0.jar
Uploader
saunhardysaunhardy
Uploaded
Apr 10, 2026
Downloads
18
Size
14.8 KB
Mod Loaders
NeoForge
File ID
7905458
Type
R
Release
Supported game versions
  • 1.21.1

Curse Maven Snippet

NeoForge

implementation "curse.maven:presenceapi-1438821:7905458"

Learn more about Curse Maven

What's new

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.

This mod has no additional files