Acacia 是由剑网3 配装器开发的一个 剑网3 输出循环模拟工具，旨在提供标准化的仿真平台，使得各个心法都能轻松的作为模块载入到模拟器中，而无需修改模拟器本身的代码。
同时，Acacia 的目标是能在短时间内完成大量的循环模拟，使 DPS 在大量模拟中收敛而不受随机值的影响。从而让 DPS 硬模拟的结果更具有参考性。
可用的网页版请移步：Jx3DpsSimulator, 源码托管于 repo，目前已经停止维护。
首先，在程序中引入本项目：
const Acacia = require('jx3-simulator');定义一个 config 变量，用于规定所有的选项：
const config = {
school: 'huajian', // 指定门派心法，目前仅支持花间
duration: 86400, // 指定单次模拟的时间，单位为秒
iterator: 2, // 指定循环次数
target: 97, // 指定目标等级
self: { // 指定自身属性
basicAttack: 2748, // 基础攻击
spunk: 706, // 元气
crit: 15.15, // 会心率
critEff: 211.77, // 会心效果率
hit: 106.76, // 命中率
haste: 321, // 加速等级
strain: 20.09, // 无双率
overcome: 900, // 破防等级
delay: 100, // 延迟
},
effects: { // 指定特效选项
cw: 0, // 橙武
water: 0, // 水特效
thunder: 0, // 雷特效
setEffect: [], // 套装特效
},
talent: [0, 0, 1, 2, 0, 2, 3, 0, 0, 0, 0, 0], // 奇穴选项
recipes: { // 秘籍选项
yangMing: [0, 1, 6, 7],
shangYang: [3, 4, 5, 6],
lanCui: [0, 1, 2, 6],
zhongLin: [0, 1, 2, 5],
kuaiXue: [0, 1, 2, 3],
},
};将选项传入构造函数中，并执行 run 方法开始模拟。
const acacia = new Acacia(config);
acacia.run().then((info) => {
console.log(info.dps); // 输出模拟得到的 DPS
console.log(info.results); // 对于多次模拟，会额外返回一个结果集
});- config 定义了模拟所需要的参数
- config.school
string表示模拟的心法名称，以心法的前两个字的全拼为名。目前 Acacia 仅支持 huajian (花间游)。 - config.duration
number表示单次模拟的时常，单位为秒。默认 300 秒。 - config.iterator
number表示模拟的次数，默认 5 次。 - config.target
number表示模拟所针对的目标，目前的取值为木桩等级，默认 98 级木桩。 - config.self
object表示模拟时角色自身的属性，该属性不应该包含任何可以由自身触发的战斗增益属性。例如花间不应该将梦歌或清流的属性加入，但可以加入破苍穹的属性。- config.self.basicAttack
number角色基础攻击。 - config.self.spunk
number角色基础属性·元气 (四选一)。 - config.self.spirit
number角色基础属性·根骨 (四选一)。 - config.self.strength
number角色基础属性·力道 (四选一)。 - config.self.agility
number角色基础属性·身法 (四选一)。 - config.self.crit
number角色会心率。 - config.self.critEff
number角色会心效果率。 - config.self.hit
number角色命中率。 - config.self.haste
number角色加速等级。 - config.self.strain
number角色无双率。 - config.self.overcome
number角色破防等级。 - config.self.delay
number角色平均延迟水平。
- config.self.basicAttack
- config.effects
object表示角色身上装备所带有的特效- config.effects.cw
number0 表示没有橙武，1 表示小橙武，2 表示大橙武。 - config.effects.water
string水系特效，取值为水系的特效名称，没有特效用 0 表示。 - config.effects.thunder
string雷系特效，取值为雷系的特效名称，没有特效用 0 表示。 - config.effects.setEffect
array套装特效，元素为套装特效名称，类型为string。
- config.effects.cw
- config.talent
array表示角色所选取的奇穴，数组长度为 12，按顺序表明第几层奇穴的第几个奇穴被激活。例如，[0, 0, 1, ...]表示第一、二层的第一个奇穴被激活，第三层的第二个奇穴被激活。 - config.recipes 'object' 表示角色所选取的秘籍。该对象与各心法有关，详情查阅对应心法的文档。
- config.school
以下示例代码中，ctrl 为一个控制器实例。
向控制器自身 Buff 列表中添加一个 Buff，该 Buff 在游戏中应该出现在角色自己身上。该方法的参数为一个 Buff 对象。该方法可用于刷新一个自身 Buff，并增加层数（如果没有到达最大层数）。
// 阳明指命中后添加一层恣游buff
const ziyou = ctrl.getBuff('恣游');
ctrl.addBuff(ziyou);向控制器目标 Buff 列表中添加一个 Buff，该 Buff 在游戏中应该出现在目标身上。该方法的参数为一个 Buff 对象。该方法可用于刷新一个目标 Buff，并增加层数（如果没有到达最大层数）。dot 的刷新需要使用 dotRefresh 方法
// 添加噬骨
const shigu = ctrl.getBuff('噬骨');
ctrl.addDebuff(shigu);从控制器自身 Buff 列表中移除一个 Buff，参数为 Buff 的名称。
// 流离奇穴使兰摧不需运功
ctrl.deleteBuff('流离');从控制器目标 Buff 列表中移除一个 Buff，参数为 Buff 的名称。如果该 Buff 为持续伤害技能，该方法目前不会自动计算其伤害。
// 玉石俱焚吞噬 dot
ctrl.deleteDebuff('商阳指');
ctrl.deleteDebuff('钟林毓秀');
ctrl.deleteDebuff('兰摧玉折');刷新一个 dot。
if (ctrl.isTalentActive('轻弃')) {
ctrl.dotRefresh('商阳指');
ctrl.dotRefresh('兰摧玉折');
ctrl.dotRefresh('钟林毓秀');
}获得一个正在角色自身身上生效的 Buff 的状态。如果该 Buff 存在，则返回这个 Buff 本身，反之则返回 false。
const fenYu = ctrl.getActiveBuff('焚玉');
const remainTime = fenyu.remain; // 获取焚玉剩余时间获得一个正在目标身上生效的 Buff 的状态。如果该 Buff 存在，则返回这个 Buff 本身，反之则返回 false。
const shangYang = ctrl.getActiveDebuff('商阳指');
const remainTime = shangYang.remain; // 获取商阳指剩余时间从技能库中获取一个 Buff 对象。如果该 Buff 存在，则返回这个 Buff 本身，反之则返回 false。该方法会获得一个全新的 Buff，可用于前述的 addBuff 和 addDebuff 方法。如需要获取正在生效的 Buff 状态，需要使用 getActiveBuff 和 getActiveDebuff 方法。
// 阳明指命中后添加一层恣游buff
const ziyou = ctrl.getBuff('恣游');
ctrl.addBuff(ziyou);获取一个技能的状态。如果该技能存在，则返回这个技能本身，反之则返回 false。该方法可用于获取技能的 CD，状态，并对其进行修改以达到重置技能 CD，或改变其能力的功能。
const yushi = ctrl.getSkill('玉石俱焚');
yushi.cdRemain = 0; // 重置玉石俱焚CD查看自身是否存在某个 Buff。
// 乱洒添加DOT
if(ctrl.hasBuff('乱洒青荷')){
const zhonglin = ctrl.getBuff('钟林毓秀');
ctrl.addDebuff(zhonglin);
}查看目标是否存在某个 Buff。
// 青冠奇穴
if (ctrl.hasDebuff('商阳指')){
// 提高阳明指伤害
};查看某个奇穴是否被激活。激活则返回 true。
// 梦歌奇穴
if (ctrl.isTalentActive('梦歌')) {
const mengGe = ctrl.getBuff('梦歌');
ctrl.addBuff(mengGe);
}对于一个心法，应当构建其技能库以供模拟器使用。
一个技能的数据应包含以下信息：
{
icon: 1514, // 技能图标 id，供浏览器环境使用
name: '商阳指', // 技能名称
type: 'instant', // 技能类别，取值可以是 ['instant', 'channel', 'ota'] ， 分别代表瞬发技能，通道技能和读条技能
cof: 0.27, // 技能系数，技能伤害与攻击力的比例关系
min: 50, // 技能最小伤害，0 攻击情况下技能所产生的最小伤害，可在游戏中技能描述里查询
max: 50, // 技能最大伤害，0 攻击情况下技能所产生的最大伤害。
ota: 0, // 读条时间（帧）
damageInstant: false, // 立即伤害技能，技能是否会立即产生伤害。
cd: 0, // CD 时间（帧）
interval: 0, // 通道技能间隔时间（帧）
target: true, // 要求目标
hasRecipes: true, // 存在秘籍
recipeName: 'shangYang',// 秘籍名称（与秘籍文件中定义的一致）
cdRemain: 0, // 剩余 CD，初始化填 0
gcdCast: false, // 是否可以无视公共调息时间
onSkillHitEvent(ctrl) { // 技能命中事件，将在技能命中后触发
// 添加商阳指dot
const shangYang = ctrl.getBuff('商阳指');
shangYang.applyRecipe(ctrl);
// 生息奇穴：混元性持续伤害提高10%，持续伤害效果被卸除后，每个持续伤害使目标1.5秒内无法受到治疗效果，最多叠加4.5秒。
if (ctrl.isTalentActive('生息')) {
shangYang.extraAttr.damage += 10;
}
ctrl.addDebuff(shangYang);
},
onSkillCritEvent(ctrl) { // 技能会心事件，将在技能会心后触发
this.onSkillHitEvent(ctrl);
},
onSkillPrepare(ctrl) { // 技能准备事件，在技能释放前触发，返回 false 则取消技能。
// 寒血奇穴：“施展“商阳指”立刻造成伤害
if (ctrl.isTalentActive('寒血')) {
this.damageInstant = true;
}
},
onSkillFinish(ctrl) { // 技能完成事件，在技能完成后触发。
},
}对象的所有属性可以通过 this 来调用和更改。也可以在其他地方通过 ctrl.getSkill(技能名) 方法获得技能后进行更改。
例如，上面的例子中，在 onSkillPrepare 事件中，通过调用 this.damageInstant = true 来使技能伤害立即生效。
对于一个心法，应当构建其增益与减益效果（Buff）库以供模拟器使用。
一个 Buff 的数据应包含以下信息：
{
icon: 3406, // Buff 的技能图标，供浏览器环境使用
name: '雷·激流', // Buff 的名称
desc: '提高自身内功基础攻击和全会心等级，持续15秒', // Buff 的效果描述
type: 'buff', // Buff 的类别，取值为 ['buff', 'dot']，分别代表普通 Buff 和持续伤害效果
conflict: 1, // Buff 的冲突 ID，多个效果之间可能存在冲突，可以为它们规定一个非 0 的冲突 ID， 这样在添加 Buff 的时候，控制器会自动清除之前已经添加的拥有相同冲突 ID 的 Buff。
duration: 240, // Buff 的持续时间
interval: 0, // Dot 的间隔生效时间
cof: 0, // Dot 的技能伤害系数
maxLevel: 1, // Buff 的最大可叠加层数
min: 0, // Dot 最小伤害
max: 0, // Dot 最大伤害
data: { // Buff 所产生的额外属性效果
attackAddBase: 94,
critAddBase: 48,
},
recipeName: 'none', // 可应用的秘籍名称
onSkillHitEvent(ctrl) { // Dot 命中时所触发的技能效果
},
onSkillCritEvent(ctrl) { // Dot 会心时所触发的技能效果
},
},Buff 数据会被控制器转化为 Buff 对象。对象中的所有数据均可以通过 this 来调用和更改。也可以在其他地方通过 ctrl.getBuff(Buff 名) 方法获得 Buff 后进行更改。通过该方法获得的 Buff 为初始状态，并具有一个额外的属性 level: 1 表示初始层数。
例如，夜思奇穴可以使“水月无间”叠加 2 层，可通过以下方法实现：
const shuiYue = ctrl.getBuff('水月无间');
// 夜思奇穴：“水月无间”额外使1个招式无需运功，并立刻回复自身10%内力值。
if (ctrl.isTalentActive('夜思')) {
shuiYue.canStack = true;
shuiYue.maxLevel = 2;
shuiYue.level = 2;
}欢迎 PR。 目前项目主要希望在性能优化上取得进展，以达到更快速的进行模拟的期望。 同时也欢迎扩展其支持其他门派。
请查看 LICENSE 文件。