메뉴
Where to place game content vs platform code. Use when creating new files or moving existing code.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
GDScript coding standards for The Sparkling Farce. Use when writing or reviewing code for style compliance.
Run the project test suite. Use when user mentions "diagnostics", "run level 1 diagnostics", or asks to run tests.
Core development philosophy - fix platform code, not mod content. Load when making decisions about what to fix or implement.
Correct patterns for accessing game resources via ModLoader registry. Use when loading characters, items, abilities, or any mod content.
View the newest screenshot(s) from the user's Screenshots folder. Use when user says SNS, SNS2, SNS3, or asks to see a screenshot.
Reference for preferred UNIX tools over LLM processing. Use when processing JSON, text, searching files, or doing batch operations.
| name | content-placement |
| description | Where to place game content vs platform code. Use when creating new files or moving existing code. |
The Sparkling Farce separates platform code from game content. This is fundamental to the mod system.
Game content NEVER goes in
core/. The base game is just a mod.
sparklingfarce/
├── core/ # Platform code ONLY
│ ├── systems/ # Autoload singletons
│ ├── resources/ # Resource class definitions
│ ├── components/ # Reusable node components
│ ├── registries/ # Type registries
│ ├── mod_system/ # ModLoader, ModRegistry
│ └── utils/ # Utility functions
│
├── mods/ # ALL game content
│ ├── demo_campaign/ # Demo content (priority 100)
│ │ ├── mod.json
│ │ ├── data/
│ │ │ ├── characters/
│ │ │ ├── items/
│ │ │ ├── abilities/
│ │ │ ├── battles/
│ │ │ └── ...
│ │ ├── maps/
│ │ ├── cinematics/
│ │ └── assets/
│ │
│ ├── _platform_defaults/ # Core fallbacks (priority -1)
│ └── _starter_kit/ # Development assets
│
└── scenes/ # UI scenes, battle scenes, etc.
| Content Type | Location | Example |
|---|---|---|
| Character definitions | mods/*/data/characters/ | max.tres, sarah.tres |
| Item definitions | mods/*/data/items/ | wooden_sword.tres |
| Ability definitions | mods/*/data/abilities/ | fireball.tres |
| Battle configurations | mods/*/data/battles/ | intro_battle.tres |
| Map metadata | mods/*/data/maps/ | hometown.tres |
| Dialogue | mods/*/data/dialogues/ | intro_dialogue.tres |
| Cinematics | mods/*/cinematics/ | opening.json |
| Character sprites | mods/*/assets/characters/ | max.png |
| Tilesets | mods/*/tilesets/ | forest.tres |
| Audio | mods/*/audio/ | battle_theme.ogg |
core/| Content Type | Location | Example |
|---|---|---|
| Resource class scripts | core/resources/ | character_data.gd |
| Manager singletons | core/systems/ | battle_manager.gd |
| Reusable components | core/components/ | unit.gd |
| Type registries | core/registries/ | equipment_registry.gd |
| Utility functions | core/utils/ | dict_utils.gd |
| Priority Range | Use For |
|---|---|
| -1 to -100 | Platform defaults (fallbacks) |
| 0 to 99 | Official content |
| 100 to 8999 | User mods |
| 9000+ | Total conversions |
Higher priority mods override lower priority ones for the same resource ID.
mods/demo_campaign/data/characters/mods/demo_campaign/data/items/core/resources/ (class definition only)core/systems/scenes/ui/components/Use mods/_sandbox/ for experimental content that shouldn't ship:
mods/_sandbox/
├── mod.json # priority: 9999 (loads last, overrides everything)
└── data/
└── characters/
└── test_hero.tres