🎉 KoukeNeko Tag System - Version Update Notes

📋 Major Configuration File Update

This update focuses on a comprehensive overhaul of the config.yml configuration file, giving server administrators much more flexibility to customize the tag system!

🔧 New Configuration Options

🛡️ Permission Settings

permission:
  admin: "koukeneko.admin"        # Custom admin permission
  tag_prefix: "koukeneko.tags."   # Custom tag permission prefix

🎨 Menu Customization Settings

menu:
  title: "&8Tag Selection"        # Custom menu title
  rows: "auto"                   # Menu rows (auto calculate or 1-6)
  remove_item:
    material: "BARRIER"          # Remove button material
    position: "bottom_right"     # Button position
  tag_item:
    material: "NAME_TAG"         # Tag item material

⚙️ Command Configuration Details

commands:
  main:
    name: "koukeneko"
    aliases: ["kn"]              # Command aliases
    description: "KoukeNeko plugin main command"
    usage: "/koukeneko reload"
    permission: "koukeneko.admin"
  
  tag:
    name: "tag"
    aliases: ["tags"]            # Support for aliases
    description: "Tag system command"
    usage: "/tag [arguments]"

📁 File Management Settings

files:
  tags_file: "tags.yml"          # Tag file name
  language_file_prefix: "lang_"   # Language file prefix
  language_file_suffix: ".yml"    # Language file suffix

🐛 Debug Options

debug:
  enabled: false                 # Debug mode toggle
  log_commands: true             # Log executed commands
  log_permissions: false         # Log permission checks

🎯 What Administrators Can Customize

• 🎨 Menu Appearance: Title, size, item materials
• 📍 Button Positioning: Remove tag button location
• 🛡️ Permission System: Admin permissions and tag permission prefixes
• 💬 Command Settings: Command names, aliases, descriptions, and usage
• 📂 File Paths: Custom names and paths for configuration files
• 🔍 Debug Options: Control logging detail level

📖 Usage Instructions

1. First startup after update: The plugin will automatically update your config.yml, preserving existing settings while adding new options
2. Menu customization: Modify the menu section to adjust the tag selection menu appearance
3. Permission adjustment: Update permission names in the permission section to match your permission plugin
4. Debug mode: Enable debug.enabled when troubleshooting to get more detailed logs

⚠️ Important Notes

• Please check your config.yml after updating to ensure all settings meet your requirements
• If using custom permission prefixes, make sure existing player permissions are updated accordingly
• Debug mode generates more logs - only enable when needed

🚀 Next Version Preview

We're developing more customization features, including:

• Tag categorization system
• More menu layout options
• Tag usage statistics

---

Thank you for using the KoukeNeko Tag System!

🎉 KoukeNeko 標籤系統 - 版本更新說明

📋 配置文件大更新

這次更新主要針對 config.yml 配置文件進行了全面優化，讓伺服器管理員可以更靈活地自訂標籤系統！

🔧 新增配置選項

🛡️ 權限設定

permission:
  admin: "koukeneko.admin"        # 自訂管理員權限
  tag_prefix: "koukeneko.tags."   # 自訂標籤權限前綴

🎨 選單自訂設定

menu:
  title: "&8標籤選擇"              # 自訂選單標題
  rows: "auto"                   # 選單行數 (auto 自動計算 或 1-6)
  remove_item:
    material: "BARRIER"          # 移除按鈕材質
    position: "bottom_right"     # 按鈕位置
  tag_item:
    material: "NAME_TAG"         # 標籤物品材質

⚙️ 指令詳細設定

commands:
  main:
    name: "koukeneko"
    aliases: ["kn"]              # 指令別名
    description: "KoukeNeko 插件主指令"
    usage: "/koukeneko reload"
    permission: "koukeneko.admin"
  
  tag:
    name: "tag"
    aliases: ["標籤", "tags"]     # 支援中文別名
    description: "標籤系統指令"
    usage: "/tag [參數]"

📁 檔案管理設定

files:
  tags_file: "tags.yml"          # 標籤檔案名稱
  language_file_prefix: "lang_"   # 語言檔案前綴
  language_file_suffix: ".yml"    # 語言檔案後綴

🐛 除錯選項

debug:
  enabled: false                 # 除錯模式開關
  log_commands: true             # 記錄執行的指令
  log_permissions: false         # 記錄權限檢查

🎯 管理員可以自訂的內容

• 🎨 選單外觀: 標題、大小、物品材質
• 📍 按鈕位置: 移除標籤按鈕的位置
• 🛡️ 權限系統: 管理員權限和標籤權限前綴
• 💬 指令設定: 指令名稱、別名、描述和使用方式
• 📂 檔案路徑: 自訂各種設定檔的名稱和路徑
• 🔍 除錯選項: 控制日誌記錄的詳細程度

📖 使用說明

1. 更新後第一次啟動: 外掛會自動更新你的 config.yml，保留原有設定並新增新選項
2. 自訂選單: 修改 menu 區段來調整標籤選擇選單的外觀
3. 權限調整: 在 permission 區段修改權限名稱以配合你的權限外掛
4. 除錯模式: 遇到問題時可以開啟 debug.enabled 來獲得更詳細的日誌

⚠️ 重要提醒

• 更新後請檢查你的 config.yml 以確保所有設定符合需求
• 如果使用自訂權限前綴，請確保現有玩家的權限也相應更新
• 除錯模式會產生更多日誌，建議只在需要時開啟

🚀 下個版本預告

我們正在開發更多自訂功能，包括：

• 標籤分類系統
• 更多選單佈局選項
• 標籤使用統計

---

感謝使用 KoukeNeko 標籤系統！