galaxy-language-fundamentals

Teach Galaxy language syntax, types, includes, and MapScript bootstrap for SC2 maps.

7|1|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/KimPlaybit/Starcraft-2-Editor-Skills --skill galaxy-language-fundamentals
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: galaxy-language-fundamentals
Source: https://github.com/KimPlaybit/Starcraft-2-Editor-Skills/tree/main/.agents/skills/galaxy-language-fundamentals
Command: npx skills add https://github.com/KimPlaybit/Starcraft-2-Editor-Skills --skill galaxy-language-fundamentals

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Galaxy scripting for StarCraft II maps is often opaque due to scattered references and unclear best practices. This skill provides a clear foundation in Galaxy language fundamentals, including syntax, type system, includes, and the MapScript bootstrap chain, to empower map developers to write robust, modular scripts.

Core Features & Use Cases

  • Clear explanations of Galaxy primitives, engine handle types, and include patterns.
  • Guidance on organizing code across MapScript.galaxy and scripts/ to support scalable map projects.
  • Reference-style guidance for debugging, best practices, and common pitfalls in SC2 scripting.

Quick Start

Review the MapScript.galaxy and scripts/main.galaxy to understand how the project initializes and where custom logic should be added.

Frequently Asked Questions about galaxy-language-fundamentals

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

FAQPage Schema
How do I structure my Galaxy script files in a StarCraft 2 map project?

Galaxy scripting for SC2 maps uses a bootstrap chain starting with MapScript.galaxy, which initializes the project and triggers subsequent script execution. Understanding this bootstrap chain is essential for properly sequencing map initialization and ensuring custom logic runs at the correct time.

What are the primitive types and engine handles available in the Galaxy scripting language?

To modularize SC2 map scripts, use include patterns to bring external Galaxy files into your main script scope. Proper use of includes keeps code organized, prevents duplicate definitions, and maintains a clean separation between core bootstrap logic and custom gameplay features.

How does the MapScript.galaxy bootstrap chain work in SC2 map scripting?

Galaxy scripting for SC2 maps requires understanding the type system, primitive types, and engine handles to manipulate game objects correctly. Map developers need this foundational knowledge to write robust scripts that properly interact with the StarCraft 2 engine.

What are common pitfalls and best practices when writing Galaxy scripts for SC2 maps?

To organize Galaxy code in an SC2 map project, separate the bootstrap initialization in MapScript.galaxy from custom features in a scripts/ directory. This modularization pattern supports scalable map development by isolating distinct gameplay systems and preventing script scope conflicts.