Next-Gen-CustomEnderChest

Player Commands:

• /cec - Opens your Ender Chest.
• Aliases: /ec, /customenderchest

Size Permissions:

• CustomEnderChest.level.0 - 9 Slots (1 row)
• CustomEnderChest.level.1 - 18 Slots (2 rows)
• CustomEnderChest.level.2 - 27 Slots (3 rows)
• CustomEnderChest.level.3 - 36 Slots (4 rows)
• CustomEnderChest.level.4 - 45 Slots (5 rows)
• CustomEnderChest.level.5 - 54 Slots (6 rows)

Admin Commands:

Permission Required: CustomEnderChest.admin

• /cec reload - Reloads the config.yml and language files.
• /cec open <player> - Open and modify another player's EnderChest.
• /cec delete <player> - Delete all items in a specific player's EnderChest.
• /cec migrate <type> <type> - Migrate your current database to a new format (h2, mysql, yml).
• /cec convertall - Imports data from the older legacy plugin version's format.

# -------------------------------------------------- #
#      Configuration for CustomEnderChest v2.0       #
# -------------------------------------------------- #
# Thank you for using the refactored version!
# All messages, titles, and user-facing text are now managed in the /lang directory.

# General plugin settings
general:
  # Select the language file to use.
  # Example: "en" will load "lang_en.yml", "vi" will load "lang_vi.yml", "zhcn" will load lang_zhcn.yml.
  # Make sure the corresponding file exists in the plugin's /lang folder.
  locale: "en"
  # Set to true to enable debug logging. Useful for troubleshooting.
  debug: false
  # Set to true to enable bStats metrics, which helps the developer understand how the plugin is used.
  # Set to false to disable it.
  bstats-metrics: true
  # Set to true to enable FastStats metrics for error tracking and analytics.
  # Set to false to disable it.
  faststats-metrics: true
  # Enable or disable automatic update checking.
  update-checker: true

# Backup settings
backup:
  # Enable automatic backups of player data
  enabled: true
  # Interval between automatic backups (in minutes)
  interval-minutes: 60
  # Maximum number of backup files to keep
  # Old backups will be automatically deleted when this limit is exceeded
  max-backups: 10
  # Number of days to keep backups (older backups will be deleted)
  retention-days: 7
  # Create a backup when the server shuts down
  backup-on-shutdown: true

# Database settings
storage:
  # Storage type. Options:
  # yml     - Stores data in YAML files, no external setup needed.
  # h2      - (Default & Recommended for single servers) Fast, lightweight, stores data in a single file, no external setup needed.
  # mysql   - (Recommended for multi-server networks) Requires a separate MySQL server.
  type: "h2"

  # The table name that will be used in the database.
  table_name: "custom_enderchests"

  # Periodically auto-save data for online players.
  # This helps minimize data loss in case of a server crash.
  # Time is in seconds.
  auto-save-interval-seconds: 300 # Default is 5 minutes

  # Settings for MySQL (only apply if `type` is "mysql")
  mysql:
    host: "127.0.0.1"
    port: 3306
    database: "enderchest_db"
    username: "user"
    password: "password"
    # Enable/disable SSL encryption for the connection.
    use-ssl: false

  # Settings for the Connection Pool (HikariCP).
  # These settings optimize database connection performance.
  # You generally don't need to change these unless you know what you're doing.
  pool-settings:
    max-pool-size: 10
    min-idle: 5
    connection-timeout: 30000 # 30 seconds

  # Automatically clean up old user data in MySQL
  auto-cleanup:
    # Enable/disable the automatic deletion of inactive player data.
    enabled: false
    # Number of inactive days. Data for players who have been offline for this duration will be deleted.
    inactive-days: 90

# Ender Chest gameplay options
enderchest-options:
  # Disable opening the custom ender chest by right-clicking an Ender Chest block.
  # Useful if you only want players to open the chest via command or players will need
  # "CustomEnderChest.block.open" permission to open via block.
  # Note: If this option is true, don't set true for `disable-plugin-on-endechest-block` below.
  disable-enderchest-click: false
  # Disable the plugin's functionality when interacting with an Ender Chest block.
  # The block will function as a normal vanilla Ender Chest.
  # Useful if you want to reserve the block for vanilla use only.
  # Note: If this option is true, don't set true for `disable-enderchest-click` above.
  vanilla-enderchest-block: false

