
BiteDisplays
在游戏中放置和样式化的 NPC、全息图以及物品与方块展示。
▸ 概述
你的出生点值得拥有比告示牌更丰富的内容。BiteDisplays 允许你放置拥有真实玩家皮肤、浮动文本以及任意物品或方块的展示实体,且位置就在你站立的地方。你可以使用渐变和十六进制颜色对其进行样式设置,让它们在玩家点击时执行命令,并通过一个简单的命令在游戏内管理所有内容。
▸ 主要功能
- 四种实体类型: 带有皮肤、装备和任意尺寸的 NPC,多行文本展示,以及物品和方块展示。
- 点击动作: 右键点击 NPC、文本及物品和方块展示时,可以以控制台或玩家身份(
@p 已填入)运行命令。NPC 还可以播放声音。
- 现代格式支持: 名称和每一行都支持 MiniMessage 渐变、HEX 颜色和装饰效果。经典的
& 代码同样适用。
- 指向即编辑: 新创建的实体会自动为你选中。观察其他任意实体,或在列表中点击 [SELECT],然后移动、检查或删除它。
- 兼容 Spigot、Paper 与 Purpur: 一个 JAR 文件即可在这三种服务端上运行,且已在每种服务端上经过测试。
▸ 格式支持
名称、描述和文本行均支持 MiniMessage 格式。
| 示例 |
结果 |
<red>Ruby, <gold>Gilded |
命名颜色 |
<#FF0368>Magenta |
HEX 颜色 |
<gradient:#FF0368:#4ECDC4>Bitesize</gradient> |
平滑渐变(也支持彩虹色) |
<bold>, <italic>, <underlined>, <strikethrough> |
装饰效果 |
&a, &l, &#FF0368 |
经典颜色代码 |
在 Paper 和 Purpur 上,文本保留所有 MiniMessage 特性,例如自定义字体。
▸ 其他功能
messages.yml 中可完全配置每一条消息。
- 智能 TAB 补全建议:操作、发光颜色、游戏中所有声音、用于皮肤的在线玩家、实体 ID 以及你所选文本展示的各行内容。
- 装备菜单:为你的 NPC 穿戴任何盔甲和手持物品。
- 不可伤害的 NPC,即使在创造模式下也无法被玩家伤害。
- 弹跳的物品展示,可发出任意颜色的光芒,文本展示会自动转向面向玩家。
- 可单独开启或关闭 NPC、物品、方块或文本展示。
- 轻量级:实体使用的是原版假人 (mannequins) 和展示实体,数据保存到主线程之外的一个文件中,仅在区块加载时生成。
▸ 创建
| 命令 |
描述 |
/bd create npc [name] |
在你站立的位置创建一个 NPC |
/bd create text <text> |
创建一个带有第一行文本的文本展示 |
/bd create item [name] / /bd create block [name] |
展示你手中持有的物品或方块 |
▸ 编辑
编辑命令作用于你当前选中的实体,无论它是什么类型。如果某个命令不适用于该类型,它会提示你该命令适用于哪些类型。
| 命令 |
适用对象 |
描述 |
/bd name [name] |
NPC, 物品, 方块 |
设置名称 |
/bd size <scale> |
所有 |
调整缩放比例 |
/bd glow [color] |
NPC, 物品, 方块 |
以颜色名称(展示实体可使用 HEX 值)发光 |
/bd cmd [<console|player> <command>] |
所有 |
右键点击时运行命令 |
/bd rotate <yaw|pitch> <degrees> |
物品, 方块 |
旋转角度 |
/bd setblock / /bd setitem |
方块 / 物品 |
替换为你手中持有的方块或物品 |
/bd skin <player> |
NPC |
使用某玩家的皮肤 |
/bd desc [text] |
NPC |
设置名称下方的行 |
/bd sound [sound] |
NPC |
右键点击时播放声音 |
/bd equipment |
NPC |
打开装备菜单 |
/bd addline <text> / editline <line> <text> / delline <line> |
文本 |
添加、替换或删除一行 |
/bd background [hex] |
文本 |
设置背景颜色 |
/bd shadow <true|false> |
文本 |
投射阴影(默认关闭) |
/bd billboard <true|false> |
文本 |
转向面向玩家(默认开启) |
/bd bouncing <true|false> |
物品 |
使物品上下弹跳 |
省略 [value] 即可移除该属性。在命令中,@p 代表点击的玩家。/bd help <type> 列出某一类型的所有命令。
▸ 实体管理与权限
| 命令 / 权限 |
描述 |
/bd select [id] |
选择你正在注视的实体,或通过 ID(如 npc-1)选择 |
/bd movehere |
将你的选中实体移动到你自己所在的位置 |
/bd setlocation <x> <y> <z> |
将实体移动到精确坐标 |
/bd remove |
移除你的选中实体 |
/bd info |
显示你选中实体的详细信息 |
/bd list [type] [page] |
列出所有带有 [SELECT] 按钮的实体,或仅列出某一类型,每页 10 个 |
/bd save / /bd reload |
保存实体 / 重新加载配置和消息(需要 bitedisplays.admin 权限) |
bitedisplays.npc, .text, .item, .block |
各实体类型的命令权限 |
bitedisplays.manage |
选择、移动、移除、检查和列出实体的权限 |
bitedisplays.* |
BiteDisplays 的所有权限 |
所有权限默认赋予 OP(管理员)。每个命令也可以使用 /bitedisplays 前缀执行。
▸ 配置
- 功能: 单独切换 NPC、物品、方块和文本展示功能的开关。
- 选择范围:
/bd select 命令的作用距离。
- 点击: 可选的点击冷却时间,默认关闭。
- 文本: 新建文本展示时的默认背景和广告牌模式。
- 动画: 物品弹跳的高度和速度、展示实体的渲染距离,以及实体自动保存的频率。
config.yml
features:
npc: true
item: true # 物品展示
block: true # 方块展示
text: true # 文本展示
selection:
range: 5.0
clicks:
cooldown: 0 # 刻 (ticks)
text:
default-background: "#40000000"
default-billboard: true
displays:
view-range: 1.0
animations:
bounce:
period: 160
height: 0.12
storage:
autosave: 5 # 分钟
▸ 消息
每条消息都位于 messages.yml 中,分为 errors(错误)、messages(消息)、help(帮助)、info(信息)和 gui(GUI)组,完整支持 MiniMessage 和 & 代码。你可以设置自己的前缀和错误前缀,重命名实体类型,并使用 <type>、<id>、<name>、<command> 和 <line> 等变量。
更新中新增的消息会自动填充,因此您无需重新生成文件。
▸ 兼容性
- Minecraft: 26.3
- 服务器: Spigot、Paper 和 Purpur
- Java: 25
首次启动时,服务器会下载一次 Kotlin 标准库,因此需要访问互联网。
▸ 视频教程
即将推出……
▸ 支持
如果您在任何时候感到迷茫或遇到困难?请通过以下方式联系我:GitHub 或 Discord(用户名:.bite.size)。

