配置文件

配置文件结构如下

CraneAttribute
├── attributes 脚本属性目录
│    └── 脚本文件（目录）
├── expansions 扩展功能目录
├── libs 脚本共享库目录
├── lang 语言文件目录
│    └── zh_CN.yml 语言文件
├── config.yml 核心配置文件
├── attribute.yml 属性相关配置文件
└── read.yml 读取相关配置文件

提示

所有目录均可在里面嵌套文件夹

默认配置

config.yml

# 数据库设置
sql:
  # 关闭则将数据储存至本地
  enable: false
  host: 127.0.0.1
  port: 3306
  user: root
  password: "123456"
  database: "crane_attribute"
  # 此功能暂未实现
  # 多长时间保存一次
  auto save: 12000

# debug 等级
debug level: 0

# 取消注册的系统属性类型
# 仅在插件启动时生效一次，若取消了属性类型的注册，对应类型的属性也无法被加载
# 无法取消 DEFAULT 类型，它是必须存在的
cancel system attribute type: [ ]

# 创建插件默认资源文件
create system resource file: true

# 此功能暂未实现
# 属性计数器中，可以存储到数据库的计数器
counter persist:
  # 数值类型计数器
  values:
    - "test"
  # 文本类型计数器
  texts:
    - "test"

attribute.yml

# 这里的属性始终跟随脚本中的设置
# 脚本中的设置会覆盖这里的设置
attributes: {}

# 属性触发器设置
trigger setting: {}

# 其他选项
options:
  # 取消伤害粒子
  # 依赖 ProtocolLib
  cancel heart particle: true
  # 取消饱食度消耗
  cancel food change: true
  # 取消原版护甲
  cancel default armor: true
  # 血量相关
  health:
    # 默认生命值
    base value: 20.0
    # 是否生命压缩
    # 如果你使用了其他血条HUD覆盖 建议关闭
    scaled: true
    # 生命压缩血量
    scale: 20
  # 此功能暂未实现
  # 限制属性的世界
  limit attribute worlds:
    - shop_world

read.yml

# 数值读取组件的配置
read value: {}

# 条件读取组件的配置
read condition: {}

# 属性映射读取组件的配置
read mapping: {}

# 其他选项
options:
  # 是否检测 lore
  parse lore: true
  # 是否检测 nbt
  parse nbt: true
  # 检测 nbt 使用的标签
  nbt tag: 
    - "CraneAttribute"
  # 拒绝提供属性检测的字符串
  refuse attribute string:
    - "此物品不提供属性"
  # 过滤符
  filter char:
    # 无视字符串
    cancel: "§-"
    # 只取字符串左边
    left: "§|"
    # 只取字符串右边
    right: "§>"
    # 分割字符串
    spilt: "§/"

共享库目录

libs 脚本共享库目录，它会最先被插件加载

在此目录中，可以存入 .js 和 .groovy 文件，未来可能还会支持 .jar 文件

这个里面的文件均会动态编译并加载到 JVM 中，可以在其他脚本文件和此目录下的文件相互调用

文件存放位置

文件类型	属性文件位置	扩展文件位置	库文件位置
.js	attributes	不支持	libs
.groovy	attributes	expansions	libs

.groovy 任意不同的文件可以都存放到 attributes libs expansions 任一目录中，但实际加载时，是按照的是文件本身的内容加载的，后面会详细介绍

.groovy 虽然可以随便放，但是还是建议按照不同的文件类型（功能）区分，否则可能混淆文件，不方便管理