# Default settings for players
default-player:
  # Enable this to give players a default chest size.
  # This allows players to use the Ender Chest block without needing a specific permission.
  enabled: true
  # The default chest size (number of slots, must be a multiple of 9, max 54).
  # 27 equals 3 rows, the same as a vanilla Ender Chest.
  # Default permission level is CustomEnderChest.level.3 (27 slots).
  size: 27
  # Allow players to use /cec, /ec, /customec commands by default.
  # If false, players will need "CustomEnderChest.commands" permission to use commands.
  allow-command: true

# Import settings for vanilla ender chest data
import:
  # Automatically import vanilla ender chest items when a player joins
  # This will transfer items from their vanilla ender chest to the plugin's storage
  # Items are merged with existing data (vanilla items go to empty slots)
  auto-import-on-join: false

# Sound customization
sounds:
  # Disable all plugin sounds if set to `true`.
  disable-all: false
  # You can find valid sound names here:
  # https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
  # (Use the names from the Enum column)
  open:
    name: "BLOCK_ENDER_CHEST_OPEN"
    volume: 1.0
    pitch: 1.0
  close:
    name: "BLOCK_ENDER_CHEST_CLOSE"
    volume: 1.0
    pitch: 1.0
  fail:
    name: "BLOCK_NOTE_BLOCK_PLING"
    volume: 1.0
    pitch: 0.5
  reload:
    name: "ENTITY_PLAYER_LEVELUP"
    volume: 0.8
    pitch: 1.5
    

# Prefix used for all messages
prefix: "<gray>[<gradient:#C0FFEE:#B4D0FF>EnderChest</gradient>]</gray> "

messages:
  no-permission: "<red>You don't have permission for that.</red>"
  no-permission-block-open: "<red>You don't have permission to open the Ender Chest by clicking on it.</red>"
  players-only: "<red>This command can only be run by a player.</red>"
  reload-success: "<green>Configuration and language files have been reloaded.</green>"
  data-still-loading: "<yellow>Your data is still loading, please wait a moment...</yellow>"
  data-busy: "<red>Player data is busy. Please try again shortly.</red>"
  save-error: "<red>An error occurred while saving data. Please check the console.</red>"
  invalid-player: "<red>Invalid player name.</red>"

  # Migration messages
  migration-data-incompatible: "<yellow>Warning: Your Ender Chest data is incompatible with the new server version (1.21.5+)."
  migration-data-cleared: "<yellow>Your Ender Chest has been reset due to incompatibility. Old data is still preserved in the database."
  migration-contact-admin: "<gray>Please contact an admin if you need item recovery."
  data-migrated: "<green>Your enderchest data has been migrated to your new account."

  # Overflow messages
  overflow-items-saved: "<yellow>⚠ Some items beyond your permission have been saved to overflow storage."
  overflow-will-restore: "<gray>They will be automatically restored when you upgrade your Ender Chest."
  overflow-items-restored: "<green>✓ Restored <count> items from overflow storage!"

command:
  usage: "<red>Usage: <gray>/<label> <usage>"
  player-not-found: "<red>Player '<player>' not found or has no data."
  delete-usage: "<red>Usage: <gray>/<label> delete <player>"
  delete-success: "<green>Successfully deleted Ender Chest data for <white><player></white>."
  loading-chest: "<yellow>Loading <white><player>'s</white> Ender Chest..."
  import-usage: "<red>Usage: <gray>/<label> import <vanilla>"
  import-invalid-type: "<red>Invalid import type. Use: <gray>vanilla"
  migrate-usage: "<yellow>Usage: <gray>/cec migrate <yml|h2|mysql> <yml|h2|mysql>"
  migrate-example: "<gray>Example: /cec migrate yml mysql"
  migrate-running: "<red>Another migration process is currently running. Please wait!"
  migrate-same-type: "<red>Source and target formats cannot be the same."
  migrate-init: "<yellow>Initializing database connection..."
  migrate-conn-source-err: "<red>Error connecting to source format. Migration cancelled."
  migrate-conn-target-err: "<red>Error connecting to target format. Migration cancelled."
  migrate-start: "<yellow>Starting data migration from <source> to <target>..."
  migrate-no-data: "<red>No data found to migrate."
  migrate-success: "<green>Data migration complete! Success: <success>/<total>, Failed: <failed>"
  migrate-note: "<yellow>⚠ Note: <white>To use the migrated data, stop the server, update the storage type in config.yml, then start the server again."
  migrate-error-unknown: "<red>An unknown error occurred during migration. Check Console for details."
  migrate-in-progress: "<red>System is undergoing data maintenance (migration), you cannot open the chest right now!"

