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

[🐲] 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
  • 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

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

• Contact: TG, Email
• Telegram channel: click
• Modrinth: click
• SpigotRU: click
• Hangar: soon

[❤️] 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.