
Particle Text
让你的世界有所表达。
自定义字体 · 粒子样式 · 实时服务器文本
欢迎玩家、标记入口,并将你的服务器信息融入风景之中。
浏览文档 · 查看源代码
在重生点上方放置欢迎标识,在传送门旁添加标签,或让随服务器变化的信息显示出来。Particle Text 将普通文本转化为持久的粒子展示,完美融入玩家所到之处。
在你所在的位置创建渲染器,选择字体和粒子类型,并在游戏中调整效果。保存的文本、位置和呈现方式将在重启后依然可用。
你的文字,你服务器的特色。
选择排版风格。 使用服务器 Java 环境中可用的字体族。选择 PLAIN(常规)、BOLD(粗体)、ITALIC(斜体)或 BOLD_ITALIC(粗斜体),然后独立设置字体大小与粒子间距。当字体名称包含空格时,请将其用引号括起来;输入 /pt fonts 可查看服务器可用的字体族列表。
选择粒子类型。 选择一种不需要额外数据的受支持粒子,例如 FLAME 或 END_ROD。调整间距、像素采样率和点数上限,以平衡视觉效果与性能开销。反转模式会在文本周围绘制背景像素。
/pt create welcome Welcome to the server
/pt font welcome "SansSerif" BOLD 24
/pt particle welcome END_ROD
/pt setsize welcome 0.20
字体命令控制的是栅格化后的字母形状。缩放比例控制的是粒子点之间的距离。无需重新创建渲染器即可更改其中任意一项。
标识应放置在玩家能看到的地方。
在你当前的位置和朝向创建文本。相对于你的视角,可向前、向后、向左、向右、向上或向下移动。围绕 X、Y 和 Z 轴设置旋转角度,以匹配入口、墙壁或悬浮展示的效果。
/pt move welcome up 1
/pt rotate welcome y 45
/pt tphere welcome
/pt teleport welcome 会将你传送到已保存的位置。如果目标世界未加载,则会返回明确的错误提示,而不是将已保存的渲染器移动到其他地方。
查找它。检查它。让它属于你。
通过 /pt list 浏览已保存的渲染器,悬停查看详情,并点击进入管理卡片。/pt info welcome 会显示文本、粒子、字体、间距、旋转角度、位置及当前状态。聊天快捷操作允许你进行传送、开始编辑、启用或禁用,以及准备删除命令。
更喜欢使用物品栏界面?输入 /pt menu 打开分页渲染器浏览器。左键点击进行传送,右键点击切换选中的渲染器。每个操作都会检查相应的权限。
/pt text welcome Welcome back to the server
/pt enabled welcome false
/pt enabled welcome true
当渲染器已经具备所需的设置或状态时,命令会返回明确的错误提示。尝试禁用一个已经禁用的显示不会再次宣告成功变更,也不会重写其保存的记录。
命令与权限参考
运行 /pt help 获取分页且感知权限的命令帮助。/particletext 是 /pt 的别名。渲染器 ID 仅使用小写字母、数字、下划线和连字符,最大长度为 32 个字符。
权限遵循 particletext.command.<action> 格式。编辑设置使用 particletext.command.edit,两种传送动作均使用 particletext.command.teleport,而 particletext.admin 授予管理员命令权限。操作员默认拥有管理员访问权限。版本信息默认对所有玩家可见。
阅读命令指南
展示形式由你掌控,贴合你的服务器。
安装 PlaceholderAPI 以解析渲染器文本中支持的占位符。Particle Text 会定期刷新解析后的内容,仅在文本发生变化时重建缓存的粒子点。文本在所有观看者之间共享,并使用全局占位符上下文。
内置的 Particle Text 扩展插件还使渲染器信息对其他兼容 PlaceholderAPI 的插件可用。当安装 PlaceholderAPI 时会自动注册,无需从 eCloud 下载。
- %particletext_total%:已保存渲染器的数量。
- %particletext_enabled% 和 %particletext_disabled%:按当前状态统计的数量。
- %particletext_nearest_id%:指定玩家所在世界中最近的渲染器 ID。
- %particletext_renderer:welcome:text%:名为 welcome 的渲染器中保存的文本。
- %particletext_renderer:welcome:enabled%:该渲染器的启用状态。
浏览占位符参考
呈现效果与性能预算由你决定。
调整性能负载。 设置渲染间隔、视距、每个渲染器的点数上限以及共享的粒子数据包预算。公平调度机制会在渲染器和粒子点之间轮换,确保在预算紧张时不会反复跳过相同的显示内容。
保持设置可编辑。 创建默认值、库存材质、音效、分页和移动量均存储在 YAML 文件中。MiniMessage 模板控制聊天文本、悬停描述、按钮、错误信息、菜单名称和物品描述(lore)。
带验证的热重载。 更改文件后运行 /pt reload。在替换当前活动状态之前,会对设置、消息和渲染器记录进行验证。无效的值将拒绝重载,并保留正在运行的配置。渲染器的编辑在发布其运行时状态前会使用原子文件替换。
迁移服务器时请备份 renderers.yml。保存的特定于渲染器的字体和变换与新显示使用的默认值是相互独立的。
从欢迎语开始,查看它所在的位置。
兼容 Minecraft 1.21.11 及更高版本的 Paper 及其分支,需运行在 Java 25 或更高版本上。不支持 Folia。PlaceholderAPI 为可选插件,字体渲染使用 Java 运行时的桌面模块。
下载 particle-text-2.0.2.jar,将其放入服务器的 plugins 文件夹并重启。默认配置文件和一个空的渲染器文件将自动安装。
/pt create welcome Welcome to the server
/pt move welcome up 1
/pt info welcome
bStats 指标
Particle Text 使用 bStats 收集匿名的聚合使用统计数据。服务器管理员可以通过其自身的配置文件来控制 bStats。

