Screentext

ScreenText

Display text, timers, counters, textures and GIFs anywhere on your screen, with backgrounds, animations, movement, live placeholders and more. Works on its own with client commands, or controlled from a server with ScreenTextPlugin.

Supported versions

Features

• Display text on the screen at any position, scale and rotation
• Display timers (countdown) and counters (count up, optional decimals) with tick sounds
• Display textures and GIFs anywhere, even fullscreen
• Backgrounds: solid color with 4 styles, or your own custom background texture (NEW)
• Entry / exit animations: scale, slide, pixelate, glitch, bounce, spin...
• Move any display to another position with easing, looping animation presets, custom time and text color transitions
• Opacity control for every display and background
• Inline items and textures inside text, HEX colors, multiline text
• Letter-by-letter delay with optional typing sound
• Placeholders (%stp_...%): player stats, items, effects, world time, FPS and more (NEW)
• Tab completion for everything, including texture paths from your resource packs (NEW)
• Local displays are saved and come back after restarting the game
• Server control with ScreenTextPlugin (Spigot/Paper 1.20.1 → 26.2): displays for all players, persistence for players who join later, synced timers and timer actions

Texture folders

• Resource pack: assets/screentext/ → use as assets/screentext/my_texture.png
• Config folder: config/screentext/textures/ → use as screentext:my_texture.png (or just my_texture.png)
• Vanilla textures also work: assets/minecraft/textures/...

Use /screentext reload to reload textures after changing them.

Examples

Timer with a sound at 50% volume:

/screentext timer ronda1_starting_timer CENTER TOP 1 0 disablebackground 0 1 none glitch_out "block.note_block.hat;vol:50" #BAFF60ʟᴀ ʀᴏɴᴅᴀ ɪ ɪɴɪᴄɪᴀ ᴇɴ: &f"00:00:11"

GIF texture that plays once:

/screentext texture test 50 50 1.6 0 0 1 none none 1 false assets/screentext/cortinas_overlay.gif

Text with a 2 second delay:

/screentext display ronda1_timer_text CENTER TOP 1 0 disablebackground 0 1 up_in up_out {"d:2"}#BAFF60ʀᴏɴᴅᴀ ɪ - ᴏᴠᴇʀᴡᴏʀʟᴅ

Text with a colored rounded background:

/screentext display welcome CENTER CENTER 2 0 enablebackground BLACK 0.6 ROUNDED 1.2 10 1 scale_in scale_out &eWelcome, &f%stp_player_level% levels!

Text with a custom background texture (NEW):

/screentext display banner CENTER 20 1.5 0 backgroundtexture assets/screentext/banner_bg.png 0.9 1.5 10 1 left_in right_out #FFD700Boss incoming!

Live coordinates HUD:

/screentext display coords LEFT TOP 1 0 enablebackground BLACK 0.4 SQUARE_SMALL 1 0 1 none none XYZ: %stp_player_x% %stp_player_y% %stp_player_z%/n%stp_player_biome% | %stp_fps% FPS

Counter with decimals:

/screentext counter speedrun RIGHT TOP 1 0 disablebackground 0 1 none none none true &aTime: "timer"

Fullscreen overlay:

/screentext texture overlay CENTER CENTER fullscreen 0 20 0.8 none none 1 true assets/screentext/vignette.png

Move a display with a looping preset and color change:

/screentext move welcome CENTER 80 1.5 0 SMOOTH PULSE 1.5 #FF5555
/screentext move_reset welcome BOUNCE NONE 1

Commands

Base command: /screentext

Text:
/screentext display <id> <posX> <posY> <scale> <rotation> enablebackground <backcolor> <backopacity> <backstyle> <bgscale> <fadeIn> <opacity> <animationIn> <animationOut> <text>
/screentext display <id> <posX> <posY> <scale> <rotation> backgroundtexture <texturepath> <bgopacity> <bgscale> <fadeIn> <opacity> <animationIn> <animationOut> <text>
/screentext display <id> <posX> <posY> <scale> <rotation> disablebackground <fadeIn> <opacity> <animationIn> <animationOut> <text>

