Mutes

Base: /api/mutes

Mute players for a time or permanently

Handler: MutesHandler

GET /api/mutes

List mutes

Returns all muted players with reason, moderator and end time.

Response Example

[
  {
    "player": "Steve",
    "reason": "spam",
    "mutedBy": "Admin",
    "durationMinutes": 30,
    "expiresAt": 1737003600000
  }
]

cURL

curl -X GET 'http://localhost:5550/api/mutes' \
  -H 'X-Admin-Token: YOUR_TOKEN'

Internal Behavior

Reads mutes.json in the mod folder.

POST /api/mutes

Mute player

Mutes a player; muted players cannot write in chat.

Request Body

Field	Type	Required	Description
`player`	string	Yes	Player name
`reason`	string	No	Reason
`muted_by`	string	No	Moderator, default Server
`duration_minutes`	integer	No	Minutes, 0 = permanent (default)

Response Example

{
  "success": true,
  "player": "Steve",
  "reason": "spam",
  "duration_minutes": 30
}

cURL

curl -X POST 'http://localhost:5550/api/mutes' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"player": "Spammer", "reason": "Spam", "muted_by": "Eranio", "duration_minutes": 60}'

Internal Behavior

Writes the entry to mutes.json.

DELETE /api/mutes/{player}

Unmute player

Removes a mute.

Parameters

Name	Type	Required	Description
`player`	string	Yes	Player name

Response Example

{
  "success": true,
  "player": "Steve"
}

cURL

curl -X DELETE 'http://localhost:5550/api/mutes/Griefer123' \
  -H 'X-Admin-Token: YOUR_TOKEN'

Internal Behavior

Removes the entry from mutes.json.