mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-18 10:10:45 +08:00
翻译 战斗流程协议
This commit is contained in:
Helloworld
130
docs/en/COPILOT_SCHEMA.md
Normal file
130
docs/en/COPILOT_SCHEMA.md
Normal file
@@ -0,0 +1,130 @@
|
||||
# Copilot Schema
|
||||
|
||||
Usage of `resource/copilot/*.json` and field description.
|
||||
|
||||
## Overview
|
||||
|
||||
```jsonc
|
||||
{
|
||||
"stage_name": "暴君", // Stage name, required. Name should be in Chinese except for C.C. (contingency contracts)
|
||||
"opers": [ // Operator list
|
||||
{
|
||||
"name": "棘刺", // Operator name
|
||||
|
||||
"skill": 3, // Skill ID with range [1, 3], optional, 1 by default
|
||||
|
||||
"skill_usage": 0, // Skill usage, optional, 0 by default
|
||||
// 0 - Used on `actions`
|
||||
// 1 - Used when ready (e.g. Thorns: Destreza, Myrtle: Support Beta)
|
||||
// 2 - Used when ready, only once（e.g. Mountain: Sweeping Stance）
|
||||
// 3 - Auto-decision (not implemented)
|
||||
// 0 for auto skills
|
||||
|
||||
"requirements": { // Requirements, optional, empty by default
|
||||
"elite": 2, // Elite requirement, optional, 0 by default
|
||||
"level": 90, // Level requirement, optional, 0 by default
|
||||
"skill_level": 10, // Skill level requirement, optional, 0 by default
|
||||
"module": 1, // Module requirement, optional, 0 by default
|
||||
"potentiality": 1 // Potential requirement, optional, 0 by default
|
||||
}
|
||||
},
|
||||
],
|
||||
"groups": [
|
||||
{
|
||||
"name": "任意正常群奶", // Group name, required
|
||||
// Any name is accepted as long as it matches the `name` field in `deploy` below
|
||||
|
||||
"opers": [ // Operators to be chosen randomly, similar to the `opers` field above. Operators with higher levels have higher priority.
|
||||
{
|
||||
"name": "夜莺", // Nightingale
|
||||
"skill": 3,
|
||||
"skill_usage": 2 // Skill CD may differ
|
||||
},
|
||||
{
|
||||
"name": "白面鸮", // Ptilopsis
|
||||
"skill": 2,
|
||||
"skill_usage": 2
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"actions": [ // Actions in order, required. Will be executed sequentially
|
||||
{
|
||||
"type": "部署", // Action type, optional, "Deploy" by default
|
||||
// "Deploy" | "Skill" | "Retreat" | "SpeedUp" | "BulletTime" | "SkillUsage"
|
||||
// "部署" | "技能" | "撤退" | "二倍速" | "子弹时间" | "技能用法"
|
||||
// Both English and Chinese are supported
|
||||
// "Deploy" will wait until the cost is enough (unless timeout)
|
||||
// "Skill" will wait until the skill is ready (unless timeout)
|
||||
// "SpeedUp" is switchable, i.e. after using it will become 2x speed, and using it again will make it back to normal speed
|
||||
// "BulletTime" is the 1/5 speed after clicking any operator. Proceeding with any other action will make it back to normal speed
|
||||
|
||||
"kills": 0, // Waiting until the number of kills required is reached, optional, 0 by default
|
||||
|
||||
"cost_changes": 5, // Waiting until the cost changes for the amount specified, optional, 0 by default
|
||||
// Note that it calculates since the action starts (based on the cost of the previous action)
|
||||
// Recognition is accurate when the cost is 2 digits. Not recommended for 3-digit costs.
|
||||
// TODO: Other conditions
|
||||
// TODO: "condition_type": 0, // Condition aggregation type, optional, 0 by default
|
||||
// // 0 - AND； 1 - OR
|
||||
|
||||
"name": "棘刺", // Operator/group name, required when `type` is one of "Deploy" | "Skill" | "Retreat"
|
||||
|
||||
"location": [ 5, 5 ], // Position for deployment
|
||||
// Required when `type` is "Deploy"
|
||||
// Optional when `type` is "Retreat"
|
||||
// Recommended only when multiple summons exist, retreating with location instead of name
|
||||
// Please simply use name to retreat for normal operators
|
||||
|
||||
"direction": "左", // Direction for deployment, required when `type` is "Deploy"
|
||||
// "Left" | "Right" | "Up" | "Down" | "None"
|
||||
// "左" | "右" | "上" | "下" | "无"
|
||||
// Both English and Chinese are supported
|
||||
|
||||
"skill_usage": 1, // Override skill usage settings, required when `type` is "SkillUsage"
|
||||
// E.g.: Myrtle needs to attack without using the skill at the beginning, and use the skill automatically later.
|
||||
// Set it to 1 in that case.
|
||||
|
||||
"pre_delay": 0, // Pre-delay in ms, optional, 0 by default
|
||||
"rear_delay": 0, // Post-delay in ms, optional, 0 by default
|
||||
|
||||
// "timeout": 999999999, // Reserved field, not implemented
|
||||
// Timeout time in ms, optional when `type` is "Deploy" | "Skill", INT_MAX by default
|
||||
// Will proceed with the next action when timeout
|
||||
|
||||
"doc": "下棘刺了！", // Description, optional, displayed on the UI with no effects
|
||||
"doc_color": "orange" // Description colour, optional, displayed on the UI with no effects
|
||||
},
|
||||
// Example 1
|
||||
{
|
||||
"name": "任意正常群奶",
|
||||
"location": [ 5, 6 ],
|
||||
"direction": "右"
|
||||
},
|
||||
// Example 2
|
||||
{
|
||||
"name": "史尔特尔",
|
||||
"location": [ 4, 5 ],
|
||||
"direction": "左",
|
||||
"doc": "你史尔特尔奶奶来啦！",
|
||||
"doc_color": "red"
|
||||
},
|
||||
// Example 3
|
||||
{
|
||||
"type": "二倍速"
|
||||
}
|
||||
],
|
||||
"minimum_required": "v4.0", // Minimum required MAA version, required, reserved field, not implemented
|
||||
"doc": { // Description, optional
|
||||
"title": "低练度高成功率作业",
|
||||
"title_color": "dark",
|
||||
"details": "对练度要求很低balabala……", // You can write your name here, video link, walkthrough link, etc.
|
||||
"details_color": "dark"
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
## Example
|
||||
|
||||
[Sample](../resource/copilot/test.json)
|
||||
[GA-EX8 Raid](../resource/copilot/GA-EX8-raid.json)
|
||||
Reference in New Issue
Block a user