decentraland / decentraland/docs

Mobile optimization: document VFX emitter and light source scene limits

Open Beginner friendly
#189 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Wolfram Language
Stars
0
Forks
8
Avg merge
1d 10h
Merged PRs (30d)
21

Description

The Godot Explorer scene stats overlay now surfaces 4 new per-scene rows (decentraland/godot-explorer#2674):

- **VFX emitters** — active particle emitters (soft 8 / hard 10)
- **Live particles** — sum of authored particle amounts (soft 25,000 / hard 50,000)
- **Light sources** — authored SDK LightSource components, active only (soft 8 / hard 16)
- **Shadow lights** — authored lights with shadows enabled (soft 2 / hard 4)

The mobile optimization page should document these budgets so creators understand why scenes that read green on legacy rows (triangles/entities/textures) can still drive session overheat on mobile.

Context worth including:
- Light rows show **authored** counts, not the runtime per-profile budget (Very Low 0 / Low 2 / Medium 4 / High 8 active lights — see decentraland/godot-explorer#2633). A scene can author 20 lights; the engine will only run 8 on High, but authoring beyond budget is wasted scene cost.
- Audit baseline: Genesis Plaza authors 59 lights / 48 shadow lights; rituals.dcl.eth 20 lights; doriangray.dcl.eth 16 lights.
- Runtime particle budgets already enforced: 5,000 per emitter, 50,000 per scene.

Refs: decentraland/godot-explorer#2674, decentraland/godot-explorer#2368, decentraland/godot-explorer#1538

Contributor guide

Open the contributing guide

Research direction

Start with the mobile optimization page and the Godot Explorer scene stats overlay context in the issue. Document the four scene rows and their soft and hard limits, explain authored versus runtime light budgets, and include the stated particle limits and audit examples; done means creators can understand mobile overheat risks beyond legacy rows.

Written by the indexing model from the issue text.

Assessment

Tech stack
godot
Domain
documentation, mobile-dev
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
78/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.