✨ CadieoGoldBlock Plugin

Version 1.0 · Compatible with Minecraft 1.16–1.20 · Java 8+

An engaging server event where a golden block evolves through stages, rewarding nearby players and ending with a loot chest.

🌟 Features

🪙 3 stages: Gold, Diamond, Netherite blocks with custom bonuses, delays, and radii.

🗺️ Random/fixed spawn: Choose between random coordinates inside a border or a fixed location.

🛡️ WorldGuard region: Auto‑created with configurable flags to protect the event area.

🎁 Loot chest: At the end, the block becomes a chest filled with random items from a custom pool.

📦 Loot editor GUI: /gb gui to manage items; saved in database.yml.

🌟 Holograms: DecentHolograms / HolographicDisplays support with placeholders.

📋 PlaceholderAPI: Many placeholders for timers, bonuses, coordinates.

⚡ Economy: Vault or PlayerPoints integration for stage bonuses.

📦 Installation

Install required dependencies: WorldGuard, PlaceholderAPI (optional: Vault/PlayerPoints, DecentHolograms/HolographicDisplays).
Place GoldBlock.jar in your server’s plugins folder.
Restart the server – default config.yml and database.yml will be generated.
Edit config.yml to your liking.
Use /gb gui (requires cadieoGB.admin) to add loot items. Drag items and click the emerald to save.
Reload configuration with /gb reload (requires cadieoGB.stop).

🔧 Dependencies

required WorldGuard, PlaceholderAPI
optional Vault or PlayerPoints, DecentHolograms or HolographicDisplays

⚙️ Configuration (`config.yml`)

The file is extensively commented. Main sections:

spawn_delay – seconds between event spawns.
event_duration – total event length (should match stage times).
sapwn_border – min/max coordinates for random spawn.
stage1, stage2, stage3 – each has time, bonus, bonus_delay, bonus_radius, eco_plugin, block_type.
spawn_location – random: true/false and fixed coordinates.
chest-end – enable chest, time_to_destroy, fill_slots_in_chest (max 27), chest_name.
holo_settings – enable holograms, line heights and text (placeholders work).
spawn_mes – broadcast messages on spawn (supports %x%, %y%, %z%).
Various message strings.
region_size, region_name, region_flags – WorldGuard region.

🎮 Commands & Permissions

Command	Description	Permission
`/gb start`	Manually start event	`cadieoGB.start`
`/gb stop`	Stop current event	`cadieoGB.stop`
`/gb reload`	Reload config	`cadieoGB.stop`
`/gb gui`	Open loot editor	`cadieoGB.admin`
Bypass region protection		`cadieoGB.bypass`

All default to op.

📊 Placeholders (PlaceholderAPI)

%bonus_stage1%, %bonus_stage2%, %bonus_stage3%
%bonus_radius_stage1%, …
%event_delay%
%cadieogbx%, %cadieogby%, %gcadieobz%
%cadieogb_time_to_chest% – seconds until chest appears
%cadieogb_time_to_chest_end% – seconds until chest disappears

🗄️ Database (`database.yml`)

Stores loot items automatically. Example:

chest-loot:
  '0':
    ==: org.bukkit.inventory.ItemStack
    type: DIAMOND
    amount: 1
  '1':
    ==: org.bukkit.inventory.ItemStack
    type: GOLD_INGOT
    amount: 5

🔄 Event Flow

After spawn_delay, a suitable location is chosen.
Stage 1 block appears; WorldGuard region and hologram created.
Every second stage updates based on elapsed time.
At each bonus_delay, all players within bonus_radius receive the bonus.
After event_duration, block turns into a chest (if enabled).
Chest is filled with up to fill_slots_in_chest random items from the loot pool, placed randomly.
After time_to_destroy seconds, chest and region are removed.
Cycle repeats.

❓ FAQ

Event doesn't spawn? Check console for errors; verify spawn border is valid and location is clear. The plugin tries up to 100 times.

Players can break the gold block? Ensure they don't have cadieoGB.bypass and region has build:deny.

No holograms? Install a hologram plugin, enable in config, and check it works.

Vault not working? Ensure an economy plugin (e.g., EssentialsX) is installed and Vault is present.

Chest empty? Add items via /gb gui and save; check fill_slots_in_chest > 0.

🔄 Compatibility

Minecraft 1.16.x – 1.20.x. Compiled with Java 8, runs on any server Java (8–21+). Tested with WorldGuard 7.0.7, PlaceholderAPI 2.11.6, Vault 1.7, DecentHolograms 2.8.11, HolographicDisplays 3.0.0.

🐛 Reporting Issues

Contact the author via BlackMinecraft. Provide server version, plugin versions, and steps to reproduce.

✨ CadieoGoldBlock Плагин

Версия 1.0 · Совместим с Minecraft 1.16–1.20 · Java 8+

Увлекательный ивент, в котором золотой блок эволюционирует через три стадии, награждая игроков бонусами и завершаясь сундуком с лутом.

🌟 Особенности

🪙 3 стадии: блоки золота, алмаза и незерита с разными бонусами, задержками и радиусами.

