skills.rest
MaaAssistantArknights
MaaAssistantArknightsOFFICIAL
Explore all skills by this author →
WebsiteGitHub

side-story-navigation

Adds SideStory event stage navigation tasks and activity configuration to MAA resource files.

22.9k|2.8k|Updated Jul 9, 2021
Search Tags:#OCR#Configuration#Json#arknights#game automation#maa#event navigation
One-click install
npx skills add https://github.com/MaaAssistantArknights/MaaAssistantArknights --skill side-story-navigation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: side-story-navigation
Source: https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/main/.agents/skills/side-story-navigation
Command: npx skills add https://github.com/MaaAssistantArknights/MaaAssistantArknights --skill side-story-navigation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Adding a new Arknights SideStory event to MAA requires coordinated edits across multiple JSON files (stage navigation tasks, StageActivityV2 activity config, and the MaaRelease mirror repository), each with its own ordering, OCR, and versioning rules that are easy to get wrong.

Core Features & Use Cases

  • Guided information collection: Enforces a checklist of 11 required inputs (event prefix, stage numbers, drop items, OCR text, roi coordinates, timings) before any file is modified.
  • Multi-file coordinated editing: Generates the tasks navigation file, updates local StageActivityV2 cache, and optionally syncs the MaaRelease remote source with correct ordering rules (stages ascending in tasks, descending in StageActivityV2).
  • OCR vs template matching handling: Applies OCR text splitting rules for long event names, or manages template-image workflows including MinimumRequired version bumps.
  • Use Case: When a new SideStory event launches, provide the event prefix, stage list, and drop materials, and the Skill produces all required JSON edits plus MaaRelease synchronization steps.

Quick Start

Add navigation for the new SideStory event with prefix TO, stages 7-9 plus a stage 4 rock-farming stage, and update StageActivityV2 and MaaRelease accordingly.

Frequently Asked Questions about side-story-navigation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new SideStory event navigation to MAA?▼

Create a tasks navigation file at resource/tasks/Stages/XX.json with stage entry, recognition, and chapter-selection tasks, then update StageActivityV2.json with the event entry and stage list. Optionally sync the same changes to the MaaRelease repository's api directory.

What files need to change when adding an Arknights event to MAA?▼

Three files are involved: resource/tasks/Stages/XX.json for navigation tasks, the local StageActivityV2.json cache for testing, and the MaaRelease api/gui/StageActivityV2.json as the remote source. An optional MaaRelease tasks.json overlay can also be updated.

When should I use template matching instead of OCR for chapter selection?▼

Use template matching (MatchTemplate) when the chapter name cannot be recognized by OCR, such as special fonts or icon-based labels. This requires adding a template image and bumping the MinimumRequired version in StageActivityV2.json to the next release version.

How are stage drop items configured in StageActivityV2.json?▼

Regular stages use item IDs looked up from resource/item_index.json by material name, such as 31033. Rock-farming stages use a user-provided text description directly in the Drop field without any table lookup.

What ordering rules apply to stages in MAA event configuration?▼

In the tasks navigation file, stages are ordered ascending by number with rock-farming stages placed last. In StageActivityV2.json, the Stages array is ordered descending by stage number so high-value stages appear first.

Related Skills

Explore More Software Engineering Skills→
sipherxyzsipherxyz
1

analyze-frame-from-bugitgo-request

Capture diagnostic screenshots and validate materials at BugItGo coordinates in Unreal Engine.

Official
Advanced
bitsocialnetbitsocialnet
1

release

Automate Bitsocial Web release management from commit analysis to Git tagging.

Official
Advanced
H2OSLabsH2OSLabs

neuron-validate-schema

Validate neuron-ui Page Schema JSON for structure, binding, and token compliance.

Official
Advanced
OSDeployOSDeploy
2

gitbook

Edit GitBook spaces by managing markdown files, frontmatter, and navigation.

Community
Basic