القائمة
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