summerengine/summer/art-direction

/art-direction — Define the Visual Style

Overview

A consistent art direction makes a low-budget game look finished. Solo developers most often lose it by mixing styles — a toon-shaded character on a photoreal terrain, a pixel UI over a smooth 3D world. This skill builds an art bible the rest of the project obeys: references, palette, mood, lighting plan, post-processing, and a do/don't list. It writes to .summer/art-bible.md — the file every rendering / shader / lighting / VFX skill reads later.

Core principle: Constraint produces style. A game with 15 colors total looks more intentional than a game with infinite-color textures. Pick the constraint, then defend it.

Steps

1. Open with references

Ask exactly this:

Two or three references — games, films, art books, anything visual. What's the vibe?

Don't suggest. Listen. References are the single most reliable signal of what they actually want. If they say one game, ask for one more — single-reference art bibles converge into a clone of that game.

If they freeze, offer 4 axes (not games):

Pick the one that feels right: a) painterly + warm + handcrafted (Sable, Tunic), b) crisp + saturated + toon (Hi-Fi Rush, Splatoon), c) dark + moody + grounded (Dishonored, Inside), d) lo-fi + nostalgic + crunchy (Dusk, Faith).

2. Read the brief if it exists

Read .summer/GameSoul.md

Brief might say "horror" — that constrains palette and lighting. Brief might say "cozy" — that forbids harsh contrast. Quote it back:

Brief is "cozy farming sim". That rules out harsh shadows and saturated reds. Confirming.

3. Pin the rendering technique

This is the technique question, not the mood question. Force a choice:

Ask:

One technique. Which is it?

If they pick more than one ("PBR characters in a toon world"), name the conflict and force a hierarchy:

Mixed techniques rarely cohere. If you mean "stylized PBR with toon outlines" — that's one technique (PBR + post-process outline). If you mean "toon characters in a PBR world" — that's two, and they'll fight. Pick one as primary.

4. Build the palette

A palette is 6-15 colors total. Not a vibe, not "warm tones" — actual hex codes. Force it.

Walk:

Primary background — what color does the screen mostly read as?
Secondary background — second most common?
Accent — what does the player's eye go to?
Warning / damage — what reads as bad?
Reward / pickup — what reads as good?
UI base — text, frames
UI emphasis — buttons, callouts
Skin / character — if applicable

State candidates as hex. For a "cozy farming" game:

#3a4a3a   primary BG (deep moss green)
#5e6f4f   secondary BG (sage)
#e6c068   accent (golden wheat)
#a83e3e   warning (warm red, not pure red)
#c8a268   reward (warm tan)
#1f1a16   UI base (warm near-black, NOT pure black)
#f4ecdf   UI text (cream, NOT pure white)
#e3b08a   skin warm
#a8784f   skin cool

