# 自定义变量模块

## 简介

让服主能够制作自己的Placeholder数字变量

支持玩家变量和全局变量

支持公式(四则运算和括号)

支持变量上限、下限和初始值

## 演示视频

{% embed url="<https://www.bilibili.com/video/BV15x4y1u7kC/>" %}

## 变量分类

Number：数字；Formula：公式；String：字符串（文字）

## 指令

```
/cpl global change [变量名] [变更值(支持负数)]：更改某个全局变量的值
/cpl global set [变量名] [新值(支持负数)]：设置某个全局变量的值
/cpl change [玩家名({online}指所有在线玩家,{offline}指不在线的所有玩家,{all}指所有进过服务器的玩家)] [变量名] [变更值(支持负数)]：更改玩家某个变量的值（玩家离线也可以用）
/cpl set [玩家名({online}指所有在线玩家,{offline}指不在线的所有玩家,{all}指所有进过服务器的玩家)] [变量名] [新值(支持负数)]：设置玩家某个变量的值（玩家离线也可以用）
/cpl reload：重载插件
```

## 权限

所有指令仅OP/控制台可用

## 变量

```
%customplaceholder_player_变量名%：获取玩家变量值
%customplaceholder_player_变量名_int%：获取玩家变量值（整数形式）
%customplaceholder_global_变量名%：获取全局变量值
%customplaceholder_global_变量名_int%：获取全局变量值（整数形式）
%customplaceholder_random_最小值_最大值_int%：用指定范围生成随机整数（范围包括最小值和最大值）
%customplaceholder_random_最小值_最大值_保留位数_double%：用指定范围生成随机小数
```

## Redis安装方法

```
如果您需要使用本插件的数据库同步功能，请按以下步骤安装Redis
第一步：在蓝奏云的插件目录中下载"redis.zip"文件，解压并转移到合适的目录
第二步：打开目录中的"redis-server.exe"
第三步：如果您修改了redis使用的端口，请修改数据库拓展插件的配置文件
注意：安装Redis后仍然需要配置MySQL，两者功能不同
```

## 配置文件

### config.yml（插件本体）

```
#授权码(自动绑定服务器ip,不绑定端口)
Token: ''
#数据库相关设置,BC服可能需要
#更改数据库配置项必须重启
MySQL:
  #是否开启数据库功能
  #如果你需要开启数据库功能,请安装蓝奏云中的另外一个插件"CustomPlaceholderDatabase"
  #并且安装redis数据库,并配置CustomPlaceholderDatabase的config.yml
  #否则无法使用数据库功能
  IsEnable: false
  IP: localhost
  Port: 3306
  DatabaseName: runoob
  Username: root
  Password: 123456
PlaceHolders:
  #全局变量
  Global:
    #活动进度
    Process:
      #数字类型，支持小数，可以用整数形式显示
      Type: Number
      InitValue: 1
      MinValue: 1
      MaxValue: 100
  #玩家变量
  Player:
    #口渴值,最低为10,最高为100,初始值为50
    #使用%customplaceholder_player_thirst%获得玩家的口渴值
    Thirst:
      Type: Number
      InitValue: 50
      MinValue: 10
      MaxValue: 100
    #战斗力
    #%customplaceholder_player_combatpower%
    CombatPower:
      #公式类型
      Type: Formula
      #公式
      Formula: '(%player_level%*5)+10'
      #如果低于这个值,则返回这个值
      MinValue: 10
      #如果高于这个值,则返回这个值
      MaxValue: 100
    #金币属性权限组，不需要的话建议删除
    MoneyGroup:
      #字符串类型
      Type: String
      #默认为group1
      InitValue: 'group1'
```

### config.yml（数据库拓展）

```
#Redis配置
Redis:
  host: "localhost"
  port: 6379
```

## 插件购买[ ](https://afdian.net/item/c8c2e3708c1811edbc1652540025c377)

[![](https://3141307931-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBpnOcGVj4U91zeYdKbvg%2Fuploads%2F9u3n2pnmFHnk6QdoY48C%2F29.99.png?alt=media\&token=732b1231-ef54-4d0f-8fb5-80275ca58031)](https://afdian.net/item/c8c2e3708c1811edbc1652540025c377)

（点击购买）