Playtime Session Placeholder

TFBMCSession
A lightweight PlaceholderAPI expansion for session playtime

This plugin was originally developed for my own Minecraft server,
The Final Block – a small personal project where I’m building my “forever world.”
I needed a simple and lightweight way to display each player’s
current session playtime on the scoreboard without the clutter of full playtime trackers.

Since there wasn’t a plugin that did exactly what I wanted, I created TFBMCSession.
Now I’m sharing it here for anyone else who wants the same clean solution.

TFBMCSession is a simple, lightweight plugin that integrates with
PlaceholderAPI
to give you exactly one placeholder:

%tfbmc_session%

This placeholder shows a player’s current session playtime in a formatted style:

• Seconds → Minutes → Hours → Days → Weeks → Months → Years
• Resets automatically when a player disconnects
• Updates in real time as the player stays online
• Works with scoreboards, GUIs, and any plugin that supports PlaceholderAPI
• Zero configuration – drop it in and it works

If you’ve ever wanted a clean and simple way to display session playtime
on your scoreboard, tab list, or GUI, without the bloat of full playtime trackers,
this plugin is for you.

Features

• One placeholder only →

  %tfbmc_session%

• Returns formatted session time (e.g. 12s, 3m 41s, 1h 2m 3s, 2d 5h)
• Lightweight and efficient (memory-only tracking, no databases)
• Perfect for Featherboard, TAB, and other PAPI-compatible plugins
• Plug & Play – no commands, no setup, no extra steps

Installation

1. Install PlaceholderAPI.
2. Place TFBMCSession.jar into your /plugins/ folder.
3. Restart your server.
4. Use the placeholder:

   %tfbmc_session%

Examples

Featherboard Example:

- 'Session: %tfbmc_session%'

Will display:

Session: 1h 12m 43s

TAB Example:

%tfbmc_session%

Will display the same formatted session time.

Lightweight. Accurate. Plug & Play. One Placeholder Only.