titles:
  enderchest: "<level> - <light_purple><player>'s Chest"
  admin_view: "<dark_red>Admin View: <white><player>"

levels:
  '0': "&fLevel 1" # 1 row (9 slots)
  '1': "&aLevel 2" # 2 rows (18 slots)
  '2': "&bLevel 3" # 3 rows (27 slots)
  '3': "&eLevel 4" # 4 rows (36 slots)
  '4': "&6Level 5" # 5 rows (45 slots)
  '5': "&d&lLevel 6" # 6 rows (54 slots)

import:
  started: "<green>Starting vanilla ender chest import for all online players..."
  complete: "<green>Import complete! <white><imported></white> players imported, <white><skipped></white> skipped."
  auto-import-started: "<yellow>Auto-importing your vanilla ender chest items..."
  auto-import-complete: "<green>Auto-import complete! <white><count></white> items imported from vanilla ender chest."
  auto-import-failed: "<red>Failed to auto-import your vanilla ender chest data. Please contact an admin."

# File Ngôn ngữ Tiếng Việt cho CustomEnderChest

# Prefix dùng cho tất cả messages
prefix: "<gray>[<gradient:#C0FFEE:#B4D0FF>Rương Ender</gradient>]</gray> "

messages:
  no-permission: "<red>Bạn không có quyền để làm điều này.</red>"
  no-permission-block-open: "<red>Bạn không có quyền để mở rương Ender.</red>"
  players-only: "<red>Lệnh này chỉ có thể được thực thi bởi người chơi.</red>"
  reload-success: "<green>Đã tải lại tệp cấu hình và ngôn ngữ.</green>"
  data-still-loading: "<yellow>Dữ liệu của bạn đang được tải, vui lòng chờ trong giây lát...</yellow>"
  data-busy: "<red>Dữ liệu người chơi hiện đang bận. Vui lòng thử lại sau giây lát.</red>"
  save-error: "<red>Đã xảy ra lỗi khi lưu dữ liệu. Vui lòng kiểm tra console.</red>"
  invalid-player: "<red>Tên người chơi không hợp lệ.</red>"

  # Migration messages
  migration-data-incompatible: "<yellow>Cảnh báo: Dữ liệu Rương Ender của bạn không tương thích với phiên bản server mới (1.21.5+)."
  migration-data-cleared: "<yellow>Rương Ender của bạn đã bị reset do không tương thích. Dữ liệu cũ vẫn được lưu trong database."
  migration-contact-admin: "<gray>Vui lòng liên hệ admin nếu cần khôi phục vật phẩm."
  data-migrated: "<green>Dữ liệu rương ender của bạn đã được chuyển sang tài khoản mới."

  # Overflow messages
  overflow-items-saved: "<yellow>⚠ Một số vật phẩm vượt quyền hạn đã được lưu vào kho dự phòng."
  overflow-will-restore: "<gray>Chúng sẽ tự động được khôi phục khi bạn nâng cấp Rương Ender."
  overflow-items-restored: "<green>✓ Đã khôi phục <count> vật phẩm từ kho dự phòng!"

