
BiteRename
重命名物品、编写描述文本,并将样式保存以备后用,一切都在游戏内完成。
▸ 概述
铁砧只能给你一个普通的名字且无法添加描述文本(Lore)。BiteRename 允许玩家通过一条命令为物品设置渐变色、十六进制颜色和多行描述文本。当玩家打造出完美的物品样式后,他们可以将该样式复制到另一个物品上,或者将其保存为模板,以便随时重复使用。管理员可以通过功能开关、黑名单、限制以及可选的 Vault 或经验值费用来保持对功能的控制。
▸ 主要特性
- 现代格式化: 支持 MiniMessage 渐变、HEX 颜色代码以及经典的
& 代码,甚至可以在同一行中混合使用。
- 复制与粘贴: 复制物品的名称、描述文本和隐藏标签,然后将其粘贴到另一个物品上。
- 持久化模板: 按名称保存你喜欢的样式,并可以随时应用,即使重启服务器后依然有效。
- API 集成: 完全支持 Vault 用于经济费用,支持 PlaceholderAPI 用于在名称和描述文本中使用实时变量。
- 兼容 Spigot、Paper 与 Purpur: 一个 Jar 文件即可在这三种服务端上运行,且已在每种服务端上经过测试。
▸ 格式化
每个名称和描述文本行都同时支持 MiniMessage 和旧版代码。名称和描述文本显示为直立字体,不带原版斜体效果。
| 示例 |
结果 |
<red>Ruby, <gold>Gilded |
命名颜色 |
<#FF0368>Magenta, &#FF0368Magenta |
HEX 颜色 |
<gradient:#FF0368:#4ECDC4>Bitesize</gradient> |
平滑渐变(也支持彩虹色) |
<bold>, <italic>, <underlined>, <strikethrough> |
装饰效果 |
&c&lBold Red |
经典旧版代码 |
/br lore add &r |
空白的描述文本行,用于增加间距 |
仅允许使用视觉标签,因此玩家无法将右键点击、悬停提示或选择器标签应用到物品上。
▸ 其他特性
- 所有消息均可在
messages.yml 中完全自定义配置。
- 智能 TAB 补全建议子命令、已保存的模板以及你手中物品上的确切描述文本行。
- 包含词法和物品黑名单,这些限制无法通过颜色代码绕过,同时还提供长度和描述文本行数限制。
- 可以单独开启或关闭任何功能:重命名、描述文本、清除、隐藏标签、复制/粘贴以及模板。
- 玩家仅在每次检查通过后才会被收费,因此没有人会为失败的编辑付费。
- 轻量级:无需安装额外依赖,模板保存操作在后台静默进行。
▸ 物品命令
| 命令 |
描述 |
权限 |
/br rename <name> |
重命名手持物品 |
biterename.rename |
/br lore add <text> |
添加一行描述文本 |
biterename.lore |
/br lore delline <line> |
移除一行描述文本 |
biterename.lore |
/br clear [name|lore] |
清除名称、描述文本或两者 |
biterename.clear |
/br hide <enchants|attributes> |
隐藏附魔或属性 |
biterename.hide |
/br unhide <enchants|attributes> |
重新显示它们 |
biterename.hide |
/br copy |
复制名称、描述文本和标签 |
biterename.copypaste |
/br paste |
将剪贴板内容粘贴到物品上 |
biterename.copypaste |
/br help |
显示帮助菜单 |
biterename.use |
▸ 模板命令
| 命令 |
描述 |
权限 |
/br template save <name> |
将当前物品的样式保存为模板 |
biterename.templates |
/br template load <name> |
将模板应用到你的物品上 |
biterename.templates |
/br template delete <name> |
删除一个模板 |
biterename.templates |
/br templates |
列出你的模板 |
biterename.templates |
▸ 管理员命令与权限
| 命令 / 权限 |
描述 |
/br reload |
重载配置和消息 (biterename.admin) |
biterename.bypass.cost |
执行任何操作都不会被收费 |
biterename.bypass.blacklist |
可以使用被屏蔽的词并编辑被屏蔽的物品 |
biterename.placeholders |
为该玩家的文本填充 PlaceholderAPI 占位符 |
biterename.* |
所有 BiteRename 权限 |
所有权限默认给予 OP(管理员)。所有命令也可以使用 /biterename 作为前缀。
▸ 配置
- 功能: 可单独切换重命名、描述文本、清除、隐藏、复制/粘贴和模板功能。
- 限制: 最大描述文本行数、名称和描述文本长度(格式化不计入),以及每位玩家的模板数量。
- 格式化: 直立(非斜体)文本和空白描述文本行,每项均可独立切换。
- 黑名单: 被屏蔽的词(忽略大小写和格式)以及不可编辑的物品。
- 经济系统: 支持
NONE(无)、VAULT 或 XP(经验值),每种操作的费用可单独设置。
config.yml
features:
rename: true
lore: true
clear: true
hide: true
clipboard: true # /br copy and /br paste
templates: true
limits:
max-lore-lines: 10
max-name-length: 0
max-lore-length: 0
max-templates: 0 # per player
formatting:
upright-text: true
allow-empty-lore-lines: true
blacklists:
words:
- "admin"
- "owner"
- "staff"
materials:
- "BEDROCK"
- "BARRIER"
- "COMMAND_BLOCK"
economy:
type: "NONE" # NONE, VAULT, or XP
costs:
rename: 0.0
lore-add: 0.0
lore-delline: 0.0
clear-all: 0.0
clear-name: 0.0
clear-lore: 0.0
hide: 0.0
paste: 0.0
template-load: 0.0
▸ 消息
所有消息均位于 messages.yml 中,分为 errors(错误)、messages(消息)和 help(帮助)三个部分,并完全支持 MiniMessage。你可以设置自己的前缀和错误前缀,并使用以下变量:
| 变量 |
含义 |
<label> |
使用的命令标签(例如 br) |
<max> |
配置的限额 |
<line> |
描述文本的行号 |
<cost> |
操作的费用(例如 $100 或 5) |
<template> / <templates> |
模板名称 / 玩家的模板列表 |
更新中添加的新消息会自动填充,因此你无需重新生成该文件。
▸ 软依赖
- Vault API: 如果您想为编辑操作收费,则需要此插件(兼容 Vault、VaultUnlocked 以及任何经济类插件)。
- PlaceholderAPI: 如果您想在名称和物品描述中使用变量(如
%player_name% 等),则需要此插件。
▸ 兼容性
- Minecraft: 26.3
- 服务器端: Spigot、Paper 和 Purpur
- Java: 25
首次启动时,服务器会下载一次 Kotlin 标准库,因此需要联网访问。
▸ 从 LRename 迁移?
BiteRename 是 LRename 的继任者。将其放入后,在首次启动时会自动导入玩家已保存的模板。
▸ 视频教程
▸ 支持
如果在任何环节感到迷茫、困惑或卡住?请通过此处、GitHub 或 Discord(用户名:.bite.size)联系我。