Timer (counts down):
/screentext timer <id> <posX> <posY> <scale> <rotation> enablebackground <backcolor> <backopacity> <backstyle> <bgscale> <fadeIn> <opacity> <animationIn> <animationOut> <sound> <text + "HH:MM:SS">
/screentext timer <id> <posX> <posY> <scale> <rotation> backgroundtexture <texturepath> <bgopacity> <bgscale> <fadeIn> <opacity> <animationIn> <animationOut> <sound> <text + "HH:MM:SS">
/screentext timer <id> <posX> <posY> <scale> <rotation> disablebackground <fadeIn> <opacity> <animationIn> <animationOut> <sound> <text + "HH:MM:SS">
/screentext stoptimer <id>
/screentext resumetimer <id>

Counter (counts up):
/screentext counter <id> <posX> <posY> <scale> <rotation> enablebackground <backcolor> <backopacity> <backstyle> <bgscale> <fadeIn> <opacity> <animationIn> <animationOut> <sound> <decimals> <text + "timer">
/screentext counter <id> <posX> <posY> <scale> <rotation> backgroundtexture <texturepath> <bgopacity> <bgscale> <fadeIn> <opacity> <animationIn> <animationOut> <sound> <decimals> <text + "timer">
/screentext counter <id> <posX> <posY> <scale> <rotation> disablebackground <fadeIn> <opacity> <animationIn> <animationOut> <sound> <decimals> <text + "timer">
/screentext stoptimer <id>
/screentext resumetimer <id>

Texture / GIF:
/screentext texture <id> <posX> <posY> <scale|fullscreen> <rotation> <fadeIn> <opacity> <animationIn> <animationOut> <gifspeed> <gifloop> <texturepath>

Move:
/screentext move <id> <posX> <posY> <scale> <rotation> [movetype] [animationpreset] [time] [color]
/screentext move_reset <id> [movetype] [animationpreset] [time]

Other:
/screentext remove <id|all> [fadeOutTicks]
/screentext list
/screentext reload

Options

Tips

Text formatting

• &a, &l... = Minecraft color and format codes
• #RRGGBB = HEX color, e.g. #BAFF60Hello
• \n or /n = new line
• | = space

Timers and counters

• Timer time goes in quotes: "00:05:00", "05:00". Text around it is kept: &cEnds in &f"00:01:30"
• In counters, "timer" marks where the counter goes: &aTime: "timer" seconds
• Sound volume: add ;vol:(0-100) → "customsound;vol:30"

Delay (letter by letter)

{"delay:<seconds>"}
{"d:<seconds>"}
{"delay:<seconds>;sound:<sound>"}
{"d:<seconds>;s:<sound>"}

Inline items

{"diamond"}
{"diamond,scale:1.5"}
{"diamond,scale:1.5,nbt:3"}      ← nbt = CustomModelData
{"%stp_player_item_mainhand_id%"} ← shows the item you are holding

Inline textures

{"assets/screentext/icon.png"}
{"assets/minecraft/textures/gui/sprites/hud/heart/full.png,scale:2"}

Background textures (NEW)

• The texture is stretched over the area a normal background would cover, so bgscale makes it bigger or smaller.
• Press Tab after backgroundtexture to see every texture found in your resource packs and in config/screentext/textures/.
• PNG and GIF both work.

Placeholders

Placeholders update live. Use them in any text, timer or counter.

Client placeholders work in /screentext commands and in server commands from ScreenTextPlugin.
[S] Server placeholders only work in server commands (/stp), because the client can't know them.

Player – position

Player – health, food and XP

Player – combat and movement

Player – status (true / false)

%stp_player_is_flying% %stp_player_is_sneaking% %stp_player_is_sprinting% %stp_player_is_swimming% %stp_player_is_blocking% %stp_player_is_gliding% %stp_player_is_sleeping% %stp_player_is_dead% %stp_player_is_on_fire% %stp_player_is_in_water% %stp_player_is_on_ground% · %stp_player_is_op% [S]

Player – items

Player – potion effects

Effect names: speed, slowness, haste, strength, jump_boost, regeneration, resistance, fire_resistance, water_breathing, invisibility, night_vision, poison, wither, absorption, glowing, levitation, slow_falling, darkness...

Player – misc

Timers and displays

World, server and time

ScreenTextPlugin (servers)

With the plugin installed on a Spigot/Paper server (1.20.1 → 26.2), use the same commands as /stp <command> <player|@a> .... One plugin works with Fabric, Forge and NeoForge clients.

• @a displays are saved and shown to players who join later; removed displays are removed for them too
• Timers stay in sync after reconnecting, and paused timers stay paused
• Timer actions: run console commands when a timer ends or reaches a time (/stp timerconfig)
• PlaceholderAPI support (including all %stp_...% server placeholders)