command:
  usage: "<red>Sử dụng: <gray>/<label> <usage>"
  player-not-found: "<red>Không tìm thấy người chơi '<player>' hoặc họ chưa có dữ liệu."
  delete-usage: "<red>Sử dụng: <gray>/<label> delete <tên_người_chơi>"
  delete-success: "<green>Đã xóa thành công dữ liệu Rương Ender của <white><player></white>."
  loading-chest: "<yellow>Đang tải Rương Ender của <white><player></white>..."
  import-usage: "<red>Sử dụng: <gray>/<label> import <vanilla>"
  import-invalid-type: "<red>Loại import không hợp lệ. Sử dụng: <gray>vanilla"
  migrate-usage: "<yellow>Sử dụng: <gray>/cec migrate <yml|h2|mysql> <yml|h2|mysql>"
  migrate-example: "<gray>Ví dụ: /cec migrate yml mysql"
  migrate-running: "<red>Một tiến trình migrate khác đang diễn ra. Vui lòng đợi!"
  migrate-same-type: "<red>Định dạng nguồn và đích không được giống nhau."
  migrate-init: "<yellow>Đang khởi tạo kết nối database..."
  migrate-conn-source-err: "<red>Lỗi kết nối định dạng nguồn. Migrate bị huỷ."
  migrate-conn-target-err: "<red>Lỗi kết nối định dạng đích. Migrate bị huỷ."
  migrate-start: "<yellow>Bắt đầu chuyển dữ liệu từ <source> sang <target>..."
  migrate-no-data: "<red>Không tìm thấy dữ liệu nào để chuyển đổi."
  migrate-success: "<green>Chuyển dữ liệu hoàn tất! Thành công: <success>/<total>, Lỗi: <failed>"
  migrate-note: "<yellow>⚠ Lưu ý: <white>Sau khi chuyển đổi dữ liệu và muốn sử dụng dữ liệu đó thì hãy tắt máy chủ và chỉnh thông tin trong file config.yml rồi mở máy chủ để sử dụng."
  migrate-error-unknown: "<red>Đã xảy ra lỗi không xác định lúc chuyển dữ liệu. Xem Console để biết chi tiết."
  migrate-in-progress: "<red>Hệ thống đang bảo trì dữ liệu (migrate), không thể mở rương ngay lúc này!"

titles:
  enderchest: "<level> - <light_purple>Rương của <player>"
  admin_view: "<dark_red>Admin Xem: <white><player>"

# Tên cấp độ được dùng trong biến <level>
levels:
  '0': "&fCấp 1" # 1 hàng (9 ô)
  '1': "&aCấp 2" # 2 hàng (18 ô)
  '2': "&bCấp 3" # 3 hàng (27 ô)
  '3': "&eCấp 4" # 4 hàng (36 ô)
  '4': "&6Cấp 5" # 5 hàng (45 ô)
  '5': "&d&lCấp 6" # 6 hàng (54 ô)

import:
  started: "<green>Bắt đầu chuyển dữ liệu vanilla sang plugin cho tất cả người chơi trực tuyến..."
  complete: "<green>Chuyển hoàn tất! Đã chuyển cho <white><imported></white> người chơi, bỏ qua <white><skipped></white>."
  auto-import-started: "<yellow>Đang tự động chuyển vật phẩm từ rương ender vanilla của bạn..."
  auto-import-complete: "<green>Tự động chuyển hoàn tất! Đã chuyển <white><count></white> vật phẩm từ rương ender vanilla."
  auto-import-failed: "<red>Không thể tự động chuyển dữ liệu rương ender vanilla. Vui lòng liên hệ admin."
  

# Prefix dat voor alle berichten wordt gebruikt
prefix: "<gray>[<gradient:#C0FFEE:#B4D0FF>EnderChest</gradient>]</gray> "

