Skip to content

Latest commit

 

History

History
93 lines (71 loc) · 3.32 KB

README.md

File metadata and controls

93 lines (71 loc) · 3.32 KB

PonziScheme

这是一个Bukkit插件, 目的是宣传服务器以及推广服务器论坛, 目前已实现的功能有:

  1. Flarum论坛活跃奖励
  2. B站视频三连奖励

特点

  • 自定义任务内容和奖励
  • 支持MySQL和SQLite数据库

快速开始

  1. 将插件.jar文件复制到服务器的plugins文件夹中
  2. 进入插件文件夹, 编辑tasks.yml文件, 自定义任务
  3. 重载配置文件, 如果使用权限系统, 请赋予玩家ponzischeme.bind权限

任务配置

完整的任务配置请参考默认配置的tasks.yml文件. 此节将说明各项配置的含义.

基本配置如下, 无论任务类型都需要配置以下内容:

example:
  name: '§r§f示例任务'
  type: '{任务类型}'
  icon:
    ==: org.bukkit.inventory.ItemStack
    v: 3839
    type: NETHER_STAR
  reward:
    commands:
      - 'experience add %PLAYER% 1000'
    items:
      '1':
        ==: org.bukkit.inventory.ItemStack
        v: 3839
        type: ENCHANTED_GOLDEN_APPLE
  • example是任务id, 用于识别任务, 任务id不能重复, 玩家完成任务后数据库中会存储这个id, 一旦上线后不应该再修改.
  • name是任务显示名称, 支持颜色代码.
  • type是任务类型, 目前支持flarum_post_activate和bilibili_video_sanlian
  • icon是任务图标, 为物品序列化后的yaml文本, 可通过/ps reader指令打开物品读取器来读取物品的yaml.
  • reward是任务奖励, 包含commands和items两种类型:
    • commands是命令列表, 玩家完成任务后会执行这些命令, %PLAYER%会被自动替换为玩家名称.
    • items是物品列表, 同icon一样, 也是物品序列化后的yaml文本.

Flarum任务配置

论坛活跃任务, 类型为flarum_post_activate, 还必需要配置以下内容:

example:
  condition:
    repeat: 'days'
    count: '1'
  • condition是任务条件, 包含repeat和count两个子健:
    • repeat是任务的重复周期, 目前支持days和weeks, 代表每周活跃或每日活跃
    • count是指达成任务条件所需要的活跃次数, 例如repeat: 'days'和count: '1'代表每日活跃一次

B站视频三连任务配置

B站视频三连任务, 类型为bilibili_video_sanlian, 还必需要配置以下内容:

example:
  bvid: '{视频BV号}'
  timeLimit: '5m'
  condition:
    - 'like'
    - 'coin'
    - 'favor'
  • bvid是视频BV号, 可以在B站视频页面的URL中找到, 例如 https://www.bilibili.com/video/BV1KV411w7jp 中的 BV1KV411w7jp
  • timeLimit是任务限制时间, 支持s, m, h和d4种单位, 例如timeLimit: '5m'代表任务限制5分钟, timeLimit: '2m30s'代表任务限制2分钟30秒, 此值建议设置在5分钟之内, 因为本插件实际上只能通过规定时间内视频三连的次数来判断是否达成任务, 无法知道是谁达成的任务.
  • condition是任务条件, List类型, 可选的值为like, coin和favor, 分别代表点赞, 投币和收藏, 如果不希望做任何检查, 可以留空condition: [].

权限

一般情况下, 给予玩家ponzischeme.bind权限即可.

权限节点 描述
ponzischeme.bind 允许玩家绑定账号
ponzischeme.reload 允许玩家重载配置文件
ponzischeme.reader 允许玩家打开物品读取器