BiteRename
Rename items, write lore, and save the look for later, all in-game.
▸ Overview
Anvils give you one plain name and no lore. BiteRename gives your players gradients, hex colors, and multi-line lore with a single command. When they've styled the perfect item, they can copy that look onto another item or save it as a template to reuse whenever they like. Admins stay in control with feature toggles, blacklists, limits, and optional Vault or XP costs.
▸ Key Features
- Modern Formatting: MiniMessage gradients, HEX colors, and classic
& codes, even mixed in the same line.
- Copy & Paste: Copy an item's name, lore, and hidden flags, then paste them onto another item.
- Persistent Templates: Save your favorite looks by name and apply them any time, even after a restart.
- API Integrations: Full Vault support for economy costs and PlaceholderAPI support for live variables in names and lore.
- Spigot, Paper & Purpur: One jar that runs on all three, tested on each.
▸ Formatting
Every name and lore line understands both MiniMessage and legacy codes. Names and lore show upright, without the vanilla italics.
| Example |
Result |
<red>Ruby, <gold>Gilded |
Named colors |
<#FF0368>Magenta, &#FF0368Magenta |
HEX colors |
<gradient:#FF0368:#4ECDC4>Bitesize</gradient> |
Smooth gradients (rainbows too) |
<bold>, <italic>, <underlined>, <strikethrough> |
Decorations |
&c&lBold Red |
Classic legacy codes |
/br lore add &r |
A blank lore line to space things out |
Only visual tags are allowed, so players can't sneak click, hover, or selector tags onto items.
▸ Additional Features
- Every single message is completely configurable in the
messages.yml.
- Smart TAB completion suggests subcommands, your saved templates, and the exact lore lines on the item you're holding.
- Word and item blacklists that can't be dodged with color codes, plus length and lore line limits.
- Turn any feature on or off: renaming, lore, clearing, hiding flags, copy/paste, and templates.
- Players are only charged once every check has passed, so nobody pays for a failed edit.
- Lightweight: nothing extra to install, and template saves are written in the background.
▸ Item Commands
| Command |
Description |
Permission |
/br rename <name> |
Rename the held item |
biterename.rename |
/br lore add <text> |
Add a lore line |
biterename.lore |
/br lore delline <line> |
Remove a lore line |
biterename.lore |
/br clear [name|lore] |
Clear the name, lore, or both |
biterename.clear |
/br hide <enchants|attributes> |
Hide enchantments or attributes |
biterename.hide |
/br unhide <enchants|attributes> |
Show them again |
biterename.hide |
/br copy |
Copy the name, lore, and flags |
biterename.copypaste |
/br paste |
Paste your clipboard onto an item |
biterename.copypaste |
/br help |
Show the help menu |
biterename.use |
▸ Template Commands
| Command |
Description |
Permission |
/br template save <name> |
Save your item's look as a template |
biterename.templates |
/br template load <name> |
Apply a template to your item |
biterename.templates |
/br template delete <name> |
Delete a template |
biterename.templates |
/br templates |
List your templates |
biterename.templates |
▸ Admin Commands & Permissions
| Command / Permission |
Description |
/br reload |
Reload config & messages (biterename.admin) |
biterename.bypass.cost |
Never charged for actions |
biterename.bypass.blacklist |
Can use blocked words and edit blocked items |
biterename.placeholders |
PlaceholderAPI placeholders are filled in for this player's text |
biterename.* |
Every BiteRename permission |
All permissions default to op. Every command also works as /biterename.
▸ Configuration
- Features: Toggle renaming, lore, clearing, hiding, copy/paste, and templates individually.
- Limits: Max lore lines, name and lore length (formatting doesn't count), and templates per player.
- Formatting: Upright (non-italic) text and blank lore lines, each toggleable.
- Blacklists: Blocked words (case and formatting ignored) and items that can't be edited.
- Economy:
NONE, VAULT, or XP, with a separate cost for each action.
config.yml
features:
rename: true
lore: true
clear: true
hide: true
clipboard: true # /br copy and /br paste
templates: true
limits:
max-lore-lines: 10
max-name-length: 0
max-lore-length: 0
max-templates: 0 # per player
formatting:
upright-text: true
allow-empty-lore-lines: true
blacklists:
words:
- "admin"
- "owner"
- "staff"
materials:
- "BEDROCK"
- "BARRIER"
- "COMMAND_BLOCK"
economy:
type: "NONE" # NONE, VAULT, or XP
costs:
rename: 0.0
lore-add: 0.0
lore-delline: 0.0
clear-all: 0.0
clear-name: 0.0
clear-lore: 0.0
hide: 0.0
paste: 0.0
template-load: 0.0
▸ Messages
Every message lives in messages.yml, grouped into errors, messages, and help, with full MiniMessage support. Set your own prefix and error prefix, and use these variables:
| Variable |
Meaning |
<label> |
The command label used (e.g. br) |
<max> |
A configured limit |
<line> |
A lore line number |
<cost> |
The cost of an action (e.g. $100 or 5) |
<template> / <templates> |
A template name / the player's template list |
New messages added in updates are filled in automatically, so you never have to regenerate the file.
▸ Soft Dependencies
- Vault API: Needed if you want to charge money for edits (works with Vault or VaultUnlocked plus any economy plugin).
- PlaceholderAPI: Needed if you want variables (
%player_name%, etc.) in names and lore.
▸ 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.
▸ Coming from LRename?
BiteRename is the successor to LRename. Drop it in and your players' saved templates are imported automatically on the first start.
▸ Video Tutorial
▸ Support
Lost, confused, or stuck at any point? Reach out to me here, on GitHub, or on Discord (username: .bite.size).
评论 0
登录后参与评分
还没有评论,来抢沙发吧