🗺️ Случайный/фиксированный спавн: на выбор – координаты в границах или точное место.

🛡️ Регион WorldGuard: создаётся автоматически с настраиваемыми флагами для защиты зоны ивента.

🎁 Сундук с лутом: в конце блок превращается в сундук со случайными предметами из вашего списка.

📦 Редактор лута в GUI: /gb gui для управления предметами, сохраняются в database.yml.

🌟 Голограммы: поддержка DecentHolograms / HolographicDisplays с плейсхолдерами.

📋 PlaceholderAPI: множество плейсхолдеров для таймеров, бонусов, координат.

⚡ Экономика: интеграция с Vault или PlayerPoints для выдачи бонусов на стадиях.

📦 Установка

Установите обязательные зависимости: WorldGuard, PlaceholderAPI (опционально Vault/PlayerPoints, DecentHolograms/HolographicDisplays).
Поместите GoldBlock.jar в папку plugins вашего сервера.
Перезапустите сервер – будут созданы config.yml и database.yml по умолчанию.
Отредактируйте config.yml под свои нужды.
Используйте /gb gui (требуется cadieoGB.admin) для добавления предметов в лут. Перетащите предметы и нажмите на изумрудный блок для сохранения.
Перезагрузите конфигурацию командой /gb reload (требуется cadieoGB.stop).

🔧 Зависимости

required WorldGuard, PlaceholderAPI
optional Vault или PlayerPoints, DecentHolograms или HolographicDisplays

⚙️ Конфигурация (`config.yml`)

Файл подробно прокомментирован. Основные секции:

spawn_delay – интервал между ивентами (секунды).
event_duration – общая длительность ивента.
sapwn_border – минимальные и максимальные координаты для случайного спавна.
stage1, stage2, stage3 – каждая содержит time, bonus, bonus_delay, bonus_radius, eco_plugin, block_type.
spawn_location – random: true/false и фиксированные координаты.
chest-end – включить сундук, time_to_destroy, fill_slots_in_chest (макс 27), chest_name.
holo_settings – включить голограммы, высота и текст строк (работают плейсхолдеры).
spawn_mes – сообщения в чат при спавне (поддерживаются %x%, %y%, %z%).
Различные настраиваемые сообщения.
region_size, region_name, region_flags – регион WorldGuard.

🎮 Команды и права

Команда	Описание	Право
`/gb start`	Запустить ивент вручную	`cadieoGB.start`
`/gb stop`	Остановить текущий ивент	`cadieoGB.stop`
`/gb reload`	Перезагрузить конфиг	`cadieoGB.stop`
`/gb gui`	Открыть редактор лута	`cadieoGB.admin`
Обход защиты региона		`cadieoGB.bypass`

Все права по умолчанию у операторов.

📊 Плейсхолдеры (PlaceholderAPI)

%bonus_stage1%, %bonus_stage2%, %bonus_stage3%
%bonus_radius_stage1%, …
%event_delay%
%cadieogbx%, %cadieogby%, %gcadieobz%
%cadieogb_time_to_chest% – секунд до появления сундука
%cadieogb_time_to_chest_end% – секунд до исчезновения сундука

🗄️ База данных (`database.yml`)

Автоматически хранит предметы лута. Пример:

chest-loot:
  '0':
    ==: org.bukkit.inventory.ItemStack
    type: DIAMOND
    amount: 1
  '1':
    ==: org.bukkit.inventory.ItemStack
    type: GOLD_INGOT
    amount: 5

🔄 Процесс ивента

По истечении spawn_delay выбирается подходящее место.
Появляется блок 1-й стадии, создаётся регион WorldGuard и голограмма.
Каждую секунду проверяется смена стадии.
С периодичностью bonus_delay все игроки в радиусе bonus_radius получают бонус.
После event_duration блок превращается в сундук (если включено).
Сундук заполняется случайными предметами (до fill_slots_in_chest) из пула, в случайные слоты.
Через time_to_destroy секунд сундук и регион удаляются.
Цикл повторяется.

❓ Часто задаваемые вопросы

Ивент не появляется? Проверьте консоль на ошибки; убедитесь, что границы спавна корректны и место не занято. Плагин делает до 100 попыток.

Игроки ломают золотой блок? Убедитесь, что у них нет права cadieoGB.bypass и в регионе стоит флаг build:deny.

Нет голограмм? Установите плагин голограмм, включите в конфиге и проверьте его работу.

Vault не работает? Установите плагин экономики (например, EssentialsX) и Vault.

Сундук пустой? Добавьте предметы через /gb gui и сохраните; проверьте, что fill_slots_in_chest больше 0.

🔄 Совместимость

Minecraft 1.16.x – 1.20.x. Скомпилировано с Java 8, работает на любой Java сервера (8–21+). Протестировано с WorldGuard 7.0.7, PlaceholderAPI 2.11.6, Vault 1.7, DecentHolograms 2.8.11, HolographicDisplays 3.0.0.

🐛 Сообщить о проблеме

Свяжитесь с автором на странице BlackMinecraft. Укажите версию сервера, версии плагинов и шаги для воспроизведения.