BiteRename

插件

· 作者 bitesize

在服务器上重命名、编辑和模板化物品的最强大且现代的方法

0 本站下载 0 关注 更新于 1 个月前

最新 1.0.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

Banner

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)联系我。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源