Pure white (#ffffff) and pure black (#000000) are almost always wrong — they break the palette. Flag it if the user pitches them.

Ask:

Palette above. Adjust any, or lock it?

5. Define the mood adjectives

Three to five adjectives. Concrete, not vague.

Bad: "cool, atmospheric, immersive." Good: "soft, hand-warmed, slightly melancholic, golden-hour."

Ask:

Three to five adjectives that aren't 'cool' or 'atmospheric'. Pick from concrete sensory words.

6. Write the lighting plan

State the plan in one block. For the current Summer Engine rendering stack:

Sun: DirectionalLight3D, color #fff2d9, energy 0.9, angle ~30° (warm low-angle)
Sky: ProceduralSkyMaterial, sky_top_color #6b88a3, sky_horizon_color #d8b88e
Ambient: Environment ambient_light_color #4a5570, ambient_light_energy 0.15
Indoor fills: OmniLight3D color #ffd9a8, energy 0.6, range 4m
NEVER: pure-white DirectionalLight, no ambient, hard cube shadows

For 2D:

Base: CanvasModulate #f4ecdf, gentle warm wash
Accent: PointLight2D for fireflies / lanterns, color from accent palette
NEVER: full-bright modulation, no soft falloff

7. Define post-processing rules

Summer Engine post stack: Glow, SDFGI, SSAO, SSR, Adjustments, Color Correction (LUT). State opinions, not options.

Glow: ON, threshold 0.9, intensity 0.5  (soft bloom on highlights only)
SDFGI: OFF for vertical-slice scope (perf cost; bake lightmaps later)
SSAO: ON, light_affect 0.3 (just enough for grounding)
SSR: OFF unless we have wet/glass surfaces
Color correction: Filmic tonemap, slight S-curve LUT toward warm
Vignette (custom shader): ON, subtle, 0.15 strength
Chromatic aberration: OFF (overused, looks cheap)
Film grain: ON only if mood adjective is "lo-fi" or "vintage"

Make these calls. Don't enumerate options.

8. Build the do / don't list

This is the contract. Five do's, five don'ts. Specific, enforceable.

## DO
-All colors come from the palette. New asset? Pick the closest existing color, don't invent.
-Outline shader on character + interactable props (no outline on environment).
-Soft shadows (DirectionalLight3D shadow_blur 1.5).
-Warm key + cool fill — never both warm or both cool.
-Texture filter: Nearest for a crunchy, near-pixel feel.
 
## DON'T
-No pure white (#ffffff). Use #f4ecdf.
-No pure black (#000000). Use #1f1a16.
-No realistic photo-textures. All textures must read as "painted" at 1m distance.
-No procedural sky shaders mid-day with full sun — too generic. Always angle the sun.
-No chromatic aberration / lens flare / motion blur — they're cheap and date-fast.

9. Apply Summer project-level settings

Some art-direction calls translate to project.godot settings. Apply them.

Preferred (Summer MCP):

summer_project_setting(key="rendering/textures/canvas_textures/default_texture_filter", value="0")  # Nearest, if pixel-art-ish (1 = Linear, the default)
summer_project_setting(key="rendering/environment/defaults/default_clear_color", value="Color(0.227, 0.290, 0.227)")  # palette primary
summer_project_setting(key="rendering/anti_aliasing/quality/msaa_3d", value="2")  # MSAA 2x for clean edges

If a WorldEnvironment node is in the main scene, set its environment defaults to match the lighting plan:

summer_inspect_node(path="./World/WorldEnvironment")
summer_set_prop(scenePath="res://main.tscn", path="./World/WorldEnvironment/...", key="...", value="...")

Ask before each:

May I update project.godot's default clear color to the palette primary, and enable MSAA 2x?

Fallback (no MCP): print the project.godot snippet for the user to paste.

10. Save the art bible

Always write the bible. Path: .summer/art-bible.md.

# Art Bible — <Game Name>
 
**References:** <2-3 specific games / films>
**Technique:** <one of the 7 above>
**Mood:** <3-5 concrete adjectives>
 
## Palette
| Hex | Role |
|---|---|
| #3a4a3a | Primary BG |
| #5e6f4f | Secondary BG |
| ... | ... |
 
## Lighting plan
-Sun: DirectionalLight3D, color #fff2d9, energy 0.9
-Sky: ProceduralSkyMaterial top #6b88a3, horizon #d8b88e
-Ambient: #4a5570 energy 0.15
-Indoor fills: OmniLight3D color #ffd9a8 range 4m
-NEVER: pure-white sun, no ambient
 
## Post-processing
-Glow: ON, threshold 0.9
-SDFGI: OFF (vertical-slice scope)
-SSAO: ON, 0.3
-SSR: OFF
-Tonemap: Filmic
-Vignette: subtle 0.15
-Chromatic aberration: OFF
 
## DO
-...
 
## DON'T
-...

Ask:

May I create .summer/art-bible.md with this bible?

11. Route to the next step

End with:

Bible saved. Next:

- /audio-direction to define the sonic identity that pairs with this look.

- /game-feel to design particle / hit-feedback styles within the palette.

- Open the project's WorldEnvironment node and dial in the lighting plan.

- Or generate first-pass concept assets via assets.generate_image using the palette + mood as the prompt prefix.

Common mistakes

Collaborative protocol

This skill writes one design doc (.summer/art-bible.md) and may modify project.godot settings + the main scene's WorldEnvironment. Always ask.

Want a working starter?

No template — this is a workflow that produces the bible the rest of the project obeys. After the bible exists, every Summer rendering / lighting / shader / VFX skill reads it.

See also

• brainstorm-game — produces the brief that anchors the bible
• audio-direction — the sonic counterpart
• 3d-lighting — implements the lighting plan and the environment's glow, tonemap and SSAO settings

<!-- shell-commands: generated from the operation catalog by npm run generate:registry; do not edit by hand -->

From a shell

No Summer MCP tools in this session? Run each one as a command; when summer --version is missing or below 4.0, use npx -y summer-engine@latest in place of summer. Fields are flags in kebab-case (--scene-path res://main.tscn) or one --input '<json>', and summer ops describe <op> prints the exact input. The summer-cli skill has the rest.

<!-- /shell-commands -->