Buddy System — Play Together, Not Alone

Buddy System is a lightweight, server-side utility that links two players as a buddy pair. It keeps pairs persistent, shows clear status in-game, and—when enabled in settings—can enforce presence rules with effects, grace periods, and kicks. No client mod required.

What the mod does

• Buddy Linking: Admins pair two players into a fixed duo.
• Status Check: Any player can see their partner and whether they’re online.
• Persistence: Pairs are saved in the world folder and survive restarts.
• Server-Only: Works with vanilla clients; just install on the server.

Optional presence rules (when enabled)

• On player login:
  The mod checks whether the joining player has a buddy and if that buddy is online.

  • If the buddy is offline, the player can receive configurable effects and a countdown (grace time) starts.
  • If the buddy doesn’t show up in time, the player is kicked.

• If the buddy leaves mid-session:
  The remaining player gets a grace period.

  • If the buddy returns in time, nothing else happens.
  • If the grace period expires, the remaining player is kicked.

Effects and timings are fully configurable. If presence enforcement is disabled, the mod only tracks and displays buddy status (no effects, no kicks).

Commands

All commands live under /buddysystem.

Player

• /buddysystem status
  Shows your partner and whether they’re online.

Admin (permission level 2 / OP)

• /buddysystem set <player1> <player2>
  Creates or replaces a buddy pair.
• /buddysystem admin clear <player>
  Removes any pair that includes the specified player.

Configuration (example)

A server config is generated on first run (e.g., config/buddysystem-server.toml).
Example of relevant options:

[buddysystem]
# Optional prefill (UUIDs or names depending on useUuid)
player1 = "00000000-0000-0000-0000-000000000000"
player2 = "11111111-1111-1111-1111-111111111111"
useUuid  = true

[buddysystem.presence]               # Presence enforcement rules
enablePresenceEnforcement = true     # enable login/leave checks
loginGraceSeconds         = 120      # time after login for buddy to show up
leaveGraceSeconds         = 90       # time after buddy leaves before kick
applyEffects              = true     # apply effects during grace windows

# Example effect toggles (only used if applyEffects = true)
effectBlindness = true
effectWeakness  = true
effectSlowness  = true