基础功能

Aug_Sakura

2355字约8分钟

2024-08-18

基础设置

注

设置文件地址名称：config.yml
语言文件地址名称：lang/zh_CN.yml
GUI文件地址名称：lang/zh_CN_gui.yml

可配置语言文件、所有 title 的显示时间（20 tick 为1秒）以及区域选择的工具
关于区域选择工具的使用功能及方法请查看本页面中的挂机池设置项
想了解更多支持的变量，请前往变量支持页面查看
语言文件支持自定义，暂不支持 HEX 颜色格式

config.yml

# 当前配置版本
version: 1.0

# 基础配置
setting:
  # 语言
  language: zh_CN
  # 进入离开获取奖励的 title 显示时间 单位: tick
  title-time: 20
  # 选择区域的工具材质 默认: WOODEN_SHOVEL
  selection-material: WOODEN_SHOVEL

zh_CN.yml

# 当前语言文件配置版本 
version: 1.0

# 前缀
prefix: '&7[ &6挂机池 &7] >>> &f'

# 没有权限
not-permission: '&c你没有权限执行这个命令哦!'
# 不是玩家
not-player: '&c这个命令只能玩家执行哦!'
# 不是挂机池管理员
not-owner: '&c你还不是挂机池的管理员哦!'

# 重载
reload:
  success: '&a重载成功! 数据库等配置可能需要重启服务器才能生效!'
  fail: '&c重载失败!'

# 玩家
player:
  # 你获得了奖励 标题
  get-reward-title: '&a你获得了挂机奖励!'
  # 你获得了奖励 副标题
  get-reward-subtitle: '&a经验: &e%afk_area_exp% &a金币: &e%afk_area_money%'
  # 你进入了挂机池 默认提示 未设置则显示这个
  enter-afk: '&a你进入了 &e%afk_area_name% &a挂机池!'
  # 你离开了挂机池 默认提示 未设置则显示这个
  leave-afk: '&a你离开了 &e%afk_area_name% &a挂机池!'

# 挂机池
afk-area:
  # 选择了第一个点
  select-first: '&a你选择了第一个点!'
  # 选择了第二个点
  select-second: '&a你选择了第二个点!'
  # 已经选择了区域
  already-select: '&a由于你已经选择了区域, 会根据选择的区域创建挂机池'
  # 玩家添加到挂机池成功
  add-success: '&a成功添加该玩家到挂机池!'
  # 玩家已经在挂机池中
  already-in: '&c你该玩家经在挂机池列表中了!'
  # 未输入挂机池名称
  not-input-name: '&c请输入挂机池名称!'
  # 挂机池创建成功
  create-success: '&a挂机池创建成功!'
  # 挂机池已存在
  already-exist: '&c挂机池已存在!'
  # 挂机池位置参数错误
  location-error: '&c挂机池位置参数错误!'
  # 挂机池不存在
  not-exist: '&c挂机池不存在!'
  # 世界不存在
  world-not-exist: '&c世界不存在!'
  # 挂机池区域设置成功
  location-success: '&a挂机池区域设置成功!'
  # 未输入管理员名称
  not-input-owner: '&c请输入管理员名称或未输入区域名称!'
  # 该玩家已经是挂机池管理员
  already-owner: '&c该玩家已经是挂机池管理员了!'
  # 挂机池管理员设置成功
  owner-success: '&a挂机池管理员设置成功!'
  # 未输入挂机经验
  not-input-exp: '&c请输入挂机经验或未输入区域名称!'
  # 经验设置成功
  exp-success: '&a挂机经验设置成功!'
  # 未输入挂机金币
  not-input-money: '&c请输入挂机金币或未输入区域名称!'
  # 金币设置成功
  money-success: '&a挂机金币设置成功!'
  # 未输入挂机时间
  not-input-interval: '&c请输入挂机时间或未输入区域名称!'
  # 时间设置成功
  interval-success: '&a挂机时间设置成功!'
  # 删除挂机池成功
  delete-success: '&a删除挂机池成功!'
  # 标题设置成功
  title-success: '&a挂机池标题设置成功!'
  # 副标题设置成功
  subtitle-success: '&a挂机池副标题设置成功!'

zh_CN_gui.yml

# 当前GUI配置版本
version: 1.0

# 主界面
main:
  # 标题
  title: "挂机池管理"

# 占位物品
placeholder:
  # 物品材质
  material: "BLACK_STAINED_GLASS_PANE"
  # 是否附魔
  enchant: false
  # 物品名称
  name: "&7分隔板"
  # 物品Lore
  lore:
    - "&7这是一个占位物品"

# 挂机池信息
afk-info:
  # 物品材质
  material: "PAINTING"
  # 是否附魔
  enchant: false
  # 名称
  name: "&f挂机池信息"
  # 信息
  lore:
    - ""
    - "&7挂机池名称: &6%afk_area_name%"
    - "&7挂机池管理员: &6%afk_area_owner%"
    - "&7挂机池经验: &6%afk_area_exp%"
    - "&7挂机池金币: &6%afk_area_money%"
    - "&7挂机池秒数: &6%afk_area_time%"
    - ""
    - "&e左键点击传送到挂机池"
    - ""

