cs2脚本指令操作插件
PointsSystem 插件（v2.1.0）功能介绍及使用教程
一、插件概述
PointsSystem 是基于 CounterStrikeSharp（CSS）开发的一款 CS 服务器插件，核心功能包含「用户积分管理」「积分兑换系统」「脚本执行系统」三大模块，支持管理员创建用户账户、分配积分，用户可使用积分兑换游戏道具、福利，同时支持执行自定义脚本（如剧情、倒计时等），适用于各类 CS 服务器（尤其适配越狱服、娱乐服），操作简单、配置灵活，无需复杂修改即可直接使用。
插件版本：v2.1.0 依赖环境：CounterStrikeSharp API（需提前安装）
==============================================
还是一款用处不大的插件，能用的地方就只有脚本功能，因为账号系统很鸡助。
就连脚本功能都很鸡助，需要手动输入指令才能执行，或者搭配其他插件输入指令执行
==============================================
二、核心功能详细介绍
2.1 基础功能说明
插件加载后会自动创建 3 个核心配置/数据文件（位于插件目录下），无需手动创建，首次加载会生成默认配置，可后续按需修改：
-
accounts.json：用户账户数据文件，存储所有用户的用户名、积分信息，自动保存/加载。
-
redeem.json：积分兑换配置文件，存储可兑换的道具、福利及对应积分成本、执行指令。
-
scripts.json：脚本配置文件，存储自定义脚本（如剧情、倒计时），支持多步骤、延迟执行。
插件加载成功后，控制台会输出加载信息（包含账户数、兑换物品数、脚本数），可通过控制台确认插件是否正常运行。
2.2 三大核心模块功能
模块1：用户积分管理
核心作用：管理员可创建用户账户、查询用户积分、添加积分，同时支持列出服务器内所有用户（按积分排序，显示前10名），所有操作实时保存到 accounts.json，重启服务器不丢失数据。
关键规则：
-
用户名长度限制：3-20个字符，不可为空或纯空格。
-
新用户默认积分：200点（创建账户时自动分配）。
-
账户唯一标识：用户名不区分大小写（如“Test”和“test”视为同一个账户）。
模块2：积分兑换系统
核心作用：用户可使用账户内的积分，兑换插件配置好的道具、福利，支持3种兑换模式，满足不同场景需求：
-
单指令兑换（Command）：兑换后执行单一指令（如发放一把武器）。
-
随机指令兑换（RandomCommands）：兑换后按概率随机执行一个指令（如宝箱抽奖，不同道具概率不同）。
-
多指令序列兑换（Commands）：兑换后按顺序执行一组指令，支持延迟执行（如分阶段发放VIP套装）。
默认兑换物品（首次加载自动生成，可修改 redeem.json 自定义）：
-
knife（50积分）：获得一把刀，执行指令“css_give {username} weapon_knife”。
-
lootbox（100积分）：武器宝箱，随机获得AWP（10%）、AK47（30%）、沙漠之鹰（40%）、刀（20%）。
-
vip（500积分）：VIP套装，分阶段发放AK47、AWP、防弹衣，伴随系统提示。
-
lucky（150积分）：幸运轮盘，5%概率获得500积分、15%概率获得200积分、30%概率获得50积分、50%概率无奖励。
模块3：脚本执行系统
核心作用：管理员可通过指令执行预设脚本，支持剧情脚本、倒计时、批量操作等，脚本可包含延迟执行、系统提示、积分发放、武器发放等操作，适配越狱服剧情、活动举办等场景。
脚本核心特性：
-
支持注释：以“#”开头的行视为注释，不执行，可用于标记脚本阶段（如“#第一天”）。
-
支持延迟执行：通过“delay 毫秒数”指令，设置后续指令的延迟时间（如“delay 1000”表示延迟1秒）。
-
支持变量替换：脚本中“{username}”会自动替换为执行脚本时指定的用户名（无指定则显示“Unknown”）。
-
多步骤执行：脚本可包含多行指令，按顺序执行，支持跨多行的复杂剧情。
默认脚本（首次加载自动生成，可修改 scripts.json 自定义）：
-
jailbreak（脚本ID：jailbreak）：7天越狱剧情，分阶段发放武器、提示剧情进度，最终越狱成功可获得500积分奖励。
-
countdown（脚本ID：countdown）：5秒倒计时脚本，适合活动开场、比赛准备等场景。
三、安装步骤
前提：服务器已安装 CounterStrikeSharp API（确保版本兼容，建议使用最新稳定版）。
-
下载 PointsSystem 插件压缩包，解压后得到插件文件夹（内含插件核心文件及配置模板）。
-
将插件文件夹复制到 CS 服务器的“addons/counterstrikesharp/plugins/”目录下。
-
重启 CS 服务器，插件会自动加载，并在插件目录下生成 accounts.json、redeem.json、scripts.json 三个文件。
-
查看服务器控制台，若出现“[PointsSystem] Plugin loaded!”相关提示，说明插件安装成功。
注意：若加载失败，控制台会输出错误信息（如依赖缺失、配置异常），可根据提示排查问题（优先检查 CounterStrikeSharp 版本）。
四、详细使用方法（控制台指令）
所有指令均需在服务器控制台输入（管理员权限），指令格式统一为“css_xxx”，部分指令支持玩家在游戏内输入（需管理员权限），具体使用方法如下：
4.1 用户积分管理指令（核心指令）
|
指令
|
指令格式
|
功能说明
|
注意事项
|
|---|---|---|---|
|
css_create
|
css_create <username>
|
创建新用户账户，默认分配200积分
|
用户名需3-20个字符，不可重复
|
|
css_points
|
css_points <username>
|
查询指定用户的当前积分
|
用户名不区分大小写，用户不存在会提示“User not found”
|
|
css_addpoints
|
css_addpoints <username> <amount>
|
给指定用户添加积分
|
amount 需为整数（可正数，不可为负数），用户不存在会提示错误
|
|
css_listaccounts
|
css_listaccounts
|
列出服务器内所有用户，按积分降序显示前10名
|
无用户时提示“No accounts”
|
4.2 积分兑换指令
|
指令
|
指令格式
|
功能说明
|
注意事项
|
|---|---|---|---|
|
css_redeem
|
css_redeem <username> <itemId>
|
指定用户兑换对应ID的物品，扣除对应积分并执行兑换指令
|
1. 用户积分不足会提示所需积分；2. itemId 需与 redeem.json 中的物品ID一致；3. 用户/物品不存在会提示错误
|
|
css_redeemlist
|
css_redeemlist
|
列出所有可兑换物品，显示物品ID、描述及积分成本
|
无兑换物品时提示“No items”
|
4.3 脚本执行指令
|
指令
|
指令格式
|
功能说明
|
注意事项
|
|---|---|---|---|
|
css_jb
|
css_jb <scriptID> [username]
|
执行指定ID的脚本，可选指定用户名（脚本中{username}会替换为该名称）
|
1. scriptID 需与 scripts.json 中的脚本ID一致；2. 不指定用户名时，{username}显示为“Unknown”；3. 脚本不存在会提示错误
|
|
css_scriptlist
|
css_scriptlist
|
列出所有可用脚本，显示脚本ID、名称及描述
|
无脚本时提示“No scripts configured”
|
五、配置文件自定义教程
插件默认配置可满足基础使用，若需自定义兑换物品、脚本，可修改对应JSON配置文件（建议修改前备份原文件，避免配置错误导致插件异常）。
5.1 自定义积分兑换物品（修改 redeem.json）
文件结构：整体为字典格式，Key 为物品ID（唯一，如“health”），Value 为兑换物品详情，支持3种配置模式，示例如下：
模式1：单指令兑换（Command）
{ "health": { "Cost": 30, "Description": "获得100点生命值", "Command": "css_health {username} 100" } }
参数说明：
-
Cost：兑换所需积分（整数，不可为负数）。
-
Description：物品描述（显示在 css_redeemlist 指令结果中）。
-
Command：兑换后执行的指令，{username} 自动替换为用户名。
模式2：随机指令兑换（RandomCommands）
{ "luckydraw": { "Cost": 200, "Description": "幸运抽奖（高概率获得积分）", "RandomCommands": [ { "Command": "css_addpoints {username} 1000", "Probability": 5 }, { "Command": "css_addpoints {username} 300", "Probability": 20 }, { "Command": "css_addpoints {username} 100", "Probability": 50 }, { "Command": "say {username} 下次加油！", "Probability": 25 } ] } }
参数说明：
-
RandomCommands：指令列表，每个指令包含 Command（执行指令）和 Probability（概率，整数，越大概率越高）。
-
概率计算：总概率为所有指令 Probability 之和，单个指令概率 = 自身 Probability / 总概率。
模式3：多指令序列兑换（Commands）
{ "supervip": { "Cost": 1000, "Description": "超级VIP套装（豪华福利）", "Commands": [ "say {username} 开始领取超级VIP套装！", "delay 1500", "css_give {username} weapon_awp", "css_give {username} weapon_deagle", "say {username} 获得AWP和沙漠之鹰！", "delay 1000", "css_addpoints {username} 200", "say {username} 超级VIP套装领取完成！" ] } }
参数说明：
-
Commands：指令列表，按顺序执行，支持“delay 毫秒数”设置延迟。
-
注释：可在指令后添加“#注释内容”，插件会自动忽略注释部分（如“delay 1000 #延迟1秒”）。
5.2 自定义脚本（修改 scripts.json）
文件结构：整体为字典格式，Key 为脚本ID（唯一，如“activity”），Value 为脚本详情，示例如下：
{ "activity": { "Name": "活动开场脚本", "Description": "活动开场提示+奖励发放", "ScriptContent": "#活动开场 say ========== 活动开始 ========== say 欢迎 {username} 参与本次活动！ delay 2000 say 所有参与者获得 100 积分奖励！ css_addpoints {username} 100 delay 1500 say 活动正式开始，祝大家玩得开心！" } }
参数说明：
-
Name：脚本名称（显示在 css_scriptlist 指令结果中）。
-
Description：脚本描述（简要说明脚本功能）。
-
ScriptContent：脚本内容，每行一个指令，支持以下特性：
-
注释：#开头的行，用于标记脚本阶段或说明。
-
延迟：delay 毫秒数（如“delay 2000”=延迟2秒）。
-
变量替换：{username} 自动替换为执行脚本时指定的用户名。
-
任意CS服务器指令：可直接写入服务器支持的指令（如 css_give、say、css_addpoints 等）。
-
六、常见问题排查
6.1 插件加载失败
-
原因1：CounterStrikeSharp API 未安装或版本不兼容 → 解决方案：安装最新稳定版 CSS API，重启服务器。
-
原因2：插件文件缺失或放置路径错误 → 解决方案：检查插件文件夹是否放在“addons/counterstrikesharp/plugins/”目录下，确保所有核心文件齐全。
-
原因3：配置文件损坏 → 解决方案：删除损坏的JSON文件（accounts.json/redeem.json/scripts.json），重启服务器，插件会自动生成默认配置。
6.2 指令执行失败
-
提示“User not found” → 检查用户名是否正确，或该用户未创建账户（使用 css_create 指令创建）。
-
提示“Item/Script not found” → 检查物品ID/脚本ID是否与配置文件中的一致，区分大小写。
-
积分兑换提示“Need X, have Y” → 用户积分不足，使用 css_addpoints 指令添加积分。
-
脚本执行无反应 → 检查脚本内容是否有错误（如指令拼写错误、延迟格式错误），可查看控制台错误信息。
6.3 数据丢失
-
原因：accounts.json 文件被删除或损坏 → 解决方案：定期备份 accounts.json，若丢失可重新创建用户账户（无法恢复已丢失的积分数据）。
七、注意事项
-
所有配置文件（JSON）修改后，需重启服务器才能生效。
-
请勿修改配置文件中的JSON格式（如括号、逗号），否则会导致插件加载失败，建议使用JSON编辑器修改。
-
脚本和兑换指令中，请勿使用非法字符，避免指令执行异常。
-
建议定期备份 accounts.json、redeem.json、scripts.json 文件，防止数据丢失或配置错误。
-
若需新增复杂指令，需确保服务器支持该指令（如 css_give、css_health 等，需依赖其他插件或CSS API支持）。
八、更新与维护
插件版本：v2.1.0，后续可根据需求更新功能，更新时直接替换插件核心文件，保留配置文件（accounts.json、redeem.json、scripts.json），避免数据丢失。
问题反馈：若使用过程中遇到bug或有功能需求，可联系作者进行修复和优化。
收藏的用户（0）
X
正在加载信息~