<h4>Supported versions: Paper: 1.18.2 — 1.21.x</h4>
<h1>Give your chest a unique name</h1>

Прочитать на русском

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.

• [🔥] 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
  • set and clear commands
• Configurable cooldown for commands and name tags
• Support for 2 languages (English, Russian) + ability to add custom translations
• Version control and security

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.

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.

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.

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

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

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 . 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.

# ███╗░░██╗░█████╗░███╗░░░███╗███████╗██████╗░░░░█████╗░██╗░░██╗███████╗░██████╗████████╗
# ████╗░██║██╔══██╗████╗░████║██╔════╝██╔══██╗░░██╔══██╗██║░░██║██╔════╝██╔════╝╚══██╔══╝
# ██╔██╗██║███████║██╔████╔██║█████╗░░██║░░██║░░██║░░╚═╝███████║█████╗░░╚█████╗░░░░██║░░░
# ██║╚████║██╔══██║██║╚██╔╝██║██╔══╝░░██║░░██║░░██║░░██╗██╔══██║██╔══╝░░░╚═══██╗░░░██║░░░
# ██║░╚███║██║░░██║██║░╚═╝░██║███████╗██████╔╝░░╚█████╔╝██║░░██║███████╗██████╔╝░░░██║░░░
# ╚═╝░░╚══╝╚═╝░░╚═╝╚═╝░░░░░╚═╝╚══════╝╚═════╝░░░░╚════╝░╚═╝░░╚═╝╚══════╝╚═════╝░░░░╚═╝░░░

# Developer / Разработчик: ILeZ✨
# More plugins / Больше плагинов: https://t.me/ilez✨_plugins

# Socials / Ссылки:
# • Contact with me / Связаться: https://t.me/ile✨official
# • Telegram Channel / Телеграм канал: https://t.me/ilez✨_plugins
# • GitHub: https://github.com/ilez✨-code

# By me coffee / Поддержать разработчика:
# • DA: https://www.donationalerts.com/r/ile✨
# • YooMoney: https://yoomoney.ru/to/4100118180919675
# • Telegram Gift: https://t.me/ile✨official
# • 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

</details>

## 
| 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        |

## 
* Contact: TG, Email
* Telegram channel: click
* Modrinth: [click](/plugins/namedchest)
* SpigotRU: click
* Hangar: soon

## 
* DA: https://www.donationalerts.com/r/ile✨
* YooMoney: https://yoomoney.ru/to/4100118180919675
* Telegram Gift: https://t.me/ile✨official
* TON: UQBENFaqzv19GBR1EnDKad_nAOB--Ofsdk1FeRU7W3xprRLY
* BTC: bc1qn0f9yvcsacvedjk6qzu9cvagchkcz28gqrg2eh
* ETH: 0xbE7f260b952b87578079C0D6E03d3641425718c9
* Card: 2200700733487101

## 
Found a bug, have a question, or want to give advice — https://github.com/ilez✨-code/NamedChest/issues/new

## 
This project is distributed under the `GPL-3.0 License`. For more details, see the [LICENSE](LICENSE) file.