# 玩家列表
player-list:
  # 显示颜色
  color: "&r&e"
  # 信息
  lore:
    - ""
    - "&7右键删除玩家"
    - ""

# 下一页
next-page:
  # 物品材质
  material: "ARROW"
  # 是否附魔
  enchant: false
  # 名称
  name: "&7下一页"

# 上一页
previous-page:
  # 物品材质
  material: "ARROW"
  # 是否附魔
  enchant: false
  # 名称
  name: "&7上一页"

# 关闭
close:
  # 物品材质
  material: "BARRIER"
  # 是否附魔
  enchant: false
  # 名称
  name: "&7关闭"

数据库设置

目前只支持 SQLite 数据库，后续可能会支持更多数据库

config.yml

# 当前配置版本
version: 1.0

# 数据库配置 目前只支持sqlite
database:
  # 数据库类型
  type: sqlite
  # 数据库表前缀
  prefix: afk_
  # 数据库驱动
  drivers:
    # sqlite
    sqlite:
      # 数据库文件路径
      path: '%plugin_folder%/afk.db'
  # 数据库连接池 不清楚的话不要修改
  pool:
    connection-timeout: 30000
    idle-timeout: 600000
    max-lifetime: 1800000
    maximum-pool-size: 15
    keepalive-time: 0
    minimum-idle: 5

挂机池设置

创建删除挂机池
创建挂机池指令
/bafk admin create 挂机池名称
删除挂机池指令
/bafk admin delete 挂机池名称
删除挂机池将是一个不可逆的过程，请谨慎操作
- 创建一个名为 afk 的挂机池
```
/bafk admin create afk
```
- 删除一个名为 akf 的挂机池
```
/bafk admin delete afk
```
设置挂机池区域
提示
挂机池区域可以选择两种不同的方式进行设置，设置时需要注意获取挂机区域两个顶点的坐标（类似领地插件和小斧头插件的使用方式）
- 指令设置
设置挂机池区域指令
/bafk admin setlocation 挂机池名称区域所在世界第一个x坐标第一个y坐标第一个z坐标第二个x坐标第二个y坐标第二个z坐标
设置名为 afk 的挂机池设置挂机区域
区域在 world 世界，并且两个坐标分别为 (-125, 0, 111)、(-135, 15, 120)
```
/bafk admin setlocation afk world -125 0 111 -135 15 120
```
- 区域选择工具设置
设置挂机池区域指令
/bafk admin setlocation 挂机池名称
插件还提供了一种简单的设置方式，通过使用设置的区域选择工具进行选择。左键选择第一个区域，右键选择第二个区域，然后输入设置指令即可设置
设置名为 afk 的挂机池设置挂机区域
```
使用 材质为 WOODEN_SHOVEL 的工具左键第一个点，并查看选取提示
使用 材质为 WOODEN_SHOVEL 的工具右键第二个点，并查看选取提示
选取完成后使用指令 /bafk admin setlocation afk
```
设置经验、金币、挂机周期
设置挂机池经验指令
/bafk admin setexp 挂机池名称经验数量
设置挂机池金币指令
/bafk admin setmoney 挂机池名称金币数量
设置挂机池挂机周期指令
/bafk admin setinterval 挂机池名称多少秒
- 设置名为 afk 挂机池每 10 秒为在挂机池中的玩家增加 20 金币及 35 经验值
- 注意设置金币需要安装 Vault 前置插件
```
/bafk admin setinterval afk 10
/bafk admin setmoney afk 20
/bafk admin setexp afk 35
```
设置挂机池管理员
设置挂机池管理员指令
/bafk admin setowner 挂机池名称在线玩家名称
- 设置名为 afk 挂机池的管理员为 Aug_Sakura
```
/bafk admin setowner afk Aug_Sakura
```
结束

挂机池管理

玩家管理
打开玩家管理 GUI 页面指令
/bafk open
打开 GUI 页面的指令只有挂机池的管理员可以使用，并且只能对自己的挂机池进行管理，在当前页面可以查看允许在当前挂机池挂机的玩家、挂机参数并且可以移除允许挂机的玩家
添加玩家
添加玩家指令
/bafk add 在线玩家名称
添加玩家的指令只有挂机池的管理员可以使用，并且只能对自己的挂机池进行添加，添加后的玩家可以在玩家管理 GUI 页面中查看
- 将玩家 Aug_Sakura 添加到我管理的挂机池内
```
/bafk add Aug_Sakura
```
设置挂机标题
设置进入挂机池主标题
/bafk setJoinTitle 标题内容
设置进入挂机池副标题
/bafk setJoinSubtitle 副标题内容
- 设置我管理的挂机池进入
  主标题为：欢迎进入我的挂机池
  副标题为：这是一个副标题
```
/bafk setJoinTitle 欢迎进入我的挂机池
/bafk setJoinSubtitle &a这是一个副标题
```
结束