fxgl-asset-sourcing-attribution

name	fxgl-asset-sourcing-attribution
description	Source freely available third-party assets for an FXGL game, but only when the license clearly allows commercial use and modification. Download approved assets, organize them into the correct FXGL asset folders, and generate reusable provenance and attribution records for release compliance and optional in-game credits. Use this skill when you need spritesheets, portraits, UI icons, tiles, backgrounds, sound effects, or music from online sources without losing track of legal obligations.
triggers	["free asset download","attribution","asset license","commercial use","credits file","third party assets","OpenGameArt","Kenney","Freesound","asset provenance","source game art","source audio"]
compatibility	Java 17+, FXGL 21.x. Internet access required for sourcing. Defaults to licenses that clearly allow commercial use and modification; rejects unclear or incompatible licenses.
category	fxgl/assets
tags	["fxgl","java","javafx","assets","attribution","licensing","audio"]
metadata	{"author":"fxgl-skills","version":"1.0","fxgl-version":"21.1"}
allowed-tools	["Read","Write","Edit","Bash"]

FXGL Free Asset Sourcing & Attribution

Scope

Use this skill to bring third-party assets into an FXGL project safely:

• images: spritesheets, character portraits, UI icons, tiles, backgrounds
• audio: sound effects and music
• compliance: provenance capture, attribution, and local project organization

This skill is about asset intake. It is not a generic FXGL asset loader tutorial, and it is not for AI-generated images.

Default License Policy

Accept by default only assets whose license is explicitly shown and clearly allows:

1. commercial use
2. modification / derivative works
3. redistribution inside a shipped game build

Default allowlist

License / policy	Use by default?	Notes
CC0 / public domain	Yes	Preferred; attribution still worth recording
CC BY 4.0 (or equivalent attribution-required permissive license)	Yes	Capture exact attribution text / URL
Source-specific commercial-use license with explicit modification rights	Yes	Keep the source URL and the license text
CC BY-SA, CC BY-NC, CC BY-ND	No	Skip by default; obligations are too risky for automated intake
"Free for personal use"	No	Not commercial-safe
Missing / unclear license	No	Reject and keep searching

If the license is ambiguous, do not download into the project.

Recommended Source Shortlist

See references/free-asset-sources.md for the short list. Prefer sources whose asset pages expose license terms clearly and consistently.

FXGL Folder Targets

Place approved files under src/main/resources/assets/ using FXGL's actual asset-loading conventions.

src/main/resources/assets/
├── textures/
│   ├── sprites/
│   ├── portraits/
│   ├── ui/
│   ├── tiles/
│   └── backgrounds/
├── sounds/        # WAV only; short interactive SFX
├── music/         # MP3 only; long-form music / loops
└── data/
    └── attribution.csv   # optional runtime-friendly credits file