==================================================
地皮插件安装
==================================================
地皮插件为新手玩家提供专属小空间，方便存放物资和体验建筑玩法。推荐使用 PlotSquared 插件，支持高度自定义、经济系统、权限控制等功能。

插件简介
==================================================
- 支持多世界、多风格地皮生成
- 可自定义地皮大小、道路、地皮合并等
- 支持经济系统，地皮买卖、合并、出售
- 与 WorldEdit/FastAsyncWorldEdit 完美兼容
- 支持 LuckPerms 权限分组
- 免费开源，部分高级功能需付费

安装步骤
==================================================
1. 下载官方源码，执行 `./gradlew clean build` 构建 jar 包（或付费获取成品 jar）
2. 将 jar 包放入 `/home/mc/instances/dp1/plugins/`
3. 安装 FastAsyncWorldEdit（推荐），无需单独安装 WorldEdit

.. note::
   地皮插件仅需在地皮分区（如 dp1）安装，其他分区无需部署。


关键链接
==================================================

- github: https://github.com/IntellectualSites/PlotSquared
- wiki: https://intellectualsites.gitbook.io/plotsquared/

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

    CREATE DATABASE d_plot_db CHARACTER SET utf8 COLLATE utf8_general_ci;

配置文件修改
==================================================
.. code-block:: diff

    # storage.yml 数据库配置差异
    6c6
    <   use: false
    ---
    >   use: true
    13,14c13,14
    <   use: true
    <   host: "127.0.01"
    ---
    >   use: false
    >   host: "localhost"
    16,18c16,18
    <   user: "mc"
    <   password: "mc_panda_142857"
    <   database: "d_plot_db"
    ---
    >   user: "root"
    >   password: "password"
    >   database: "plot_db"

地皮世界初始化
==================================================
1. 运行以下命令将主世界（world）转换为 PlotSquared 世界：

.. code-block:: bash

    /p setup world
    /plot setup normal
    /plot setup stone

2. 按照提示填写参数，建议使用默认值或根据实际需求调整
3. 设置地皮世界名称，如再次执行 `/p setup world` 可覆盖已有设置

地皮世界配置示例
==================================================
最终生成的 `worlds.yml` 文件示例（部分参数可根据需求调整）：

.. code-block:: yaml

    configuration_version: v5
    worlds:
      world:
        plot:
          height: 62
          size: 10
          filling: smooth_stone
          floor: grass_block
          bedrock: true
          biome: minecraft:forest
          sign_material: OAK_WALL_SIGN
          auto_merge: false
          create_signs: true
        wall:
          place_top_block: true
          block: smooth_stone_slab
          block_claimed: sandstone_slab
          filling: smooth_stone
          height: 62
        road:
          width: 7
          height: 62
          block: quartz_block
        gamemode: creative
        border_size: 1
        border: false
        economy:
          prices:
            merge: 100
            sell: 100
            claim: 100
          use: false
        natural_mob_spawning: false
        mob_spawner_spawning: false

重新生成地皮世界
==================================================
如需重新生成地皮世界，需先删除原有 world 文件夹：

.. code-block:: bash

    systemctl stop mc_dp1
    mv /home/mc/instances/dp1/world /home/mc/instances/dp1/world.bak
    systemctl start mc_dp1

地皮中心区域规划
==================================================
建议将地皮中心的4个方格预留为管理区，避免普通玩家占用，方便后期建筑或活动。

.. code-block:: bash

    # 进入地皮中心区域，设置所有者
    plot setowner <管理员ID>
    # 连续设置中心4个地皮所有者
    ...
    # 合并4个地皮为1个
    plot merge


权限配置
==================================================

.. code-block:: bash 

  /lp creategroup g_plots 0 g_plots
  /lp group default parent add g_plots
  # 基础地块操作
  # 允许创建1个地块
  /lp group g_plots permission set plots.plot.1 true
  # 传送至自己的地块  
  /lp group g_plots permission set plots.home true  
  # 查看自己的地块信息          
  /lp group g_plots permission set plots.info true   
   # 放弃自己的地块         
  /lp group g_plots permission set plots.abandon true   
   # 申请一块地皮，脚下的     
  /lp group g_plots permission set plots.claim true  
   # 申请一块地皮,随机        
  /lp group g_plots permission set plots.auto true  
  # 去别人家的。 可以选择性授权。
  /lp group g_plots permission set plots.visit true             

  # 地块编辑与管理
   # 允许在自己地块建造/破坏
  /lp group g_plots permission set plots.build true 
    # 邀请其他玩家进入地块         
  /lp group g_plots permission set plots.add true    
     # 移除被邀请的玩家       
  /lp group g_plots permission set plots.remove true   
   # 允许设置地块基础规则（如禁止他人进入/破坏）    
  /lp group g_plots permission set plots.flag.set true       

  # 其他常用功能
     # 查看自己的地块列表
  /lp group g_plots permission set plots.list true    
    # 允许标记地块为出售状态（按需开启）     
  /lp group g_plots permission set plots.sell true          



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

:Q2: 地皮经济功能无法使用？  
:A2: 检查 economy.use 参数是否开启，确认经济插件（如 Vault）已安装。

:Q3: 玩家无法合并地皮？  
:A3: 检查 LuckPerms 权限配置，确认已授权 plot.merge 相关权限。

:Q4: 地皮中心被玩家占用？  
:A4: 建议提前设置中心地皮所有者，并合并为管理区。