messages:
  no-permission: "<red>Je hebt daar geen toestemming voor.</red>"
  no-permission-block-open: "<red>You don't have permission to open the Ender Chest by clicking on it.</red>"
  players-only: "<red>Dit commando kan alleen door een speler worden uitgevoerd.</red>"
  reload-success: "<green>Configuratie- en taal bestanden zijn opnieuw geladen.</green>"
  data-still-loading: "<yellow>Je gegevens worden nog geladen, even geduld a.u.b...</yellow>"
  data-busy: "<red>Spelerdata is bezig. Probeer het binnenkort opnieuw.</red>"
  save-error: "<red>Er is een fout opgetreden tijdens het opslaan van gegevens. Controleer de console.</red>"
  invalid-player: "<red>Ongeldige spelersnaam.</red>"

  # Migratie berichten
  migration-data-incompatible: "<yellow>Waarschuwing: je Ender Chest data is niet compatibel met de nieuwe serverversie (1.21.5+)."
  migration-data-cleared: "<yellow>Je Ender Chest is gereset vanwege incompatibiliteit. Oude gegevens zijn nog steeds bewaard in de database."
  migration-contact-admin: "<gray>Neem contact op met een admin als je de items wilt herstellen."
  data-migrated: "<green>Your enderchest data has been migrated to your new account."

  # Overflow berichten
  overflow-items-saved: "<yellow>⚠ Sommige items die buiten uw toestemming vallen, zijn opgeslagen in de overflow-opslag."
  overflow-will-restore: "<gray>Ze worden automatisch hersteld wanneer je je Ender Chest upgradet."
  overflow-items-restored: "<green>✓ <count> Items uit de overflow-opslag hersteld!"

command:
  usage: "<red>Gebruik: <gray>/<label> <usage>"
  player-not-found: "<red>Speler '<player>' niet gevonden of heeft geen gegevens."
  delete-usage: "<red>Gebruik: <gray>/<label> delete <player>"
  delete-success: "<green>Succesvol de Ender Chest van <white><player></white> verwijderd."
  loading-chest: "<yellow>Ender Chest van <white><player></white> wordt geladen..."
  import-usage: "<red>Usage: <gray>/<label> import <vanilla>"
  import-invalid-type: "<red>Invalid import type. Use: <gray>vanilla"
  migrate-usage: "<yellow>Usage: <gray>/cec migrate <yml|h2|mysql> <yml|h2|mysql>"
  migrate-example: "<gray>Example: /cec migrate yml mysql"
  migrate-running: "<red>Another migration process is currently running. Please wait!"
  migrate-same-type: "<red>Source and target formats cannot be the same."
  migrate-init: "<yellow>Initializing database connection..."
  migrate-conn-source-err: "<red>Error connecting to source format. Migration cancelled."
  migrate-conn-target-err: "<red>Error connecting to target format. Migration cancelled."
  migrate-start: "<yellow>Starting data migration from <source> to <target>..."
  migrate-no-data: "<red>No data found to migrate."
  migrate-success: "<green>Data migration complete! Success: <success>/<total>, Failed: <failed>"
  migrate-note: "<yellow>⚠ Note: <white>To use the migrated data, stop the server, update the storage type in config.yml, then start the server again."
  migrate-error-unknown: "<red>An unknown error occurred during migration. Check Console for details."
  migrate-in-progress: "<red>System is undergoing data maintenance (migration), you cannot open the chest right now!"

titles:
  enderchest: "<level> - <light_purple><player>'s Kist"
  admin_view: "<dark_red>Admin Overzicht: <white><player>"

levels:
  '0': "&fLevel 1" # 1 rij (9 slots)
  '1': "&aLevel 2" # 2 rij (18 slots)
  '2': "&bLevel 3" # 3 rij (27 slots)
  '3': "&eLevel 4" # 4 rij (36 slots)
  '4': "&6Level 5" # 5 rij (45 slots)
  '5': "&d&lLevel 6" # 6 rij (54 slots)

import:
  started: "<green>Starting vanilla ender chest import for all online players..."
  complete: "<green>Import complete! <white><imported></white> players imported, <white><skipped></white> skipped."
  auto-import-started: "<yellow>Auto-importing your vanilla ender chest items..."
  auto-import-complete: "<green>Auto-import complete! <white><count></white> items imported from vanilla ender chest."
  auto-import-failed: "<red>Failed to auto-import your vanilla ender chest data. Please contact an admin."