BiteDisplays
NPCs, holograms, and item and block displays, placed and styled in-game.
▸ Overview
Your spawn deserves more than signs. BiteDisplays lets you place NPCs with real player skins, floating text, and displays of any item or block right where you stand. Style them with gradients and hex colors, have them run commands when players click them, and manage all of it in-game with one simple command.
▸ Key Features
- Four Entity Types: NPCs with skins, equipment, and any size, multi-line text displays, and item and block displays.
- Click Actions: NPCs, text, and item and block displays run a command when right-clicked, as the console or the player, with
@p filled in. NPCs can play a sound too.
- Modern Formatting: MiniMessage gradients, HEX colors, and decorations in every name and line. Classic
& codes work too.
- Point & Edit: New entities are selected for you. Look at any other one, or click [SELECT] in the list, then move, inspect, or remove it.
- Spigot, Paper & Purpur: One jar that runs on all three, tested on each.
▸ Formatting
Names, descriptions, and text lines all understand MiniMessage.
| Example |
Result |
<red>Ruby, <gold>Gilded |
Named colors |
<#FF0368>Magenta |
HEX colors |
<gradient:#FF0368:#4ECDC4>Bitesize</gradient> |
Smooth gradients (rainbows too) |
<bold>, <italic>, <underlined>, <strikethrough> |
Decorations |
&a, &l, &#FF0368 |
Classic color codes |
On Paper and Purpur, text keeps every MiniMessage feature, like custom fonts.
▸ Additional Features
- Every single message is completely configurable in the
messages.yml.
- Smart TAB completion suggests actions, glow colors, every game sound, online players for skins, entity IDs, and the lines on your selected text display.
- An equipment menu to dress your NPCs in any armor and held items.
- NPCs that can't be hurt, even by players in creative mode.
- Bouncing item displays, glowing in any color, and text that turns to face players.
- Turn NPCs, item, block, or text displays on or off individually.
- Lightweight: entities are vanilla mannequins and displays, saved to one file off the main thread and spawned only as their chunks load.
▸ Creating
| Command |
Description |
/bd create npc [name] |
Create an NPC where you stand |
/bd create text <text> |
Create a text display with its first line |
/bd create item [name] / /bd create block [name] |
Display the item or block you're holding |
▸ Editing
Editing commands work on your selection, whatever it is. If one doesn't fit, it tells you which types it works on.
| Command |
Works on |
Description |
/bd name [name] |
NPC, item, block |
Set the name |
/bd size <scale> |
All |
Scale it |
/bd glow [color] |
NPC, item, block |
Glow in a color name (or HEX for displays) |
/bd cmd [<console|player> <command>] |
All |
Run a command on right-click |
/bd rotate <yaw|pitch> <degrees> |
Item, block |
Rotate it |
/bd setblock / /bd setitem |
Block / item |
Swap in the block or item you're holding |
/bd skin <player> |
NPC |
Use a player's skin |
/bd desc [text] |
NPC |
Set the line under the name |
/bd sound [sound] |
NPC |
Play a sound on right-click |
/bd equipment |
NPC |
Open the equipment menu |
/bd addline <text> / editline <line> <text> / delline <line> |
Text |
Add, replace, or remove a line |
/bd background [hex] |
Text |
Set the background color |
/bd shadow <true|false> |
Text |
Drop shadow (off by default) |
/bd billboard <true|false> |
Text |
Turn to face players (on by default) |
/bd bouncing <true|false> |
Item |
Bob the item up and down |
Leave out a [value] to remove it. In commands, @p is the player who clicked. /bd help <type> lists every command for one type.
▸ Managing Entities & Permissions
| Command / Permission |
Description |
/bd select [id] |
Select the entity you're looking at, or by ID like npc-1 |
/bd movehere |
Move your selection to you |
/bd setlocation <x> <y> <z> |
Move it to exact coordinates |
/bd remove |
Remove your selection |
/bd info |
Show your selection's details |
/bd list [type] [page] |
List every entity with a [SELECT] button, or one type, 10 to a page |
/bd save / /bd reload |
Save entities / reload config & messages (bitedisplays.admin) |
bitedisplays.npc, .text, .item, .block |
Each entity type's commands |
bitedisplays.manage |
Select, move, remove, inspect, and list |
bitedisplays.* |
Every BiteDisplays permission |
All permissions default to op. Every command also works as /bitedisplays.
▸ Configuration
- Features: Toggle NPCs, item, block, and text displays individually.
- Selection: How far away
/bd select reaches.
- Clicks: An optional cooldown between clicks, off by default.
- Text: The default background and billboard of new text displays.
- Animations: The height and speed of bouncing items, how far away displays render, and how often entities autosave.
config.yml
features:
npc: true
item: true # item displays
block: true # block displays
text: true # text displays
selection:
range: 5.0
clicks:
cooldown: 0 # ticks
text:
default-background: "#40000000"
default-billboard: true
displays:
view-range: 1.0
animations:
bounce:
period: 160
height: 0.12
storage:
autosave: 5 # minutes
▸ Messages
Every message lives in messages.yml, grouped into errors, messages, help, info, and gui, with full MiniMessage and & code support. Set your own prefix and error prefix, rename the entity types, and use variables like <type>, <id>, <name>, <command>, and <line>.
New messages added in updates are filled in automatically, so you never have to regenerate the file.
▸ Compatibility
- Minecraft: 26.3
- Servers: Spigot, Paper, and Purpur
- Java: 25
On first start, the server downloads the Kotlin standard library once, so it needs internet access.
▸ Video Tutorial
Coming soon...
▸ Support
Lost, confused, or stuck at any point? Reach out to me here, on GitHub, or on Discord (username: .bite.size).
评论 0
登录后参与评分
还没有评论,来抢沙发吧