SimpleTextOnScreen

SimpleTextOnScreen is a lightweight and powerful plugin for Paper 1.21.11+ that allows you to display various messages on players' screens.
With this plugin you can send titles, subtitles, action bar messages, timers, and repeating messages to any player or group of players, with full support for color formatting using the & symbol.

Features

Title – large centered title on the screen.
Subtitle – smaller text appearing below the title.
ActionBar – text displayed above the hotbar.
Timer – countdown timer in the action bar (fully customizable text).
Repeat – repeating action bar messages with adjustable interval and number of repeats.
Flexible target selection – supports selectors @a (all), @p (nearest), @r (random), @s (self), as well as player names.
Color & formatting – use standard Minecraft color codes (e.g., &6, &l, &c, etc.).
Tab completion – auto-suggestions for commands and arguments.
Localization – all plugin messages are stored in lang.yml and can be easily translated.

Commands & Usage

The main command is /stos.

Syntax

/stos title <selector> <message> /stos subtitle <selector> <message> /stos actionbar <selector> <message> /stos timer <selector> <seconds> [message] /stos repeat <selector> <interval(sec)> <times> <message>

text

Arguments

Argument	Description
`<selector>`	`@a`, `@p`, `@r`, `@s` or a player name.
`<message>`	Text with color codes (`&`). For `timer`, you can use `%time%` placeholder.
`<seconds>`	Duration of the timer (integer).
`<interval>`	Time between repeats in seconds (integer).
`<times>`	Number of times to repeat (integer).

Examples

Send a title to all players:
/stos title @a &6Attention! &cServer restart in 5 minutes
Show a subtitle only to yourself:
/stos subtitle @s &aWelcome back!
Display an action bar message to a random player:
/stos actionbar @r &b+10 XP
Start a 10-second timer with a custom message:
/stos timer @a 10 &eTime left: &6%time% &eseconds
Repeat a message every 3 seconds, 5 times:
/stos repeat @p 3 5 &l&4WARNING!

Configuration

After the first start, the plugin creates a configuration folder plugins/SimpleTextOnScreen/ with the following files:

`config.yml`

Controls the fade-in, stay, and fade-out times for titles and subtitles (in ticks, 20 ticks = 1 second).

title:
  fade-in: 10
  stay: 70
  fade-out: 20
subtitle:
  fade-in: 10
  stay: 70
  fade-out: 20
lang.yml
All plugin messages are stored here. You can translate them into any language.

yaml
invalid-args: "&cUsage: /stos <type> [parameters]"
invalid-selector: "&cInvalid selector: %target%"
invalid-type: "&cInvalid type. Use title, subtitle, actionbar, timer, repeat."
no-permission: "&cYou don't have permission."
success: "&aMessage sent to %count% player(s)."
timer-start: "&aTimer started for %seconds% seconds."
repeat-start: "&aRepeating started (%times% times, interval %interval% sec)."
Permissions
stos.use – allows using the /stos command.
Default: op

Installation
Download SimpleTextOnScreen-1.0.2.jar.

Place it in your server's plugins folder.

Restart the server or run /reload confirm.

Edit config.yml and lang.yml if needed.

Requirements
Paper 1.21.11 or newer (may work on other Paper-based forks).

Java 21.

Support
If you encounter any issues or have suggestions, feel free to contact the author.
Your feedback helps improve the plugin!

License
This plugin is open-source and distributed under the MIT License.

Changelog (v1.0.2)
Renamed plugin to SimpleTextOnScreen, command changed to /stos.

Added timer and repeat features.

Fixed tab-complete error.

Improved localization system.

Code cleanup and optimization.

Thank you for using SimpleTextOnScreen!