CSR - PFEssentials - Back/TPA/Warp/Home/Money/PopupInfo/多语言 [/Sidebar]

资源类型: 原创

版权链接: #

依赖: CSR[BDSNetRunner]

语言: 中文（简体）

支持版本

1.16

基于CSR打造的基础性插件【测试】
目前插件会保持更新和维护,除非CSR社区版停更,请不要传播谣言,插件新的功能会根据社区版CSR制作,不必担心无法使用
有能力的小伙伴也可以赞助一下作者赞助通道
另外感谢@liuxiaohua开发和维护的BDSNetRunner，极大地降低了插件开发成本
（目前仅有sidebar需要csr商业版）
遇到问题？这边推荐隔壁的LLEssentials，C艹原生性能更得劲，支持与本插件混搭

插件保持免费，并且每个功能组件均支持单独配置，可以任意与其他符合编写规范的插件混用
比如觉得本插件的TPA比较好，但又不需要home部分，可以在配置文件自行修改ModuleEnabled

本插件可以作为前置
附带大量API方便开发者调用
使用方法见文末

功能会不断更新（学业-缓更）
说明：√已完成/□制作中
TPA
√tpa(指令+表单)
√tpahere(指令+表单)
√个人设置(屏蔽、黑名单)
Tpr
√/tpr 随机传送
Home
√home(指令+表单)
Warp
√ 传送点(指令+表单)
Back
√ 死亡返回
√ 死亡记录
PopupInfo
√ 可自定义的屏幕悬浮信息
Sidebar(商业版CSR)
√ 侧边栏自定义信息显示（配置文件config.json见下）
Server
□ 跨服菜单(指令+表单)
□ 动态motd
Money(计分板经济扩展或对接LLMoney)
√ 计分板花费项（+自定义数学表达式）
√ 计分板转账
√ 经济OP管理面板
√ 计分板离线操作
√ 对接LLMoney,使用方法自行看配置文件Money项里面的注释(只能使用一种Money哦！！！)
CustomForm/暂时搁置，同类插件过多,不必制作
□ 自定义表单
WhitelistEnchant
□ WPF管理白名单
□ BlackBE云黑对接
ChestLock
□ ~~锁箱插件(准备从JSChestLock移植)~~JSR-PFLock可用，就不移植了
实验功能 [Hook]
√ 隐藏种子
√ 锁定世界选项（设置界面世界选项按钮灰色）
√ 强制玩家下载材质包同时允许玩家叠加自己的材质包
√ 强制开启/禁用玩家脚本(Scripts)环境要求
其他内容
√ 作为前置API
√ 自定义语言文件(已完成80%)
√ 多语言支持（尚未默认添加）
√ 检查更新窗口，控制台命令update打开
√ 启动自动检测更新（使用minebbs源检测）

子插件
PFBehaviorLog行为日志（access数据库）

配置文件位于"[BDS目录]\plugins\PFEssentials\config.json"：

{
  "Enabled": true,//是否启用本插件
  "AsyncInvoke": true,//部分功能异步执行(避免服务器卡顿，建议开启)
  "Money": {
    "ModuleEnabled": true,//计分板经济
    "scoreboard": "money",//计分板名
    "MoneyQueryCommand": "mymoney",//查询自己的money的命令
    "MoneyChangedFeedback": true,//计分板改变时向玩家发送提醒
    "MoneyCost": {//计分板花费项目
      "AddHomeCost": {//添加Home的花费（之后会加上更多内容）
        "ModuleEnabled": true,//是否启用该功能,需要开启总选项Money的ModuleEnabled
        "Expressions": [//自定义运算表达式(改之前耐心看完)
          "//可用参数[最大Home[取自配置文件]] : MaxHomeCount",
          "//可用参数[尝试创建的Home的维度id] : NewHomeDimid",
          "//可用参数[尝试创建的home的x坐标] : NewHomeX",
          "//可用参数[尝试创建的home的y坐标] : NewHomeY",
          "//可用参数[尝试创建的home的z坐标] : NewHomeZ",
          "//可用参数[当前已有的Home数量] : HomeCount",
          "//最后一条表达式为>返回值<，除了最后一条都必须是>赋值语句<",
          "//下面开始你的发挥（前缀//表示注释）",
          "//使用标准的数学表达式",
          "freeCount = 3",
          "charged = HomeCount >= freeCount",
          "iff(charged == 0 , 0 ; charged , max(HomeCount - 2,1) ^ 5 )"
        ]
      }
    }
  },
  "TPA": {
    "ModuleEnabled": true,//是否启用TPA模块
    "Timeout": 15.0//tpa请求超时时长（秒）
    "AllowTpaToSelf": true,
    "RegisterCmdOnPlayerJoin": true//玩家加入时注册/tpa xxx命令
  },
  "Home": {
    "ModuleEnabled": true,//是否启用Home模块
    "Maxhome": 5//每个玩家最大Home数量
  },
  "Warp": {
    "ModuleEnabled": true,
    "RegisterPerWarpCmd": true
  },
  "DeathBack": {
    "ModuleEnabled": true,
    "DeathHistoryCmd": true,
    "DeathHistoryCount": 5,
    "BackCmdTeleport": true,
    "OnDeathEchoInfo": true
  },
  "Sidebar": {//侧边栏在这，别再问我在哪改，配置文件写得这么清除，不识字还是没耐心？
    "ModuleEnabled": true,
    "RefreshOnJoin": true,
    "RefreshOnMoneyChange": true,
    "RefreshByTimer": true,
    "RefreshTimerInterval": 1.0,
    "Title": "欢迎%name%~",
    "List": [
      "你拥有Money:%money%",
      "北京时间%date:T%",
      "%date:D%",
      "%date:dddd%",
      "游戏愉快~"
    ]
  },
  "Experiment": {
    "HookStartGamePacket": {
      "FakeSeed": {
        "ModuleEnabled": true,
        "Seed": 114514
      },
      "LockWorldOptitions": {
        "ModuleEnabled": true
      }
    }
  }
}
//请务必保证JSON语法正确，否则无法正常读取
//不用担心配置文件更新后需要重改，新增项会自动填充

编写语言VisualBasic.net
避免**这个不开源
想要参考如何编写CSR插件的请前往我的其他开源插件
[CSR]PixelFaramitaSHOP计分板插件商店 (C#)
[CSR]PFWebsocketAPI (VisualBasic.net)

[轻量版]
附带下载

前置API调用方法
1. C#或者vb.net创建项目后引用下载到的dll
2. 使用PFEssentials命名空间即可调用api(添加using(或者vb的imports))
（直接引用即可，不会有任何命名空间冲突）
3. 把开发"API描述清单和调试信息文件.zip"放到dll相同目录，就能看到命名控件下各个类、结构的清单提示信息
4.必须在使用任意api之前执行PFEssentials.Setup(api);来注入

目前已有api：
FormManager表单（支持全部自定义，全部模块化操作）