Skip to content

Commit

Permalink
release v0.2.0
Browse files Browse the repository at this point in the history
  • Loading branch information
MintCider committed Nov 2, 2024
1 parent 3a1d53a commit 3f8b106
Show file tree
Hide file tree
Showing 8 changed files with 367 additions and 220 deletions.
124 changes: 80 additions & 44 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# 最终物语规则插件

> [!WARNING]
> 由于大量术语发生变动,导致人物卡的数据存储格式改变,从 `v0.2.0` 之前版本升级而来的话,会出现数据不匹配。可以通过 `.st clr` 清空旧人物卡属性,参考最新术语翻译,重新创建人物卡。
## 介绍

本插件工作于 [海豹骰点核心](https://github.com/sealdice/sealdice-core),并基于其 [TS 模板库](https://github.com/sealdice/sealdice-js-ext-template) 实现。
Expand All @@ -23,33 +26,33 @@

`.st` 命令的使用方式请参考 [海豹手册相关内容](https://docs.sealdice.com/use/coc7.html#st-%E6%93%8D%E4%BD%9C%E4%BA%BA%E7%89%A9%E5%8D%A1),这里着重介绍最终物语规则相关的人物卡属性。

| 属性名 | 属性别名 |
|---------|-------------------------------------|
| 生命值 | hp、hit point、hit points |
| 生命值上限 | hpmax |
| 精神值 | mp、mental point、mental points |
| 精神值上限 | mpmax |
| 库存点 | ip、inventory point、inventory points |
| 库存点上限 | ipmax |
| 物语点 | fp、fabula point、fabula points |
| 泽尼特 | z、zenit |
| 先攻修正值 | im、initiative modifier |
| 物防 | pd、df、defense、物理防御 |
| 魔防 | md、magical defense、魔法防御 |
| 灵巧骰面初始值 | dex、dexterity、灵巧 |
| 洞察骰面初始值 | ins、insight、洞察 |
| 力量骰面初始值 | mig、might、力量 |
| 意志骰面初始值 | wlp、willpower、意志 |

在初始化人物卡时,可以使用任意属性别名进行属性设定,插件会自动将其转化为对应的属性。
| 属性名 | 默认属性别名 |
|----------------|---------------------------------------|
| 生命值 | hp、hit point、hit points |
| 生命值上限 | hpmax |
| 精神值 | mp、mental point、mental points |
| 精神值上限 | mpmax |
| 物资点 | ip、inventory point、inventory points |
| 物资点上限 | ipmax |
| 物语点 | fp、fabula point、fabula points |
| 金币 | z、zenit |
| 先攻修改值 | im、initiative modifier |
| 物防 | pd、df、defense、物理防御 |
| 魔防 | md、magical defense、魔法防御 |
| 敏捷骰面初始值 | dex、dexterity、敏捷 |
| 感知骰面初始值 | ins、insight、感知 |
| 力量骰面初始值 | mig、might、力量 |
| 意志骰面初始值 | wlp、willpower、意志 |

在初始化人物卡时,可以使用任意属性别名进行属性设定,插件会自动将其转化为对应的属性。如果需要修改属性别名(例如,在设置属性或检定时,使用「灵巧」代替「敏捷」),请参考后文的配置项。

> [!NOTE]
> 设定灵巧、洞察、力量、意志四维属性时,请输入对应属性骰的面数(6、8、10、12 之一)。当属性骰发生变动时(如状态效果、临时 buff 等),请不要使用 `.st` 修改,请参考后面的 `.buff``.ds` 命令。
> 设定敏捷、感知、力量、意志四维属性时,请输入对应属性骰的面数(6、8、10、12 之一)。当属性骰发生变动时(如状态效果、临时 buff 等),请不要使用 `.st` 修改,请参考后面的 `.buff``.ds` 命令。
以下两个例子都是合理的属性设定方式:

```text
.st 卡珊德拉-灵巧10 洞察6 力量8 意志8 生命值50 生命值上限50 精神值50 精神值上限50 库存点6 库存点上限6 物语点3 泽尼特170 先攻修正值-2 物防11 魔防8
.st 卡珊德拉-敏捷10 感知6 力量8 意志8 生命值50 生命值上限50 精神值50 精神值上限50 物资点6 物资点上限6 物语点3 金币170 先攻-2 物防11 魔防8
```

```text
Expand All @@ -58,28 +61,29 @@

### `.sn` 自动群名片

`.sn` 命令的使用方式请参考 [海豹手册相关内容](https://docs.sealdice.com/use/log.html#sn-%E8%87%AA%E5%8A%A8%E7%BE%A4%E5%90%8D%E7%89%87)这里着重介绍最终物语规则提供的两个群名片预设模版
`.sn` 命令的使用方式请参考 [海豹手册相关内容](https://docs.sealdice.com/use/log.html#sn-%E8%87%AA%E5%8A%A8%E7%BE%A4%E5%90%8D%E7%89%87)这里着重介绍最终物语规则提供的三个群名片预设模版

- `.sn fu``角色名 HP50/50 MP50/50 IP6/6 FP3 Z170 PD11 MD8`
- `.sn fuS``角色名 HP50/50 MP50/50 PD11 MD8`
- `.sn fuD``角色名 HP50/50 MP50/50 D6 I10 M6 W10`

### `.rc` 检定

`.rc <属性 1>+<属性 2>+<修正值>`

支持的属性为:灵巧、洞察、力量、意志dex、ins、mig、wlp,不区分大小写。
此命令支持的属性为:敏捷、感知、力量、意志,以及任何对应四维属性的属性别名(例如:dex、ins、mig、wlp,不区分大小写。属性别名参见上文表格,如需修改属性别名,请参考后文的配置项

支持的修正值为:整数。

例子:

```text
.rc 灵巧+洞察+1
.rc 敏捷+感知+1
.rc mig+wlp-2
```

```text
<卡珊德拉>的灵巧+洞察+1检定结果为:d8(缓慢)+d6+1=[4+6+1]=11
<卡珊德拉>的敏捷+感知+1检定结果为:d8(迟缓)+d6+1=[4+6+1]=11
HR:6
```

Expand All @@ -89,7 +93,7 @@ HR:6

`.ri [修正值]`

自动进行一次「灵巧+洞察+先攻修正值」的检定,可以额外附加一个整数修正值。
自动进行一次「敏捷+感知+先攻修改值」的检定,可以额外附加一个整数修正值。

例子:

Expand All @@ -99,12 +103,12 @@ HR:6
```

```text
<卡珊德拉>的先攻检定结果为:d8(缓慢)+d6+0(先攻修正)+3=[7+3+0+3]=13
<卡珊德拉>的先攻检定结果为:d8(迟缓)+d6+0(先攻修改)+3=[7+3+0+3]=13
```

### `.buff` 状态效果

此命令支持的状态效果为:缓慢、眩晕、虚弱、动摇、愤怒、中毒。
此命令支持的状态效果为:迟缓、眩晕、虚弱、动摇、激怒、中毒。

#### 切换状态效果

Expand All @@ -126,7 +130,7 @@ HR:6

### `.ds` 临时调整属性骰

此命令支持的属性为:灵巧、洞察、力量、意志dex、ins、mig、wlp,不区分大小写。
此命令支持的属性为:敏捷、感知、力量、意志,以及任何对应四维属性的属性别名(例如:dex、ins、mig、wlp,不区分大小写。属性别名参见上文表格,如需修改属性别名,请参考后文的配置项

此命令支持的调整值为:整数。

Expand All @@ -151,65 +155,71 @@ HR:6
> 此命令与状态效果产生的影响叠加计算,并且永远不会超出属性骰的上下限。
```text
.buff 缓慢
.buff 迟缓
.ds 力量+1
.ds dex-1
.rc dex+mig
```

```text
<卡珊德拉>的灵巧+力量检定结果为:d6(缓慢、ds-1)+d10(ds+1)=[3+9]=12
<卡珊德拉>的敏捷+力量检定结果为:d6(迟缓、ds-1)+d10(ds+1)=[3+9]=12
HR:9
```

### `.bond` 牵绊
### `.eval` 属性骰核算

如上文所述,属性骰发生变动时(如状态效果、临时 buff 等),不应使用 `.st` 修改,而应该使用 `.buff``.ds` 命令。但如果出于游戏需要,使用 `.st` 命令修改了属性骰的原始值,则需要使用 `.eval` 命令,根据状态效果、临时 buff 等,重新核算属性骰。

如果发现属性骰数值不符合预期,可以尝试使用该指令进行核算。

### `.bond` 羁绊

> [!NOTE]
> 目前,牵绊仅作为辅助记录,不会对检定产生影响。
> 目前,羁绊仅作为辅助记录,不会对检定产生影响。
此命令支持的情感为:赞赏、自卑、忠诚、怀疑、喜爱、仇恨
此命令支持的情感为:钦佩、自卑、忠诚、猜忌、喜爱、憎恨

#### 建立牵绊
#### 建立羁绊

`.bond add <名字> <情感>`

#### 遗忘牵绊
#### 遗忘羁绊

`.bond del <编号>/<名字>`

`.bond clr`

后者会遗忘全部牵绊
后者会遗忘全部羁绊

#### 调整牵绊情感
#### 调整羁绊情感

`.bond emo add <编号>/<名字> <情感>`

`.bond emo del <编号>/<名字> <情感>`

#### 查看所有牵绊
#### 查看所有羁绊

`.bond list`

#### 例子

```text
.bond add 布莱尔 赞赏
.bond add 布莱尔 钦佩
```

```text
.bond emo add 1 喜爱
<卡珊德拉>与<布莱尔>的牵绊增加了喜爱情感
<卡珊德拉>与<布莱尔>的羁绊增加了喜爱情感
```

```text
.bond emo add 1 仇恨
<卡珊德拉>与<布莱尔>的牵绊已有喜爱情感,不能再增加仇恨情感
.bond emo add 1 憎恨
<卡珊德拉>与<布莱尔>的羁绊已有喜爱情感,不能再增加憎恨情感
```

```text
.bond emo del 布莱尔 喜爱
<卡珊德拉>与<布莱尔>的牵绊不再有喜爱情感
<卡珊德拉>与<布莱尔>的羁绊不再有喜爱情感
```

### `.clk` 命刻
Expand All @@ -236,3 +246,29 @@ HR:9

#### 查看群内全部命刻
`.clk list`

## 配置项

`v0.2.0` 版本开始,插件支持通过配置项自定义属性别名。每个配置项是一个 [JSON](https://www.runoob.com/json/json-tutorial.html) 数组,需要添加属性别名时,将其加入数组,然后**保存配置项并重载插件**即可。

> [!NOTE]
> 填写 JSON 格式时,务必注意全角半角符号(使用英文符号)。
> [!NOTE]
> 保存配置项后必须重载插件,否则修改不会生效。
例如,「敏捷」属性的默认别名为:

```json
// 敏捷骰面初始值别名
["dex", "dexterity", "敏捷"]
```

如果想要使用「灵巧」代替「敏捷」这一名称,可将其修改为:

```json
// 敏捷骰面初始值别名
["dex", "dexterity", "敏捷", "灵巧"]
```

随后,**保存配置项**,并**重载插件**,即可在使用 `.st``.rc``.ds` 指令时,使用「灵巧」替代「敏捷」。
15 changes: 15 additions & 0 deletions docs/release_notes/v0.2.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
## ⚠️注意⚠️

由于大量术语发生变动,导致人物卡的数据存储格式改变,从 `v0.2.0` 之前版本升级而来的话,会出现数据不匹配。可以通过 `.st clr` 清空旧人物卡属性,参考最新术语翻译,重新创建人物卡。

## 功能

- 参考官方中文《快速开始》(Ver.0.11030),修改大量术语。
- 增加 `.eval` 命令用于重新核算属性骰(详见 README)。
- 增加配置项,允许修改属性别名,例如使用「灵巧」代替「敏捷」。**修改后必须重载插件!**(详见 README)。
- 增加自动群名片模版 `fuD`,示例:`角色名 HP50/50 MP50/50 D6 I10 M6 W10`

## 修复

- 修复了从 DND 规则(`.set dnd`)切换到 FU 规则(`.set fu`)时,`.st` 出错的问题。
- 修复了自动群名片(`.sn fu/fuS`)中,物防显示不正确的问题。
29 changes: 13 additions & 16 deletions header.txt
Original file line number Diff line number Diff line change
@@ -1,31 +1,28 @@
// ==UserScript==
// @name 最终物语规则
// @author Mint Cider
// @version 0.1.1
// @version 0.2.0
// @description 为海豹添加最终物语规则。详细使用说明见项目主页 README。
// @timestamp 1728458200
// @timestamp 1730568900
// @license MIT
// @homepageURL https://github.com/MintCider/seal-fu
// @updateUrl https://github.com/MintCider/seal-fu/releases/latest/download/seal-fu.js
// @sealVersion >=1.2.0-0
// ==/UserScript==

// # v0.1.1 更新日志
// # v0.2.0 更新日志
// ## ⚠️注意⚠️
//
// ## 功能
//
// - 增加 `.fu` 命令用于总览最终物语相关指令。
//
// # v0.1.0 更新日志
// 由于大量术语发生变动,导致人物卡的数据存储格式改变,从 `v0.2.0` 之前版本升级而来的话,会出现数据不匹配。可以通过 `.st clr` 清空旧人物卡属性,参考最新术语翻译,重新创建人物卡。
//
// ## 功能
//
// - 适配海豹核心 `.st` 命令,可以通过 `.st` 设定人物卡属性。
// - 增加 `.rc` 命令用于检定掷骰。
// - 增加 `.ri` 命令用于先攻掷骰。
// - 增加 `.buff` 命令用于附加状态效果。
// - 增加 `.ds` 命令用于临时修改属性骰大小。
// - 增加 `.bond` 命令用于记录牵绊。
// - 增加 `.clk` 命令用于记录命刻。
// - 参考官方中文《快速开始》(Ver.0.11030),修改大量术语。
// - 增加 `.eval` 命令用于重新核算属性骰(详见 README)。
// - 增加配置项,允许修改属性别名,例如使用「灵巧」代替「敏捷」。**修改后必须重载插件!**(详见 README)。
// - 增加自动群名片模版 `fuD`,示例:`角色名 HP50/50 MP50/50 D6 I10 M6 W10`
//
// ## 修复
//
// 请参考 README 或帮助文本(`.<command> help`)使用以上命令。
// - 修复了从 DND 规则(`.set dnd`)切换到 FU 规则(`.set fu`)时,`.st` 出错的问题。
// - 修复了自动群名片(`.sn fu/fuS`)中,物防显示不正确的问题。
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "seal-fu",
"version": "0.1.1",
"version": "0.2.0",
"repository": "https://github.com/MintCider/seal-fu",
"license": "MIT",
"scripts": {
Expand Down
Loading

0 comments on commit 3f8b106

Please sign in to comment.