# 所有消息的前缀
prefix: "<gray>[<gradient:#C0FFEE:#B4D0FF>EnderChest</gradient>]</gray> "
messages:
  no-permission: "<red>你没有权限使用这个。</red>"
  no-permission-block-open: "<red>You don't have permission to open the Ender Chest by clicking on it.</red>"
  players-only: "<red>该命令只能由玩家执行。</red>"
  reload-success: "<green>配置与语言文件重载完毕。</green>"
  data-still-loading: "<yellow>数据仍在载入，请稍候...</yellow>"
  data-busy: "<red>玩家数据库繁忙，请稍后再试。</red>"
  save-error: "<red>保存数据时出错，请检查控制台。</red>"
  invalid-player: "<red>玩家名称无效。</red>"
  # 迁移相关消息
  migration-data-incompatible: "<yellow>警告：末影箱数据与新服务器版本（1.21.5+）不兼容。"
  migration-data-cleared: "<yellow>出于兼容性考虑，你的末影箱数据已被重置。旧数据仍然保留在数据库中。"
  migration-contact-admin: "<gray>若需要恢复丢失的物品，请联系管理员。"
  data-migrated: "<green>Your enderchest data has been migrated to your new account."
  # 溢出相关消息
  overflow-items-saved: "<yellow>⚠ 部分当前权限不能存取的物品已转移到溢出仓库。"
  overflow-will-restore: "<gray>升级末影箱后会自动回到普通仓库中。"
  overflow-items-restored: "<green>✓ 成功从溢出仓库中取回了 <count> 个物品！"
command:
  usage: "<red>命令用法：<gray>/<label> <usage>"
  player-not-found: "<red>玩家 '<player>' 未找到或没有数据。"
  delete-usage: "<red>命令用法：<gray>/<label> delete <player>"
  delete-success: "<green>成功删除了玩家 <white><player></white> 的末影箱数据。"
  loading-chest: "<yellow>正在载入 <white><player> 的</white> 末影箱..."
  import-usage: "<red>Usage: <gray>/<label> import <vanilla>"
  import-invalid-type: "<red>Invalid import type. Use: <gray>vanilla"
  migrate-usage: "<yellow>Usage: <gray>/cec migrate <yml|h2|mysql> <yml|h2|mysql>"
  migrate-example: "<gray>Example: /cec migrate yml mysql"
  migrate-running: "<red>Another migration process is currently running. Please wait!"
  migrate-same-type: "<red>Source and target formats cannot be the same."
  migrate-init: "<yellow>Initializing database connection..."
  migrate-conn-source-err: "<red>Error connecting to source format. Migration cancelled."
  migrate-conn-target-err: "<red>Error connecting to target format. Migration cancelled."
  migrate-start: "<yellow>Starting data migration from <source> to <target>..."
  migrate-no-data: "<red>No data found to migrate."
  migrate-success: "<green>Data migration complete! Success: <success>/<total>, Failed: <failed>"
  migrate-note: "<yellow>⚠ 注意：<white>迁移完成后，请关闭服务器，在 config.yml 中修改存储类型，然后重新启动服务器以使用迁移后的数据。"
  migrate-error-unknown: "<red>An unknown error occurred during migration. Check Console for details."
  migrate-in-progress: "<red>System is undergoing data maintenance (migration), you cannot open the chest right now!"
titles:
  enderchest: "<level> - <light_purple><player> 的箱子"
  admin_view: "<dark_red>管理员浏览：<white><player>"
levels:
  '0': "&f一阶" # 1 行（9 格）
  '1': "&a二阶" # 2 行（18 格）
  '2': "&b三阶" # 3 行（27 格）
  '3': "&e四阶" # 4 行（36 格）
  '4': "&6五阶" # 5 行（45 格）
  '5': "&d&l六阶" # 6 行（54 格）

import:
  started: "<green>Starting vanilla ender chest import for all online players..."
  complete: "<green>Import complete! <white><imported></white> players imported, <white><skipped></white> skipped."
  auto-import-started: "<yellow>Auto-importing your vanilla ender chest items..."
  auto-import-complete: "<green>Auto-import complete! <white><count></white> items imported from vanilla ender chest."
  auto-import-failed: "<red>Failed to auto-import your vanilla ender chest data. Please contact an admin."