8/17/25About 3 min
Stationary Security Service Schema
Tips
Please note that JSON files do not support comments. The comments in this document are for demonstration purposes only. Do not copy them directly into your JSON files.
{
"type": "SSS", // Protocol type, SSS indicates Stationary Security Service, required, cannot be modified
"stage_name": "多索雷斯在建地块", // Map name, required ("多索雷斯在建地块" = "Dossoles Under Construction")
"minimum_required": "v4.9.0", // Minimum required MAA version, required
"doc": {
// Description, optional
"title": "低练度高成功率作业", // ("低练度高成功率作业" = "Low-investment high-success rate operation")
"title_color": "dark",
"details": "对练度要求很低balabala……", // Recommend adding your name (author), reference video links, etc. here ("对练度要求很低balabala……" = "Very low level requirements etc...")
"details_color": "dark"
},
"buff": "自适应补给元件", // Starting navigation element selection, optional ("自适应补给元件" = "Adaptive Supply Component")
"equipment": [
// Starting equipment selection, read horizontally, optional
// Not implemented in current version, only displayed in interface
"A",
"A",
"A",
"A",
"B",
"B",
"B",
"B"
],
"strategy": "优选策略", // Or "自由策略" ("Free strategy"), optional
// Not implemented in current version, only displayed in interface
"opers": [
// Specified operators, optional
{
"name": "棘刺", // ("棘刺" = "Thorns")
"skill": 3,
"skill_usage": 1
}
],
"tool_men": {
// Remaining required operators by profession, picked by cost, optional
// Not implemented in current version, only displayed in interface
"Pioneer": 13,
"近卫": 2, // Both Chinese and English supported ("近卫" = "Guard")
"Medic": 2
},
"drops": [
// Recruitment priority for operators and equipment at battle start and during battle
"空弦", // ("空弦" = "Archetto")
"能天使", // Supports operator names, class names ("能天使" = "Exusiai")
"先锋", // Class names in Chinese or English ("先锋" = "Vanguard")
"Support",
"无需增调干员", // Don't recruit anyone ("无需增调干员" = "No recruitment needed")
"重整导能组件", // Supports equipment names ("重整导能组件" = "Reorganization Navigation Component")
"反制导能组件", // ("反制导能组件" = "Counter Navigation Component")
"战备激活阀", // In-stage optional equipment, also listed here ("战备激活阀" = "Combat Preparation Actuator")
"改派发讯器" // ("改派发讯器" = "Modified Device Signal")
],
"blacklist": [
// Blacklist, optional. These won't be selected in drops.
// In future versions with squad formation, these won't be selected as tool operators either
"夜半", // ("夜半" = "Nightingale")
"梅尔" // ("梅尔" = "Mayer")
],
"stages": [
{
"stage_name": "蜂拥而上", // Single stage name, required ("蜂拥而上" = "Swarming Advance")
// Supports name, stageId, levelId; recommend stageId or levelId
// Don't use code (e.g., LT-1) as it conflicts with other SSS stages
"strategies": [
// Required
// Each check processes from top to bottom in sequence, skipping completed strategies
// If current strategy's tool operators are fully deployed:
// If no core, consider strategy complete
// If core exists and can be deployed, deploy core and consider strategy complete
// If core is converting DP, wait and skip subsequent strategies
// If current strategy's tool operators aren't fully deployed:
// If deployment area has no required tool operators, check next strategy
// If deployment area has required tool operators:
// If none can be deployed immediately, wait
// If some can be deployed immediately, prioritize lower cost ones
// For strategies at same location:
// If no core, allows checking subsequent strategies at same location when needed tool operators unavailable
// If core exists, ignores subsequent strategies at same location until current one completes
// Multiple core operators can be written for same location; non-last core operators act as passthrough after strategy completes
{
"core": "棘刺", // ("棘刺" = "Thorns")
"tool_men": {
"Pioneer": 1, // Both Chinese and English supported
"Warrior": 1,
"Medic": 1
},
"location": [
10,
1
],
"direction": "Left"
},
{
"core": "泥岩", // ("泥岩" = "Mudrock")
"tool_men": {
"Pioneer": 1,
"Warrior": 1,
"Medic": 1
},
"location": [
2,
8
],
"direction": "Left"
},
{
// No core field, can be used to deploy auxiliary passthrough operators
"tool_men": {
"Support": 100
},
"location": [
2,
8
],
"direction": "Left"
}
],
"draw_as_possible": true, // "Deploy Operator" button, whether to use when ready, optional, default true
"actions": [
// Optional
// Reuses copywriting logic, refer to protocol/copilot-schema.md
// Executes action when conditions met, otherwise executes strategies logic above
{
"type": "调配干员" // New type, "Deploy Operator" button, clicks once, ineffective when "draw_as_possible" is true ("调配干员" = "Deploy Operator")
},
{
"type": "CheckIfStartOver", // New type, checks if operator is present, exits and restarts if not
"name": "棘刺" // ("棘刺" = "Thorns")
},
{
"name": "桃金娘", // ("桃金娘" = "Myrtle")
"location": [
4,
5
],
"direction": "左" // ("左" = "Left")
},
{
"kills": 10,
"type": "撤退", // ("撤退" = "Retreat")
"name": "桃金娘" // ("桃金娘" = "Myrtle")
}
],
"retry_times": 3 // Battle failure retry count, abandons entire run if exceeded
},
{
"stage_name": "见者有份" // ("见者有份" = "Share the Spoils")
// ...
}
// Write as many stages as you want to play, e.g., if only up to stage 4 is written, automatically restarts after completing stage 4
]
}Example Files
https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/