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

Loader	Versions
Fabric	1.20.1 · 1.20.4 · 1.21.1 · 1.21.4 · 1.21.5 · 1.21.8 · 1.21.11 · 26.2
NeoForge	1.20.1 · 1.20.4 · 1.21.1 · 1.21.4 · 1.21.5 · 1.21.8 · 1.21.11 · 26.2
Forge	1.20.1 · 1.20.4

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

Option	Values
posX / posY	0–100 (percent of the screen) or LEFT CENTER RIGHT / TOP CENTER DOWN
scale	0.01–1000 (textures also accept fullscreen)
rotation	-360–360
background	enablebackground (color) · backgroundtexture (custom texture) · disablebackground
backcolor	BLACK DARK_BLUE DARK_GREEN DARK_CYAN DARK_RED PURPLE ORANGE LIGHT_GRAY GRAY DARK_GRAY BLUE GREEN CYAN RED PINK YELLOW WHITE or HEX #RRGGBB
backstyle	SQUARE ROUNDED SQUARE_SMALL ROUNDED_SMALL
backopacity / bgopacity / opacity	0–1
bgscale	0–10 (size of the background around the text)
fadeIn	0–100 ticks
animationIn	none scale_in left_in right_in up_in down_in pixelate_in glitch_in bounce_in spin_in
animationOut	none scale_out left_out right_out up_out down_out pixelate_out glitch_out bounce_out spin_out
sound	none or any sound id, e.g. "block.note_block.pling", "block.note_block.pling;vol:50"
decimals	true / false
gifspeed	0–2
gifloop	true / false (with false the GIF plays once and disappears)
movetype	LINEAR SMOOTH STEP BOUNCE
animationpreset	NONE SHAKE WIGGLE PULSE X_CYCLE Y_CYCLE SPIN CIRCLE FLOAT SWING HEARTBEAT BREATHE GLITCH WAVE BOUNCE PENDULUM VIBRATE SWAY
time (move)	0.1–60 seconds
color (move)	none, a color name or HEX #RRGGBB (text only)

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

Placeholder	Description
%stp_player_x% %stp_player_y% %stp_player_z%	Block coordinates
%stp_player_x_exact% %stp_player_y_exact% %stp_player_z_exact%	Coordinates with 2 decimals
%stp_player_world%	World / dimension
%stp_player_biome%	Biome
%stp_player_direction%	Cardinal direction (N, NE, E...)
%stp_player_yaw% %stp_player_pitch%	Camera rotation

Player – health, food and XP

Placeholder	Description
%stp_player_health% %stp_player_maxhealth%	Health / max health
%stp_player_health_percent%	Health 0–100
%stp_player_food% %stp_player_saturation%	Food / saturation
%stp_player_absorption%	Absorption hearts
%stp_player_level%	XP level
%stp_player_xp_progress%	Progress to next level 0–100
%stp_player_total_xp%	Total XP

Player – combat and movement

Placeholder	Description
%stp_player_armor% %stp_player_armor_toughness%	Armor points / toughness
%stp_player_attack_speed%	Attack speed
%stp_player_attack_damage% [S]	Attack damage
%stp_player_speed% %stp_player_speed_vertical%	Speed in blocks/second
%stp_player_walk_speed% %stp_player_fly_speed%	Speed multipliers

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

Placeholder	Description
%stp_player_item_mainhand% %stp_player_item_offhand%	Item name
%stp_player_item_mainhand_id% %stp_player_item_offhand_id%	Item id (with :CustomModelData)
%stp_player_item_mainhand_amount% %stp_player_item_offhand_amount%	Stack amount
%stp_player_item_mainhand_durability% %stp_player_item_offhand_durability%	Durability, e.g. 1561/1561
%stp_player_item_helmet% _chestplate% _leggings% _boots% (+ _id)	Armor
%stp_player_item_slot_<0-40>% (+ _id, _amount, _durability)	Any slot: 0–8 hotbar, 9–35 inventory, 36 boots, 37 leggings, 38 chestplate, 39 helmet, 40 offhand

Player – potion effects

Placeholder	Description
%stp_player_effect_list%	Active effects
%stp_player_effect_count%	Number of active effects
%stp_player_effect_<name>%	Effect name if active
%stp_player_effect_<name>_active%	true / false
%stp_player_effect_<name>_level%	Level (1, 2, 3...)
%stp_player_effect_<name>_duration%	Seconds left

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

Placeholder	Description
%stp_player_gamemode%	Game mode
%stp_player_ping%	Ping in ms
%stp_player_air% %stp_player_max_air%	Air in seconds
%stp_player_freeze_ticks%	Powder snow freeze
%stp_player_online_survival% _creative% _adventure% _spectator%	Players in each game mode
%stp_player_fire_ticks% [S]	Fire time left
%stp_player_bed_exists% %stp_player_bed_x% _y% _z% [S]	Bed spawn
%stp_player_stat_kills% _mob_kills% _deaths% _damage_dealt% _damage_taken% _jumps% [S]	Statistics
%stp_player_stat_playtime% _playtime_hours% _playtime_minutes% [S]	Play time
%stp_player_stat_distance_walked% _sprinted% _flown% _swum% [S]	Distances in blocks

Timers and displays

Placeholder	Description
%stp_timer_<id>%	Formatted time
%stp_timer_<id>_hours% _minutes% _seconds% _total_seconds%	Time parts
%stp_timer_<id>_active% _finished% _stopped%	true / false
%stp_timer_<id>_progress%	Progress 0–100
%stp_timer_<id>_text%	Timer text
%stp_timer_count%	Active timers
%stp_display_<id>_active%	true / false
%stp_display_count% %stp_display_list%	Active displays

World, server and time

Placeholder	Description
%stp_fps%	Your FPS (client only)
%stp_server_online%	Online players
%stp_server_weather%	Clear / Rain / Thunder
%stp_server_world_time%	In-game time (HH:MM)
%stp_server_day%	In-game day
%stp_server_max% [S]	Max players
%stp_server_tps% %stp_server_mspt% [S]	Server performance
%stp_server_uptime% [S]	Server uptime
%stp_time% %stp_date% %stp_datetime%	Real date 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)