# 罪恶与悬赏（SinAndBounty）
适用于 LegacyScriptEngine QuickJS 的综合玩法插件，按 Calman 项目规范组织。
## 安装
1. 将整个 `SinAndBounty` 文件夹放入 BDS 的 `plugins/` 目录。
2. 启动服务器，插件会自动创建：
- `plugins/SinAndBounty/data/players`
- `plugins/SinAndBounty/data/state`
3. 玩家执行 `/sinbounty` 打开主表单，别名为 `/xsbounty`。
4. 若服务器已经运行，按照文档要求，只在现有 BDS 控制台先执行 `help`，再根据当前帮助使用 `ll load SinAndBounty` 或 `ll reload SinAndBounty`；不要在系统 Shell 中执行 BDS 命令。
## 默认配置
- 每击杀 5 名玩家奖励 2000 金币。
- 每日击杀榜前三奖励：10000 / 6000 / 3000。
- 警长报名达到 5 人立即抽取。
- 从第一人报名开始等待 30 分钟；到时即使未达到人数，也会在现有报名者中抽取。
- 罪犯分档关押：5–9 杀 10 分钟、10–14 杀 20 分钟、15 杀及以上 30 分钟。
- 默认经济：LLMoney；可在管理员表单切换为记分板 `money`。
- 警长药水效果默认全部关闭，可逐项在管理员表单中开启并设置等级。
## 主表单
### 玩家表单
所有玩家可用，包含：
- 基本信息、今日/昨日/总击杀榜（前 10 名）
- 击杀记录、犯罪记录、被击杀记录、关押记录
- 报名今日警长
- 自行开启归隐模式
- 最近七天每日榜前三与警长名单
### 警长表单
仅当天警长和管理员可用，包含：
- 木斧左键/右键框选监狱区域
- 木棍设置监狱重生点
- 删除、查看监狱
- 查看罪犯击杀数、关押次数、计划刑期和剩余时间
- 提前释放自己当天抓捕的罪犯
- 管理员可释放任意在押罪犯
### 管理员表单
仅管理员可用，包含：
- LLMoney / 记分板 `money` 切换
- 击杀奖励、每日前三奖励配置
- 警长抽取人数和等待分钟配置
- 三档关押时间配置
- 中文药水状态开关和等级配置（不显示药水粒子）
- 强制开启/关闭指定玩家归隐
- 任命多个在线警长、撤销警长
- 关押或转移指定罪犯到任意有效监狱
- 管理员永久监狱管理
- 手动补发持久化待发奖励
## 规则说明
- 击杀奖励进度按当天计算，每天 0 点归零。
- 玩家自行开启归隐后当天不能关闭；每天最多两位自行归隐玩家。管理员开启的归隐不占这两个名额。
- 每天只存在一个“报名抽取警长席位”，但管理员任命的警长数量不受限制。
- 报名抽取警长选出后，报名立即停止。
- 只有**在击杀发生前已经是罪犯**的玩家击杀警长，才触发特殊规则；普通玩家用这一杀刚好达到 5 杀成为罪犯，不会误触发。
- 特殊规则触发时：释放所有当前在押罪犯、撤销被击杀警长身份；若被击杀的是报名抽取警长，则立即重新开放报名，该玩家也可以再次报名。
- 警长普通死亡、被普通玩家击杀或环境死亡，不撤销身份。
- “释放所有罪犯”按监狱语义处理为释放所有**当前在押罪犯**；未被抓捕的通缉罪犯仍保留罪犯身份。
- 警长只能攻击罪犯；普通玩家不能与警长互相伤害；未入狱罪犯可攻击警长；入狱罪犯不能攻击警长。
- 警长抓捕罪犯时优先使用该警长自己创建且已设置重生点的监狱。没有有效监狱时，罪犯身份保留但无法完成关押。
- 罪犯刑满释放后取消罪犯身份，但当天击杀数不变；从释放时的击杀数起，再新增 5 杀才会再次成为罪犯。再次关押的刑期按当天累计击杀总数分档。
- 监狱边界每 0.5 秒检查；越界、靠近限制边缘或被其他插件传送出去时，会被拉回安全位置或监狱重生点。
- 每天 0 点：结算前三并持久化待发奖励，刷新昨日榜，清零今日状态，取消全部警长/罪犯/归隐/在押状态，删除警长创建的监狱区域；管理员监狱保留。
- 服务器跨午夜未运行时，会在下次启动补结算，并为停服期间的日期生成空榜记录，确保“昨天排行榜”对应实际昨天。
## 数据与离线奖励
- 玩家数据保存在 `KVDatabase`，不使用 `Player.setExtraData`。
- 每笔奖励先写入持久化待发队列，再调用经济接口。
- LLMoney 使用 XUID，可直接给离线玩家加钱。
- 记分板模式使用 UUID 和 `mc.addPlayerScore`，可修改离线玩家的 `money` 分数。
- 发放失败的奖励会保留并每分钟重试，也会在玩家加入和管理员点击补发时重试。
## 粒子
- 警长：`minecraft:knockback_roar_particle`
- 罪犯：默认 `minecraft:basic_smoke_particle`，生成在头部侧上方，尽量不遮挡视线。
- 粒子名称可直接编辑 `config.json` 的 `particles` 项。
## 文件
- `manifest.json`：LSE QuickJS 插件清单
- `SinAndBounty.js`：插件入口与完整逻辑
- `config.json`：默认配置
- `功能实现清单.md`：需求对应清单
- `开发与接口核对.md`：全部文档读取清单和 API 核对
- `测试报告.md`：本次构建的语法和模拟行为测试
适用于 LegacyScriptEngine QuickJS 的综合玩法插件，按 Calman 项目规范组织。
## 安装
1. 将整个 `SinAndBounty` 文件夹放入 BDS 的 `plugins/` 目录。
2. 启动服务器，插件会自动创建：
- `plugins/SinAndBounty/data/players`
- `plugins/SinAndBounty/data/state`
3. 玩家执行 `/sinbounty` 打开主表单，别名为 `/xsbounty`。
4. 若服务器已经运行，按照文档要求，只在现有 BDS 控制台先执行 `help`，再根据当前帮助使用 `ll load SinAndBounty` 或 `ll reload SinAndBounty`；不要在系统 Shell 中执行 BDS 命令。
## 默认配置
- 每击杀 5 名玩家奖励 2000 金币。
- 每日击杀榜前三奖励：10000 / 6000 / 3000。
- 警长报名达到 5 人立即抽取。
- 从第一人报名开始等待 30 分钟；到时即使未达到人数，也会在现有报名者中抽取。
- 罪犯分档关押：5–9 杀 10 分钟、10–14 杀 20 分钟、15 杀及以上 30 分钟。
- 默认经济：LLMoney；可在管理员表单切换为记分板 `money`。
- 警长药水效果默认全部关闭，可逐项在管理员表单中开启并设置等级。
## 主表单
### 玩家表单
所有玩家可用，包含：
- 基本信息、今日/昨日/总击杀榜（前 10 名）
- 击杀记录、犯罪记录、被击杀记录、关押记录
- 报名今日警长
- 自行开启归隐模式
- 最近七天每日榜前三与警长名单
### 警长表单
仅当天警长和管理员可用，包含：
- 木斧左键/右键框选监狱区域
- 木棍设置监狱重生点
- 删除、查看监狱
- 查看罪犯击杀数、关押次数、计划刑期和剩余时间
- 提前释放自己当天抓捕的罪犯
- 管理员可释放任意在押罪犯
### 管理员表单
仅管理员可用，包含：
- LLMoney / 记分板 `money` 切换
- 击杀奖励、每日前三奖励配置
- 警长抽取人数和等待分钟配置
- 三档关押时间配置
- 中文药水状态开关和等级配置（不显示药水粒子）
- 强制开启/关闭指定玩家归隐
- 任命多个在线警长、撤销警长
- 关押或转移指定罪犯到任意有效监狱
- 管理员永久监狱管理
- 手动补发持久化待发奖励
## 规则说明
- 击杀奖励进度按当天计算，每天 0 点归零。
- 玩家自行开启归隐后当天不能关闭；每天最多两位自行归隐玩家。管理员开启的归隐不占这两个名额。
- 每天只存在一个“报名抽取警长席位”，但管理员任命的警长数量不受限制。
- 报名抽取警长选出后，报名立即停止。
- 只有**在击杀发生前已经是罪犯**的玩家击杀警长，才触发特殊规则；普通玩家用这一杀刚好达到 5 杀成为罪犯，不会误触发。
- 特殊规则触发时：释放所有当前在押罪犯、撤销被击杀警长身份；若被击杀的是报名抽取警长，则立即重新开放报名，该玩家也可以再次报名。
- 警长普通死亡、被普通玩家击杀或环境死亡，不撤销身份。
- “释放所有罪犯”按监狱语义处理为释放所有**当前在押罪犯**；未被抓捕的通缉罪犯仍保留罪犯身份。
- 警长只能攻击罪犯；普通玩家不能与警长互相伤害；未入狱罪犯可攻击警长；入狱罪犯不能攻击警长。
- 警长抓捕罪犯时优先使用该警长自己创建且已设置重生点的监狱。没有有效监狱时，罪犯身份保留但无法完成关押。
- 罪犯刑满释放后取消罪犯身份，但当天击杀数不变；从释放时的击杀数起，再新增 5 杀才会再次成为罪犯。再次关押的刑期按当天累计击杀总数分档。
- 监狱边界每 0.5 秒检查；越界、靠近限制边缘或被其他插件传送出去时，会被拉回安全位置或监狱重生点。
- 每天 0 点：结算前三并持久化待发奖励，刷新昨日榜，清零今日状态，取消全部警长/罪犯/归隐/在押状态，删除警长创建的监狱区域；管理员监狱保留。
- 服务器跨午夜未运行时，会在下次启动补结算，并为停服期间的日期生成空榜记录，确保“昨天排行榜”对应实际昨天。
## 数据与离线奖励
- 玩家数据保存在 `KVDatabase`，不使用 `Player.setExtraData`。
- 每笔奖励先写入持久化待发队列，再调用经济接口。
- LLMoney 使用 XUID，可直接给离线玩家加钱。
- 记分板模式使用 UUID 和 `mc.addPlayerScore`，可修改离线玩家的 `money` 分数。
- 发放失败的奖励会保留并每分钟重试，也会在玩家加入和管理员点击补发时重试。
## 粒子
- 警长：`minecraft:knockback_roar_particle`
- 罪犯：默认 `minecraft:basic_smoke_particle`，生成在头部侧上方，尽量不遮挡视线。
- 粒子名称可直接编辑 `config.json` 的 `particles` 项。
## 文件
- `manifest.json`：LSE QuickJS 插件清单
- `SinAndBounty.js`：插件入口与完整逻辑
- `config.json`：默认配置
- `功能实现清单.md`：需求对应清单
- `开发与接口核对.md`：全部文档读取清单和 API 核对
- `测试报告.md`：本次构建的语法和模拟行为测试