Particle Text
Give your world something to say.
Custom fonts · Particle styles · Live server text
Welcome players, mark an entrance, and make your server information part of the scenery.
Explore the documentation · Browse the source
A welcome sign above your spawn. A label beside a portal. A message that changes with your server. Particle Text turns ordinary text into persistent particle displays that fit the places players visit.
Create a renderer where you stand, choose its font and particle, and adjust the result in game. Saved text, position and presentation remain available after a restart.
Your words. Your server's character.
Choose the typography. Use the font families available to your server's Java environment. Choose PLAIN, BOLD, ITALIC or BOLD_ITALIC, then set the font size independently from particle spacing. Quote a font name when it contains spaces; /pt fonts lists the families your server can use.
Pick the particles. Select a supported particle that does not require extra data, such as FLAME or END_ROD. Tune spacing, pixel sampling and point limits to balance the look and workload. Inverted mode draws the background pixels around your text.
/pt create welcome Welcome to the server
/pt font welcome "SansSerif" BOLD 24
/pt particle welcome END_ROD
/pt setsize welcome 0.20
The font command controls the rasterized letters. The scale controls the distance between particle points. Change either without recreating the renderer.
A sign belongs where players will see it.
Create text at your current location and facing. Shift it forward, backward, left, right, up or down relative to your view. Set rotation around the X, Y and Z axes to match an entrance, wall or floating display.
/pt move welcome up 1
/pt rotate welcome y 45
/pt tphere welcome
/pt teleport welcome takes you back to its saved location. An unloaded world receives a clear error instead of moving the saved renderer elsewhere.
Find it. Inspect it. Make it yours.
Browse saved renderers with /pt list, hover for details and click through to a management card. /pt info welcome shows the text, particle, font, spacing, rotation, location and current state. Chat actions let you teleport, start editing, enable or disable, and prepare a delete command.
Prefer an inventory? /pt menu opens a paginated renderer browser. Left-click to teleport and right-click to toggle the selected renderer. Each action checks its own permission.
/pt text welcome Welcome back to the server
/pt enabled welcome false
/pt enabled welcome true
Commands report a clear error when the renderer already has the requested setting or state. Asking to disable an already disabled display does not announce another successful change or rewrite its saved record.
Command and permission reference
Run /pt help for paginated, permission-aware command help. /particletext is an alias of /pt. Renderer IDs use lowercase letters, digits, underscores and hyphens, with a maximum of 32 characters.
Permissions follow particletext.command.<action>. Editing settings use particletext.command.edit, both teleport actions use particletext.command.teleport, and particletext.admin grants the administrative commands. Operators receive administrative access by default. Version is available to everyone by default.
Read the command guide
A display that follows your server.
Install PlaceholderAPI to resolve supported placeholders inside renderer text. Particle Text periodically refreshes the resolved content, rebuilding its cached points only when the text changes. Text is shared across viewers and uses a global placeholder context.
The built-in Particle Text expansion also makes renderer information available to other PlaceholderAPI-compatible plugins. It registers automatically when PlaceholderAPI is installed; no eCloud download is needed.
- %particletext_total%: number of saved renderers.
- %particletext_enabled% and %particletext_disabled%: counts by current state.
- %particletext_nearest_id%: nearest renderer in the supplied player's world.
- %particletext_renderer:welcome:text%: saved text for the renderer named welcome.
- %particletext_renderer:welcome:enabled%: that renderer's enabled state.
Explore the placeholder reference
The presentation and its budget are yours.
Tune the workload. Set the rendering interval, viewing distance, per-renderer point cap and shared particle packet budget. Fair scheduling rotates through renderers and points so a tight budget does not repeatedly skip the same displays.
Keep the settings editable. Creation defaults, inventory materials, sounds, pagination and movement amounts live in YAML. MiniMessage templates control chat text, hover descriptions, buttons, errors, menu names and lore.
Reload with validation. Run /pt reload after changing files. Settings, messages and renderer records are validated before replacing active state. Invalid values reject the reload and keep the running configuration. Renderer edits use atomic file replacement before publishing their runtime state.
Back up renderers.yml when moving your server. Saved renderer-specific fonts and transforms remain independent from the defaults used for new displays.
Start with a welcome. See where it belongs.
Compatible with Paper and its forks for Minecraft 1.21.11 and later, running on Java 25 or newer. Folia is not supported. PlaceholderAPI is optional, and font rendering uses your Java runtime's desktop module.
Download particle-text-2.0.2.jar, place it in your server's plugins folder and restart. Default configuration and an empty renderer file are installed automatically.
/pt create welcome Welcome to the server
/pt move welcome up 1
/pt info welcome
bStats Metrics
Particle Text uses bStats for anonymous aggregate usage statistics. Server owners can control bStats through its own configuration.
评论 0
登录后参与评分
还没有评论,来抢沙发吧