==================================================
箱子商店安装
==================================================
箱子商店插件允许玩家在箱子上点击创建商店，支持卖出和收购两种类型，广泛用于生存区、地皮区等玩家自由交易场景。

插件简介
==================================================
- 支持一键创建买/卖商店，操作简单
- 完美兼容 NBT 数据、附魔、药水、蛋等特殊物品
- 国际化支持，自动切换客户端语言
- 无限商店、黑名单、权限分级等高级功能
- 支持双箱、UUID、聊天/GUI物品预览
- 强力兼容世界/区域保护插件
- 支持多种经济插件（Vault、GemsEconomy、TheNewEconomy等）
- 税收、持续费用、权限管理、缓存优化
- 支持 H2（本地）或 MySQL（远程）数据库
- 高级事件总线与开发者API
- 性能极佳，支持千级商店无延迟（需 ProtocolLib）

关键链接
==================================================
- SpigotMC: https://www.spigotmc.org/resources/quickshop-hikari-a-powerful-user-friendly-and-reliable-chestshop-plugin-1-20-1-21.100125/
- GitHub: https://github.com/QuickShop-Community/QuickShop-Hikari
- 文档: https://quickshop-community.github.io/QuickShop-Hikari-Documents/docs/intro

效果图
==================================================
.. image:: https://proxy.spigotmc.org/a9a1b1c3654664df0a65bc64c2b883a551a7bc57/68747470733a2f2f757365722d696d616765732e67697468756275736572636f6e74656e742e636f6d2f33303830323536352f3135343733323532372d38353963346265642d313534382d343162632d626462662d3363313935346633363864632e6a7067

安装步骤
==================================================
1. 从 SpigotMC 下载 QuickShop-Hikari.jar
2. 放到目标分区的 plugins 目录（如地皮区 dp1、生存区 sc1）
3. 重启服务端

创建数据库
==================================================
.. code-block:: sql

    CREATE DATABASE d_quickshop CHARACTER SET utf8 COLLATE utf8_general_ci;

配置修改
==================================================
主要修改 config.yml 数据库和语言部分，其他参数可按需调整。

.. code-block:: diff

    9c9
    < game-language: zh_cn
    ---
    > game-language: default
    59c59
    < bungee-cross-server-msg: true
    ---
    > bungee-cross-server-msg: false
    116c116
    <   mysql: true
    ---
    >   mysql: false
    118c118
    <   host: 127.0.0.1
    ---
    >   host: localhost
    122c122
    <   database: d_quickshop
    ---
    >   database: quickshop
    124c124
    <   user: mc
    ---
    >   user: root
    126c126
    <   password: mc_panda_142857
    ---
    >   password: passwd

权限配置
==================================================
参考官方 plugin.yml，推荐如下分组授权：

.. code-block:: bash

  # 创建箱子商店普通权限组
  /lp creategroup g-quickshop 0 g-quickshop

  # 将 default 组继承箱子商店普通权限组
  /lp group default parent add g-quickshop

  # 给 g-quickshop 组分配玩家基础权限
  /lp group g-quickshop permission set quickshop.player true


测试方法
==================================================
进入游戏，放置一个箱子，拿钻石左键点击箱子，若弹出创建商店提示则插件安装成功。 

如果没有反应，可以通过luckperm的verbose来debug下。 


视频使用教程
==================================================
.. raw:: html

  <iframe src="//player.bilibili.com/player.html?isOutside=true&aid=433226339&bvid=BV1LG411u7BE&cid=908146945&p=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>

常见问题 QA
==================================================
:Q1: 无法创建商店或命令无效？  
:A1: 检查插件是否安装、数据库配置是否正确，查看服务端日志。

:Q2: 经济功能无法使用？  
:A2: 检查 Vault 或其他经济插件是否安装，数据库连接是否正常。

:Q3: 玩家无法管理商店？  
:A3: 检查 LuckPerms 权限配置，确认已授权 quickshop.player/quickshop.moderator/quickshop.admin。

:Q4: 跨服消息不同步？  
:A4: 检查 bungee-cross-server-msg 参数是否开启，所有分区配置是否一致。