忍神规则
快速开始
1. 生成角色卡模板
.sg c form- 生成角色卡模板- 别名：
.sg card template或.sg 角色 模板
2. 填表一键录卡
将模板补全后，发送：
.sg c submit
姓名：夜隐
得意分野：忍術、戦術
特技：潜伏術、手裏剣術
连通：上下、左右
空隙：1 3
备注：暗号共通
插件会自动解析繁体/简体分野与特技。
3. 查看矩阵
.sg c shw- 查看带有目标值与得意/禁用标记的特技矩阵
4. 进行检定
.sg r +1 火術或.sg 判定 暗号術- 若对应分野被禁用，该特技会按未习得处理（目标值提升至12），检定仍会执行
5. 战斗流程
- GM在群内使用
.sg b相关命令创建编组、发起战斗 - 玩家在私聊使用
.sg p上报谋位 - 检定时会自动读取谋位决定逆止阈值
顶层指令与别名
| 顶层指令 | 触发方式示例 | 中文别名/英文别名 | 功能说明 |
|---|---|---|---|
| help | .sg h / .sg help / .sg 帮助 | h, help, 帮助 | 显示插件内置帮助摘要 |
| card | .sg c ... / .sg card ... / .sg 角色 ... | c, card, 录卡, 角色, 分野, 特技, 技能 | 角色卡维护、矩阵设置、模板向导等 |
| check (默认) | .sg r 火术 / .sg roll 火术 / .sg 判定 火术 | r, chk, roll, 判定 | 特技检定。若无子命令默认走检定 |
| battle | .sg b ... / .sg battle ... / .sg 战斗 ... | b, bat, battle, 战斗 | 战斗编组、发起、阶段与特殊标记 |
| position | .sg p 3 / .sg pos 角色1 3 / .sg 谋位 ... | p, pos, position, 谋位 | 玩家上报谋位，GM批量调整谋位/备注 |
注意： 除
.sg外，命令别名还包括.rs与.忍神，三者等效。
角色卡管理
角色浏览与模板
| 指令 | 英文别名 | 中文别名 | 用法示例 | 描述 |
|---|---|---|---|---|
| show | show, shw, mat, matrix | 显示 | .sg c shw | 输出当前角色特技矩阵 |
| list | list, lst, ls, cards | 列表 | .sg c list | 列出账号下所有角色卡，★表示当前激活 |
| create | create, new, mk | 新卡, 建立 | .sg c new 夜隐 | 新建角色卡并自动切换 |
| use | use, switch, sw, select | 选择, 切换 | .sg c use 2 或 .sg 角色 切换 夜隐 | 根据序号/名称切换角色卡 |
| deleteCard | delcard, dcard, drop | 删卡 | .sg c delcard 夜隐 | 删除指定角色卡（至少保留1张） |
| renameCard | rename, rn | 改名 | .sg c rename 夜隐（改） | 重命名当前角色 |
| template | template, tpl | 模板, 表单 | .sg c form | 输出空白模板 |
| submit | submit, import | 填表, 填写, 一键录卡 | .sg c submit + 模板正文 | 解析模板并创建新卡 |
| wizard | wizard, guide | 向导, 交互 | .sg c wizard | 启动交互式录卡（逐项提问，wizard cancel取消） |
属性维护
| 操作 | 指令格式 | 英文别名 | 中文别名 | 示例 | 说明 |
|---|---|---|---|---|---|
| 设置得意分野 | .sg c set specialties … | set, specialties | 设置, 得意, 分野 | .sg c set cat 器术 体术 | 覆盖得意分野；支持繁体/模糊，如”忍術” |
| 追加得意分野 | .sg c add specialties … | add, specialties | 新增/添加 | .sg 分野 添加 忍術 | 并集追加 |
| 移除得意分野 | .sg c remove specialties … | remove, specialties | 删除/移除 | .sg c rm cat 战术 | 从列表移除 |
| 设置特技列表 | .sg c set skills … | set, skills | 设置, 特技, 技能 | .sg 特技 设置 火術 影分身 | 覆盖特技记忆 |
| 追加特技 | .sg c add skills … | add, skills | 添加 | .sg c add skl 暗号術 | 并集追加 |
| 移除特技 | .sg c remove skills … | remove, skills | 删除 | .sg 特技 移除 火术 | 移除部分特技 |
| 禁用分野列 | .sg c disable specialties … | disable, dis, off | 禁用, 禁 | .sg c dis cat 器术 | 将整列视为失去分野，相关特技会按未习得计算（目标值趋近12） |
| 启用分野列 | .sg c enable specialties … | enable, ena, on | 启用, 启 | .sg c ena cat 器术 | 解除禁用状态 |
| 设置连通 | .sg c set wrap 上下 左右 | wrap | 连通, 通 | .sg c set wrap 上下 左右 | 设定矩阵环绕（上下、左右、全部、无） |
| 设置手动空隙 | .sg c set gaps 1 3 | gaps, gap | 空隙, 隙 | .sg 角色 设置 空隙 2 4 | 明确指定列间断点；得意分野为空时生效 |
| 角色名 | .sg c set name …… | name | 姓名, 名称, 名 | .sg c set name 夜隐 | 覆盖角色名 |
| 重置角色 | .sg c reset | reset, rst, 清 | 重置, 清 | .sg 角色 重置 | 回到初始空白角色 |
特技检定
基础指令
.sg r 火术/.sg roll 忍術/.sg 判定 +1 暗号術
修正写法
+/-数字可放在指令前后- 例如：
.sg r 潜伏術-1或.sg roll +2 手裏剣術
特殊功能
- 模糊/繁体匹配： 输入”潜伏術""暗号術""体術”等都会自动映射到简体能力
- 分野校验： 若目标特技所在分野已通过disable禁用，对应分野的未习得计算
- 逆止协助： 若角色已在战斗中并处于Round阶段，自动根据谋位值调整大失败阈值
战斗管理
子命令与权限
| 子命令 | 英文/缩写 | 中文别名 | 需GM | 功能概要 |
|---|---|---|---|---|
| group | group, grp, g | 编组 | ✔️ | 编组管理 |
| start | start, sta, st | 开始 | ✔️ | 按编组生成参与者并发起战斗 |
| set | set, s | 布局, 排布 | ✔️ | GM批量设置谋位 |
| assign | assign, asn, a | 指定, 设定 | ✔️ | 复用position流程，为GM快捷分配谋位 |
| special | special, spc, sp | 备注, 标记 | ✔️ | 为参与者设置备注 |
| phase | phase, ph, phs | 阶段 | ✔️ | 更新战斗阶段（standby/round/downtime…） |
| reset | reset, rst, res | 重置 | ✔️ | 清空当前战斗数据 |
| status | status, sts, stt | 状态 | ❌ | 查看战斗状态摘要（默认子命令） |
编组操作
| 操作 | 子命令 | 别名 | 示例指令 | 说明 |
|---|---|---|---|---|
| 查看编组 | list | lst, l, 列表 | .sg b grp lst | 显示所有编组及成员 |
| 创建编组 | create | crt, cre, 创建 | .sg b group create 前卫 | 可直接@玩家或使用npc:名字添加NPC |
| 添加成员 | add | a, 新增, 加 | .sg b grp add 前卫 @甲 npc:影兵 | 添加@玩家或npc:xxx |
| 移除成员 | remove | r, rm, 移除, 减 | .sg b group remove 前卫 @甲 | 从编组移除指定成员 |
| 删除编组 | delete | del, 删除 | .sg b grp del 前卫 | 移除整个编组 |
战斗流程摘要
- 准备编组：
.sg b group create 先锋，随后add成员 - 发起战斗：
.sg b start（可附编组名称，只导入特定编组）。插件会通知参与玩家私聊上报谋位 - 收集谋位： 玩家在私聊使用
.sg p，或GM使用.sg b set、.sg p @玩家 3批量设置 - 阶段推进：
.sg b phase round进入战斗轮；检定中会自动引用谋位计算逆止阈值 - 备注/标记：
.sg b spc @玩家 中毒记录特殊状态 - 状态广播：
.sg b status查看最新汇总 - 清理： 战斗结束时
.sg b reset
谋位上报
玩家私聊
.sg p 3- 设定自身谋位.sg p 待定- 保留空位.sg p 3 note=暗号通- 顺带写备注
批量格式
.sg p 影兵=3 冥官=5 note=支援.sg p 影兵 3 冥官 5
GM指定
- 在群内或私聊对战斗参与者使用@：
.sg p @影兵 2
注意： position, pos, 谋位皆可；note=或备注=均支持
进阶特性
- 繁体/模糊匹配： 内置分类别名映射，录卡和检定均可使用”忍術""手裏剣術""暗号術""体術”等写法
- 分野禁用与目标值调整： 通过
.sg c dis cat ...禁用列后，对应特技会被视为未习得，矩阵目标值自动提升（通常为12），恢复分野后目标值亦随之回落 - 矩阵连通&手动空隙： 支持上下/左右环绕或显式空隙编号配置，满足不同流派/战场设定
- 战斗逆止自动化： 战斗阶段为round且角色已有谋位时，检定会根据谋位自动调整大失败阈值并输出来源说明
- 角色多卡管理： 同一用户可维护多张角色卡，支持切换、批量导入，且矩阵会随卡切换自动更新
工作流示例
全自动录卡
.sg c wizard → 输入姓名、得意分野、特技、连通、空隙 → 完成后 .sg c shw 检查矩阵
战斗指挥
GM：.sg b grp crt 前卫 → .sg b grp add 前卫 @甲 @乙 → .sg b start
玩家：私聊 .sg p 3，待定使用 .sg p 待定
GM：.sg b status 查看收集情况；必要时 .sg b spc @甲 中毒
处理分野损失
.sg c dis cat 器术 禁用分野 → .sg r 火术 目标值将提升至12（视为未习得） → .sg c ena cat 器术 恢复后目标值回归原数值
常见问题
Q：录卡时输入繁体导致矩阵仍为12？ A：新版已自动转写繁体；若仍遇到12，确认分野是否禁用或缺失特技记录。
Q：战斗指令提示”请先由GM发起战斗”？
A：需先在群内由GM执行 .sg b start；玩家私聊 .sg p 前必须存在战斗上下文。
Q：分野禁用后检定目标值为什么都是12？
A：禁用分野会让对应特技按未习得处理，因此矩阵自动给出12的默认目标值；使用 .sg c enable specialties <分野> 恢复后，目标值会重新依据得意/记录特技计算。