# 插件名称（必须与 Maven artifactId 一致）
name: MyPlugin

# 插件版本（建议使用 Maven 变量自动填充）
version: '${project.version}'

# 插件主类的完整类名（必须包含包名）
main: com.example.myplugin.MyPlugin

# API 版本（Paper 1.20.5+ 要求，推荐写 1.21）
api-version: '1.21'

# 插件描述
description: 一个功能强大的示例插件

# 作者（可以多个）
author: YourName

# 作者列表（也可以用这个）
authors:
  - Author1
  - Author2

# 插件网站
website: https://example.com

# 依赖关系
depend:
  - Vault          # 必须依赖，缺失时服务器不会启动

# 软依赖（可选依赖）
softdepend:
  - PlaceholderAPI # 存在时会使用，缺失不影响启动
  - WorldGuard

# 前置插件（在此插件之前加载）
loadbefore:
  - SomePlugin

# 加载顺序（STARTUP = 尽早加载，POSTWORLD = 世界加载后加载）
load: POSTWORLD

# 前缀（用于日志标识）
prefix: MyPlugin

# 是否使用独立类加载器（Paper 推荐）
folia-supported: true

# 注册的命令
commands:
  myplugin:
    description: 插件主命令
    usage: /myplugin [子命令]
    aliases:
      - mp
      - myp
    permission: myplugin.use
    permission-message: §c你没有权限使用此命令！

  heal:
    description: 治疗玩家
    usage: /heal [玩家名]
    permission: myplugin.heal

# 权限声明
permissions:
  myplugin.*:
    description: 授予所有 MyPlugin 权限
    default: op
    children:
      myplugin.use: true
      myplugin.heal: true
      myplugin.admin: true

  myplugin.use:
    description: 使用基本命令
    default: true

  myplugin.heal:
    description: 治疗自己
    default: true

  myplugin.admin:
    description: 管理员命令
    default: op
    children:
      myplugin.heal.others: true

  myplugin.heal.others:
    description: 治疗其他玩家
    default: op

commands:
  warp:
    description: 传送到指定地标
    usage: /warp <名称>
    aliases:
      - warps
      - tpwarp
    permission: myplugin.warp
    permission-message: §c你需要 myplugin.warp 权限！

// 在 onEnable() 中
var warpCmd = getCommand("warp");
if (warpCmd != null) {
    WarpCommand executor = new WarpCommand(this);
    warpCmd.setExecutor(executor);     // 处理执行
    warpCmd.setTabCompleter(executor); // Tab 补全
}

// getCommand() 可能返回 null（如果 plugin.yml 中没有声明）
var cmd = getCommand("warp");
if (cmd == null) {
    getLogger().severe("命令 'warp' 未在 plugin.yml 中声明！");
    getServer().getPluginManager().disablePlugin(this);
    return;
}

// 检查玩家是否有权限
if (player.hasPermission("myplugin.admin")) {
    // 有管理员权限
}

// 检查是否有通配符权限
if (player.hasPermission("myplugin.*")) {
    // 拥有所有权限
}

name: MyPlugin
version: '1.0.0'
main: com.example.myplugin.MyPlugin
api-version: '1.21'
description: 使用 Paper 原生格式的插件

dependencies:
  - id: vault
    required: true
    bootstrap: false
  - id: placeholderapi
    required: false
    bootstrap: false

permissions:
  myplugin.*:
    description: 所有权限
    default: op
    children:
      myplugin.use: true
      myplugin.admin: true

commands:
  myplugin:
    description: 主命令
    usage: /myplugin
    permission: myplugin.use

name: MyBungeePlugin
version: '1.0.0'
main: com.example.mybungee.MyBungeePlugin
author: YourName
description: BungeeCord 代理插件
depends:
  - SomeOtherPlugin
softDepends:
  - OptionalPlugin

name: MyPlugin
version: '${project.version}'
main: com.example.myplugin.MyPlugin
api-version: '${project.properties.api-version}'

<properties>
    <api-version>1.21</api-version>
</properties>

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <filtering>true</filtering>
        </resource>
    </resources>
</build>

tasks.processResources {
    filesMatching("plugin.yml") {
        expand(
            "version" to project.version,
            "apiVersion" to "1.21"
        )
    }
}

version: '${version}'
api-version: '${apiVersion}'

permissions:
  teleport.*:
    description: 传送系统所有权限
    default: op
    children:
      teleport.warp: true
      teleport.warp.create: true
      teleport.warp.delete: true
      teleport.home: true
      teleport.home.set: true
      teleport.tp: true
      teleport.tp.others: true

  teleport.warp:
    description: 使用公共地标
    default: true

  teleport.warp.create:
    description: 创建公共地标
    default: op

  teleport.warp.delete:
    description: 删除公共地标
    default: op

  teleport.home:
    description: 传送到家
    default: true

  teleport.home.set:
    description: 设置家的位置
    default: true

  teleport.tp:
    description: 传送到其他玩家
    default: true

  teleport.tp.others:
    description: 传送到任意玩家
    default: op