PlayerStatus 1.0.0

PlayerStatus

A lightweight, preset-based player status system with PlaceholderAPI support

PlayerStatus lets servers create their own custom status presets (AFK, Busy, Grinding, Streaming, Events, etc.) that players can select and display anywhere using PlaceholderAPI including TAB, scoreboards, chat formats, and nametags.

Built for Paper servers, PlayerStatus is extremely lightweight, safe, and designed to run smoothly even with 200+ concurrent players.

Features

Custom Status Presets

• Create and manage your own status presets via config.yml

  
  

• Players can only select server defined presets

  
  

• Optional automatic reset on logout

  
  

• Configurable maximum visible length

  
  

Color & Emoji Support

• Supports & color codes

  
  

• Full hex color support (&#RRGGBB and {#RRGGBB})

  
  

• Emoji & Unicode friendly

  
  

PlaceholderAPI Integration

Display player statuses anywhere using:

• %playerstatus_status%

  
  

• %playerstatus_status_<playername>% (online players)

  
  

Compatible with:

• TAB plugins

  
  

• Scoreboards

  
  

• Chat formatters

  
  

• Nametag plugins

  
  

• Any PlaceholderAPI-supported plugin

  
  

Fully Configurable

• Toggle command prefix on/off

  
  

• Customize all messages

  
  

• Add, remove, or edit presets freely

  
  

• Default fallback status

  
  

• Reload configuration without restarting

  
  

 Commands

Performance & Stability

Designed to scale cleanly on large servers (200+ players online).

 Compatibility

• Paper / Spigot

  
  

• Minecraft 1.21.10-1.21.11

  
  

• PlaceholderAPI 

  
  

 Use Cases

• Create custom AFK / Busy / Event statuses

  
  

• Show player statuses in TAB or scoreboards

  
  

• Social & SMP servers
  
  Config:

  
  

   

  
  

  prefix:
    enabled: true
    text: "{#FF4A4A}[Status]{#FFFFFF} "
  
  settings:
    auto-clear-on-logout: true
    max-visible-length: 24
    default-status: ""
  
  messages:
    no-permission: "{prefix}{#FF4A4A}You don't have permission."
    reload: "{prefix}{#FFFFFF}Config reloaded."
    player-only: "{prefix}{#FF4A4A}Only players can use this command."
    unknown-preset: "{prefix}{#FF4A4A}Unknown preset. Use {#FFFFFF}/status list"
    status-set: "{prefix}{#FFFFFF}Status set to {#FF4A4A}{status}"
    status-cleared: "{prefix}{#FFFFFF}Your status has been cleared."
    status-check-self: "{prefix}{#FFFFFF}Your status: {#FF4A4A}{status}"
    status-check-other: "{prefix}{#FFFFFF}{player}'s status: {#FF4A4A}{status}"
    status-check-offline: "{prefix}{#FF4A4A}That player is not online."
    list-header: "{prefix}{#FFFFFF}Available statuses:"
    list-format: "{#FFFFFF}- {#FF4A4A}{key}{#FFFFFF}: {status}"
    help:
      - "{prefix}{#FFFFFF}/playerstatus set <preset> {#FF4A4A}- Set your status"
      - "{prefix}{#FFFFFF}/playerstatus list {#FF4A4A}- List statuses"
      - "{prefix}{#FFFFFF}/playerstatus reset {#FF4A4A}- Reset status"
      - "{prefix}{#FFFFFF}/playerstatus help {#FF4A4A}- Show help"
      - "{prefix}{#FFFFFF}/playerstatus reload {#FF4A4A}- Reload config"
  
  presets:
    afk:
      display: "{#FF4A4A}⏳ AFK"
    busy:
      display: "{#FF4A4A}⛔ Busy"
    grinding:
      display: "{#FF4A4A}⚒ Grinding"
    streaming:
      display: "{#FF4A4A}🎥 Streaming"
    pvp:
      display: "{#FF4A4A}⚔ PvP"