Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
Supported versions: Paper: 1.18.2 — 1.21.x
Give your chest a unique name
Прочитать на русском
[🐲] Description
NamedChest is a unique plugin that allows you to give names to various blocks in Minecraft using commands, name tags, and anvils! The name will be displayed as a hologram when hovered over.
[⭐] Features
- [🔥] Display names as holograms on hover
- [🆕] WorldGuard support
- [🆕] DecentHolograms support
- [🆕] Dynamic hologram repositioning based on player movement
- Renaming using name tags, commands, and anvils
- Support for 15 blocks, ignoring vegetation and fluids
- Any Minecraft color code format
- Name length limits
- Configurable block search distance
- Enable / Disable the following features:
- Saving names when blocks are broken
- Restricting anvil usage
- Space support
- Name tag support
setandclearcommands
- Configurable cooldown for commands and name tags
- Support for 2 languages (English, Russian) + ability to add custom translations
- Version control and security
Display names as holograms on hover
This is the unique and main feature of the plugin. Names are displayed only when hovered over — this allows creating holograms only when needed, which significantly reduces the amount of Entity objects and lowers the server load.
The names appear next to the block on the side where the player is standing.
You can also install DecentHolograms on your server, then the plugin will create holograms using its more performant API.
WorldGuard support
If you have WorldGuard installed on your server, you can enable support for it in the plugin. To do this, change the support-worldguard parameter in config.yml to true.
support-worldguard: true
After this, players will not be able to set names in regions they do not own.
Dynamic hologram repositioning based on player movement
If a player looks at a block and simultaneously moves around it, the hologram will follow their movement, trying to always stay in the field of view.
Renaming using name tags, commands, and anvils
The plugin supports several methods for setting block names:
Using the /namedchest set and /namedchest clear commands
Using name tags
Using an anvil
You can enable / disable each method in config.yml by changing the following parameters:
# Forbid giving a name through an anvil / Запретить давать имя через наковальню
cancel-anvil: true
# Giving names through a name tag / Давать имена через бирку
support-name-tag: true
# Enable command /nc set | Включить команду /nc set
enable-set: true
# Enable command /nc clear | Включить команду /nc clear
enable-clear: true
Support for 15 blocks, ignoring vegetation and fluids
The plugin supports 15 blocks. These blocks include:
- CHEST (chest)
- TRAPPED_CHEST (trapped chest)
- BARREL (barrel)
- FURNACE (furnace)
- SMOKER (smoker)
- BLAST_FURNACE (blast furnace)
- HOPPER (hopper)
- DISPENSER (dispenser)
- DROPPER (dropper)
- BREWING_STAND (brewing stand)
- SHULKER_BOX (shulker box)
and all types of copper chests:
- WAXED_COPPER_CHEST
- WAXED_EXPOSED_COPPER_CHEST
- WAXED_WEATHERED_COPPER_CHEST
- WAXED_OXIDIZED_COPPER_CHEST
You can also ignore vegetation, water, and other passable blocks on hover. To do this, change the ignore-passable-blocks parameter in config.yml to true.
ignore-passable-blocks: true
Any Minecraft color code format
The plugin supports all types of text formatting in Minecraft.
- LEGACY — Color via & / § and HEX via &#rrggbb / §#rrggbb or &x&r&r&g&g&b&b / §x§r§r§g§g§b§b
- LEGACY_ADVANCED — Color and HEX via &##rrggbb / §##rrggbb
- MINI_MESSAGE — Color via <color>. Read more — https://docs.advntr.dev/minimessage/index.html
- And all formats available at https://www.birdflop.com/resources/rgb/
You can use all formats simultaneously when setting a name.
[🐍] Configuration (config.yml)
View config.yml
# ███╗░░██╗░█████╗░███╗░░░███╗███████╗██████╗░░░░█████╗░██╗░░██╗███████╗░██████╗████████╗
# ████╗░██║██╔══██╗████╗░████║██╔════╝██╔══██╗░░██╔══██╗██║░░██║██╔════╝██╔════╝╚══██╔══╝
# ██╔██╗██║███████║██╔████╔██║█████╗░░██║░░██║░░██║░░╚═╝███████║█████╗░░╚█████╗░░░░██║░░░
# ██║╚████║██╔══██║██║╚██╔╝██║██╔══╝░░██║░░██║░░██║░░██╗██╔══██║██╔══╝░░░╚═══██╗░░░██║░░░
# ██║░╚███║██║░░██║██║░╚═╝░██║███████╗██████╔╝░░╚█████╔╝██║░░██║███████╗██████╔╝░░░██║░░░
# ╚═╝░░╚══╝╚═╝░░╚═╝╚═╝░░░░░╚═╝╚══════╝╚═════╝░░░░╚════╝░╚═╝░░╚═╝╚══════╝╚═════╝░░░░╚═╝░░░
# Developer / Разработчик: ILeZzoV
# More plugins / Больше плагинов: https://t.me/ilezzov_plugins
# Socials / Ссылки:
# • Contact with me / Связаться: https://t.me/ilezovofficial
# • Telegram Channel / Телеграм канал: https://t.me/ilezzov_plugins
# • GitHub: https://github.com/ilezzov-code
# By me coffee / Поддержать разработчика:
# • DA: https://www.donationalerts.com/r/ilezov
# • YooMoney: https://yoomoney.ru/to/4100118180919675
# • Telegram Gift: https://t.me/ilezovofficial
# • TON: UQBENFaqzv19GBR1EnDKad_nAOB--Ofsdk1FeRU7W3xprRLY
# • BTC: bc1qn0f9yvcsacvedjk6qzu9cvagchkcz28gqrg2eh
# • ETH: 0xbE7f260b952b87578079C0D6E03d3641425718c9
# • Card: 2200700733487101
# Supporting messages languages / Доступные языки сообщений:
# en-US, ru-RU
language: en-US
version-control:
# Check for updates on server startup
# Проверять ли наличие обновлений при запуске сервера
check-on-startup: true
# Background update check interval
# Интервал автоматической проверки обновлений в фоне
check-interval:
enable: true
# TimeUnit: SECONDS, MINUTES, HOURS, DAYS
unit: HOURS
value: 6
# Notify administrators about new versions on join
# Отправлять ли администраторам уведомление о наличии новой версии при входе на сервер
notify-admins-on-join: true
security:
# Automatically disable the plugin if the current version is no longer supported or if a critical vulnerability is found
# Warning: Setting true may disable important functionality
# Автоматическое отключение плагина, если текущая версия больше не поддерживается или если обнаружена критическая уязвимость
# Внимание: Установка значения true может привести к отключению важной функциональности
lockdown-on-critical: false
# How often to spam online admins in chat
# about the need to urgently install a critical patch
# Set to 0 to notify only once on join
# Как часто спамить администраторам онлайн в чат
# о необходимости срочно установить критический патч
# Установите 0, чтобы уведомлять только один раз при входе
critical-notify-interval:
enable: true
# TimeUnit: SECONDS, MINUTES, HOURS, DAYS
unit: MINUTES
value: 10
# Blocks that can be named / Блоки, которым можно будет дать имя
# Supporting blocks / Поддерживаемые блоки: CHEST (сундук), TRAPPED_CHEST (сундук-ловушка),
# BARREL (бочка), FURNACE (печка), SMOKER (коптильня), BLAST_FURNACE (плавильня), HOPPER (воронка),
# DISPENSER (раздатчик), DROPPER (выбрасыватель), BREWING_STAND (варочная стойка), SHULKER_BOX (шалкер бокс)
supported-blocks:
- BARREL
- BLAST_FURNACE
- BREWING_STAND
- CHEST
- DISPENSER
- DROPPER
- FURNACE
- HOPPER
- SHULKER_BOX
- SMOKER
- TRAPPED_CHEST
- WAXED_COPPER_CHEST
- WAXED_EXPOSED_COPPER_CHEST
- WAXED_WEATHERED_COPPER_CHEST
- WAXED_OXIDIZED_COPPER_CHEST
# Whether to ignore passable obstacles (such as tall grass, signs, fluids, etc.) when hovering over a block
# Следует ли игнорировать проходимые, но встречающиеся препятствия (например, высокую траву, знаки, жидкости, ..) при наведение курсора на блок
ignore-passable-blocks: true
# Maximum distance to the block / Максимальная дистанция до блока
max-distance: 5
# Enable supporting WorldGuard / Включить поддержку WorldGuard
# WorldGuard is a Minecraft plugin — https://github.com/EngineHub/WorldGuard
support-worldguard: true
# Item's name settings / Настройки имени блока
name-settings:
# Enable support color name / Включить поддержку цветных имен
support-color: true
# Max name length / Максимальная длинна имени
max-length: 25
# Save the name when the block is destroyed / Сохранять имя при разрушении блока
save-when-breaking: false
# Forbid giving a name through an anvil / Запретить давать имя через наковальню
cancel-anvil: false
# Support for spaces in the name / Поддержка пробелов в имени
support-spaces: true
# Giving names through a name tag / Давать имена через бирку
support-name-tag: true
# Command settings / Настройки команд
command-settings:
# Enable command /nc set | Включить команду /nc set
enable-set: true
# Enable command /nc clear | Включить команду /nc clear
enable-clear: true
# Cooldown in using commands in seconds | Задержка на использование команд в секундах
cooldown: 5
# The sound of a rejected action / Звук отклоненного действия
error-sound:
enable: true
# Key sound / Ключ звука
sound: entity.villager.no
# Volume / Громкость
volume: 1.0
# Tone / Тон
pitch: 1.0
# The sound of success action / Звук успешного действия
success-sound:
enable: true
# Key sound / Ключ звука
sound: entity.experience_orb.pickup
# Volume / Громкость
volume: 1.0
# Tone / Тон
pitch: 2.0
debug: false
[💻] Commands and permissions
| Command | Description | Permissions |
|---|---|---|
/namedchest |
Command help | |
/namedchest reload |
Reload the plugin | namedchest.reload |
/namedchest version |
Get the latest plugin version | namedchest.version.command |
/namedchest set |
Set a block name | namedchest.name.set |
/namedchest clear |
Clear a block name | namedchest.name.clear |
Other permissions
| Permission | Description |
|---|---|
namedchest.* |
All plugin features |
namedchest.no_cooldown |
Disables cooldown for plugin functions |
namedchest.name.set.color |
Allow setting colored names |
namedchest.name.max.length |
Bypass name length limit |
namedchest.ignore_regions |
Ignore WorldGuard regions |
namedchest.version.notify |
Notify about new versions and critical patches |
[🖇️] Links
[❤️] Support the developer
- DA: https://www.donationalerts.com/r/ilezov
- YooMoney: https://yoomoney.ru/to/4100118180919675
- Telegram Gift: https://t.me/ilezovofficial
- TON: UQBENFaqzv19GBR1EnDKad_nAOB--Ofsdk1FeRU7W3xprRLY
- BTC: bc1qn0f9yvcsacvedjk6qzu9cvagchkcz28gqrg2eh
- ETH: 0xbE7f260b952b87578079C0D6E03d3641425718c9
- Card: 2200700733487101
[🌋] Report a bug
Found a bug, have a question, or want to give advice — https://github.com/ilezzov-code/NamedChest/issues/new
[🪪] License
This project is distributed under the GPL-3.0 License. For more details, see the LICENSE file.


