NNNN_SimpleShop 動態商店系統

插件基本資訊 / プラグイン基本情報 / Plugin Basic Information

插件名稱: NNNN_SimpleShop
版本: v2.1.0 (Beta)
作者: NNNN
類型: 原創插件 (非改寫)
更新狀態: Beta版本，持續開發中

---

1. 插件主要功能簡述

繁體中文

動態商店系統提供靈活的商店管理功能，包括：

• 基於遊戲進度的動態商店等級升級
• 按類別和等級自動篩選物品
• 具有多重優先級的庫存管理
• 自定義定價和折扣系統
• 商店模板快速設定
• 多條件進階篩選

日本語

ダイナミックショップシステムは柔軟なショップ管理機能を提供：

• ゲーム進行に基づく動的ショップレベルアップグレード
• カテゴリとレベルによる自動アイテムフィルタリング
• 複数優先度レベルを持つ在庫管理
• カスタム価格設定と割引システム
• ショップテンプレートのクイック設定
• 複数条件による高度なフィルタリング

English

Dynamic Shop System provides flexible shop management functionality:

• Dynamic shop level upgrades based on game progress
• Automatic item filtering by categories and levels
• Stock management with multiple priority levels
• Custom pricing and discount systems
• Shop templates for quick setup
• Advanced filtering with multiple conditions

---

2. 參數使用說明

主要參數 / メインパラメータ / Main Parameters

全域設定

• globalShopLevel: 全域商店等級 (1-10)
• defaultGlobalStock: 預設全域庫存數量
• stockRefreshVariableId: 庫存刷新變數ID
• stockRefreshCondition: 庫存刷新條件

顯示設定

• showStockInBuy: 在購買視窗顯示庫存
• stockDisplayColor: 庫存顯示顏色 (0-31)
• enableDebugMode: 啟用除錯模式

訊息設定

• messageSettings: 各種系統訊息的多語言設定
• itemSubCategoryNames: 物品副類別名稱映射
• rarityNames: 稀有度名稱映射

物品標籤設定

物品備註欄標籤：

<itemLevel:3>                    # 設定物品等級 (1-10)
<itemSubCategories:1,2,3>        # 設定副類別
<itemStock:50>                   # 設定庫存數量
<itemRarity:rare>                # 設定稀有度
<shopUnlockSwitch:5>             # 解鎖開關ID

---

3. 使用步驟

步驟1: 插件管理器設置

1. 啟用 NNNN_SimpleShop
2. 設定全域商店等級
3. 配置庫存刷新條件
4. 自定義物品類別名稱

步驟2: 資料庫設置物品

在物品備註欄設定商店相關標籤：

<itemLevel:2>
<itemSubCategories:1,4>
<itemRarity:common>
<itemStock:30>

步驟3: 商店模板設定

使用預定義模板或自定義商店配置：

• weaponShop (武器商店)
• armorShop (防具商店)
• itemShop (道具商店)
• accessoryShop (飾品商店)

步驟4: 開啟商店

使用插件命令開啟商店：

• openShop - 自定義參數開啟
• openShopTemplate - 使用模板開啟

---

4. 測試方式

測試設置範例

物品配置範例：

1. 初級治療藥

   • 標籤：<itemLevel:1><itemRarity:common><itemStock:50>

2. 高級治療藥

   • 標籤：<itemLevel:3><itemRarity:uncommon><itemStock:20>

3. 傳說武器

   • 標籤：<itemLevel:8><itemRarity:legendary><shopUnlockSwitch:10>

測試步驟：

1. 設定不同等級和稀有度的物品
2. 使用不同等級開啟商店
3. 測試庫存刷新機制
4. 驗證開關解鎖功能
5. 測試商店模板功能

期望結果：

• 商店只顯示符合等級要求的物品
• 庫存正確顯示和更新
• 稀有度篩選正常運作
• 商店模板快速設定生效

//TODO:圖檔說明 - 需要添加動態商店界面和篩選功能的螢幕截圖

---

5. 版權聲明

授權條款: MIT License
商業使用: ✅ 允許
二次開發: ✅ 允許
轉售權限: ❌ 禁止轉售原插件
署名要求: 建議保留原作者資訊

---

插件命令

openShop

• shopLevel: 商店等級 (0=使用全域等級)
• categoryFilter: 類別篩選設定
• includeLevels/excludeLevels: 包含/排除等級
• includeRarities/excludeRarities: 包含/排除稀有度

openShopTemplate

• templateName: 模板名稱 (weaponShop, armorShop等)

---

物品類別系統

主類型

• weapon: 武器
• armor: 防具
• item: 道具

副類型

• 武器/防具: 使用系統類型名稱
• 道具: 使用數字類別 (1-999)

稀有度等級

1. common (普通)
2. uncommon (不普通)
3. rare (稀有)
4. epic (史詩)
5. legendary (傳說)
6. mythic (神話)
7. ancient (遠古)
8. divine (神聖)
9. cosmic (宇宙)
10. transcendent (超越)

---

注意事項

• 動態等級系統影響商店平衡
• 庫存管理需要合理設定刷新條件
• 商店模板可根據需要自行擴展
• 建議充分測試篩選條件的組合效果