KoukeNeko Nametag Plugin

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 標籤系統！