ScreenText
在屏幕的任意位置显示文本、计时器、计数器、纹理和 GIF 动画,支持背景、动画、移动、实时占位符等功能。可独立通过客户端命令使用,也可配合 ScreenTextPlugin 由服务器进行控制。
支持的版本
| 加载器 |
版本 |
| 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 |
功能特性
- 在屏幕上的任意位置、缩放比例和旋转角度显示文本
- 显示带 tick 音效的计时器(倒计时)和计数器(正计数,可选小数位)
- 在任何位置(包括全屏)显示纹理和 GIF 动画
- 背景:提供 4 种风格的纯色背景,或自定义自定义背景纹理 (新增)
- 入场/出场动画:缩放、滑动、像素化、故障风、弹跳、旋转等...
- 使用缓动函数、循环动画预设、自定义时间和颜色过渡,将任何显示元素移动到另一个位置
- 对每个显示元素和背景进行透明度控制
- 文本内嵌项目与纹理、HEX 颜色代码、多行文本
- 支持逐字延迟显示,并可选打字音效
- 占位符 (
%stp_...%):玩家状态、物品、效果、世界时间、FPS 等 (新增)
- 支持所有内容的Tab 补全,包括来自资源包的纹理路径 (新增)
- 本地显示内容会被保存,重启游戏后恢复
- 通过 ScreenTextPlugin (Spigot/Paper 1.20.1 → 26.2) 实现服务器控制:为所有玩家显示显示内容,新加入的玩家保留持久化数据,同步计时器和计时器动作
纹理文件夹
- 资源包:
assets/screentext/ → 使用时写为 assets/screentext/my_texture.png
- 配置文件夹:
config/screentext/textures/ → 使用时写为 screentext:my_texture.png(或直接写 my_texture.png)
- 原版纹理同样有效:
assets/minecraft/textures/...
修改纹理后,请使用 /screentext reload 重新加载。
示例
音量 50% 且带音效的计时器:
/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 纹理:
/screentext texture test 50 50 1.6 0 0 1 none none 1 false assets/screentext/cortinas_overlay.gif
带有 2 秒延迟的文本:
/screentext display ronda1_timer_text CENTER TOP 1 0 disablebackground 0 1 up_in up_out {"d:2"}#BAFF60ʀᴏɴᴅᴀ ɪ - ᴏᴠᴇʀᴡᴏʀʟᴅ
带有彩色圆角背景的文本:
/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!
带有自定义背景纹理的文本 (新增):
/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!
实时坐标 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
带小数位的计数器:
/screentext counter speedrun RIGHT TOP 1 0 disablebackground 0 1 none none none true &aTime: "timer"
全屏覆盖层:
/screentext texture overlay CENTER CENTER fullscreen 0 20 0.8 none none 1 true assets/screentext/vignette.png
使用循环预设和颜色变化移动显示元素:
/screentext move welcome CENTER 80 1.5 0 SMOOTH PULSE 1.5 #FF5555
/screentext move_reset welcome BOUNCE NONE 1
命令
基础命令:/screentext
文本:
/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>
计时器(倒计时):
/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>
计数器(正计数):
/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>
纹理 / GIF:
/screentext texture <id> <posX> <posY> <scale|fullscreen> <rotation> <fadeIn> <opacity> <animationIn> <animationOut> <gifspeed> <gifloop> <texturepath>
移动:
/screentext move <id> <posX> <posY> <scale> <rotation> [movetype] [animationpreset] [time] [color]
/screentext move_reset <id> [movetype] [animationpreset] [time]
其他:
/screentext remove <id|all> [fadeOutTicks]
/screentext list
/screentext reload
选项
| 选项 |
值 |
| posX / posY |
0–100(屏幕百分比)或 LEFT CENTER RIGHT / TOP CENTER DOWN |
| scale |
0.01–1000(纹理也接受 fullscreen) |
| rotation |
-360–360 |
| background |
enablebackground(颜色)· backgroundtexture(自定义纹理)· 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 或 HEX #RRGGBB |
| backstyle |
SQUARE ROUNDED SQUARE_SMALL ROUNDED_SMALL |
| backopacity / bgopacity / opacity |
0–1 |
| bgscale |
0–10(文本周围背景的大小) |
| 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 或任意声音 ID,例如 "block.note_block.pling"、"block.note_block.pling;vol:50" |
| decimals |
true / false |
| gifspeed |
0–2 |
| gifloop |
true / false(设为 false 时 GIF 播放一次后消失) |
| 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 秒 |
| color (move) |
none、颜色名称或 HEX #RRGGBB(仅限文本) |
提示
文本格式化
&a, &l... = Minecraft 颜色和格式代码
#RRGGBB = HEX 颜色,例如 #BAFF60Hello
\n 或 /n = 换行
| = 空格
计时器和计数器
- 计时器时间需放在引号内:
"00:05:00"、"05:00"。周围的文本会被保留:&cEnds in &f"00:01:30"
- 在计数器中,
"timer" 标记计数器的位置:&aTime: "timer" seconds
- 声音音量:添加
;vol:(0-100) → "customsound;vol:30"
延迟(逐字显示)
{"delay:<seconds>"}
{"d:<seconds>"}
{"delay:<seconds>;sound:<sound>"}
{"d:<seconds>;s:<sound>"}
内联项目
{"diamond"}
{"diamond,scale:1.5"}
{"diamond,scale:1.5,nbt:3"} ← nbt = CustomModelData
{"%stp_player_item_mainhand_id%"} ← 显示你手持的物品
内联纹理
{"assets/screentext/icon.png"}
{"assets/minecraft/textures/gui/sprites/hud/heart/full.png,scale:2"}
背景纹理 (NEW)
- 纹理会拉伸覆盖正常背景所占据的区域,因此
bgscale 可以使其变大或变小。
- 在
backgroundtexture 后按 Tab 键可查看资源包和 config/screentext/textures/ 中的全部纹理。
- PNG 和 GIF 均支持。
占位符
占位符实时更新。可在任何文本、计时器或计数器中使用。
客户端占位符 可在 /screentext 命令以及 ScreenTextPlugin 发出的服务器命令中使用。
[S] 服务器占位符 仅在服务器命令(/stp)中有效,因为客户端无法获知这些值。
玩家 – 位置
| 占位符 |
描述 |
%stp_player_x% %stp_player_y% %stp_player_z% |
方块坐标 |
%stp_player_x_exact% %stp_player_y_exact% %stp_player_z_exact% |
带两位小数的坐标 |
%stp_player_world% |
世界 / 维度 |
%stp_player_biome% |
生物群系 |
%stp_player_direction% |
基本方向(N, NE, E...) |
%stp_player_yaw% %stp_player_pitch% |
摄像机旋转角度 |
玩家 – 生命值、食物和经验值
| 占位符 |
描述 |
%stp_player_health% %stp_player_maxhealth% |
当前生命值 / 最大生命值 |
%stp_player_health_percent% |
生命值百分比 0–100 |
%stp_player_food% %stp_player_saturation% |
饥饿值 / 饱和度 |
%stp_player_absorption% |
吸收心数量 |
%stp_player_level% |
经验等级 |
%stp_player_xp_progress% |
升级进度 0–100 |
%stp_player_total_xp% |
总经验值 |
玩家 – 战斗与移动
| 占位符 |
描述 |
%stp_player_armor% %stp_player_armor_toughness% |
护甲值 / 护甲韧性 |
%stp_player_attack_speed% |
攻击速度 |
%stp_player_attack_damage% [S] |
攻击伤害 |
%stp_player_speed% %stp_player_speed_vertical% |
每秒移动的方块数 |
%stp_player_walk_speed% %stp_player_fly_speed% |
速度倍率 |
玩家 – 状态(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]
玩家 – 物品
| 占位符 |
描述 |
%stp_player_item_mainhand% %stp_player_item_offhand% |
物品名称 |
%stp_player_item_mainhand_id% %stp_player_item_offhand_id% |
物品 ID(含 :CustomModelData) |
%stp_player_item_mainhand_amount% %stp_player_item_offhand_amount% |
堆叠数量 |
%stp_player_item_mainhand_durability% %stp_player_item_offhand_durability% |
耐久度,例如 1561/1561 |
%stp_player_item_helmet% _chestplate% _leggings% _boots% (+ _id) |
盔甲 |
%stp_player_item_slot_<0-40>% (+ _id, _amount, _durability) |
任意槽位:0–8 快捷栏,9–35 背包,36 靴子,37 裤子,38 胸甲,39 头盔,40 副手 |
玩家 – 药水效果
| 占位符 |
描述 |
%stp_player_effect_list% |
激活的效果列表 |
%stp_player_effect_count% |
激活的效果数量 |
%stp_player_effect_<name>% |
若激活则显示效果名称 |
%stp_player_effect_<name>_active% |
true / false |
%stp_player_effect_<name>_level% |
等级(1, 2, 3...) |
%stp_player_effect_<name>_duration% |
剩余秒数 |
效果名称:speed、slowness、haste、strength、jump_boost、regeneration、resistance、fire_resistance、water_breathing、invisibility、night_vision、poison、wither、absorption、glowing、levitation、slow_falling、darkness...
玩家 – 杂项
| 占位符 |
描述 |
%stp_player_gamemode% |
游戏模式 |
%stp_player_ping% |
Ping 值(毫秒) |
%stp_player_air% %stp_player_max_air% |
空气量(秒) |
%stp_player_freeze_ticks% |
粉末雪冻结 |
%stp_player_online_survival% _creative% _adventure% _spectator% |
各游戏模式下的玩家数量 |
%stp_player_fire_ticks% [S] |
剩余燃烧时间 |
%stp_player_bed_exists% %stp_player_bed_x% _y% _z% [S] |
床重生点 |
%stp_player_stat_kills% _mob_kills% _deaths% _damage_dealt% _damage_taken% _jumps% [S] |
统计数据 |
%stp_player_stat_playtime% _playtime_hours% _playtime_minutes% [S] |
游戏时长 |
%stp_player_stat_distance_walked% _sprinted% _flown% _swum% [S] |
距离(方块) |
计时器与显示
| 占位符 |
描述 |
%stp_timer_<id>% |
格式化时间 |
%stp_timer_<id>_hours% _minutes% _seconds% _total_seconds% |
时间组成部分 |
%stp_timer_<id>_active% _finished% _stopped% |
true / false |
%stp_timer_<id>_progress% |
进度 0–100 |
%stp_timer_<id>_text% |
计时器文本 |
%stp_timer_count% |
活跃计时器数量 |
%stp_display_<id>_active% |
true / false |
%stp_display_count% %stp_display_list% |
活跃显示项 |
世界、服务器和时间
| 占位符 |
描述 |
%stp_fps% |
你的 FPS(仅客户端) |
%stp_server_online% |
在线玩家 |
%stp_server_weather% |
晴朗 / 雨 / 雷暴 |
%stp_server_world_time% |
游戏内时间(HH:MM) |
%stp_server_day% |
游戏内天数 |
%stp_server_max% [S] |
最大玩家数 |
%stp_server_tps% %stp_server_mspt% [S] |
服务器性能 |
%stp_server_uptime% [S] |
服务器运行时间 |
%stp_time% %stp_date% %stp_datetime% |
现实日期和时间 |
ScreenTextPlugin (服务端)
在 Spigot/Paper 服务器(1.20.1 → 26.2)上安装插件后,使用与 /stp <command> <player|@a> ... 相同的命令。一个插件可兼容 Fabric、Forge 和 NeoForge 客户端。
@a 显示项会被保存,并展示给稍后加入的玩家;被移除的显示项对他们同样不可见
- 重新连接后计时器保持同步,暂停的计时器继续保持暂停状态
- 计时器操作:当计时器结束或到达指定时间时执行控制台命令(
/stp timerconfig)
- 支持 PlaceholderAPI(包括所有
%stp_...% 服务端占位符)
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)
评论 0
登录后参与评分
还没有评论,来抢沙发吧