Skip to content

Commit bb0fd89

Browse files
committed
Tech spec & polish
1 parent 11a7a7e commit bb0fd89

File tree

4 files changed

+208
-69
lines changed

4 files changed

+208
-69
lines changed

docs/gdevelop5/community/contribute-to-the-assets-store/index.md

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -10,37 +10,37 @@ GDevelop streamlines the integration of assets into game projects, eliminating t
1010

1111
Before integrating your art into a pack, you'll need to consider its fundamental elements, such as a thumbnail, title, description, and other key details. Let's explore each of these components that define an asset pack.
1212

13-
## Get your Pack Ready
13+
## Get your pack ready
1414

15-
### Make a Thumbnail & Previews Files
15+
### Make a thumbnail & previews files
1616

1717
A pack with an attractive thumbnail makes it more visible. Additional images can help them decide if a pack suits their needs. Use contrasting colors to make your thumbnail stand out. The thumbnail should accurately represent the contents of the pack. Thumbnails that show assets in context are preferred over simple grids of assets.
1818

19-
- Thumbnail requirements:
19+
All preview images and the thumbnail must be submitted inside a folder named `previewImages`.
2020

21-
- Size: 16:9 ratio. Example: `1280x720` or `1920x1080`
22-
- File: `.png`
23-
- Name: `thumbnail.png`
21+
**Thumbnail requirements:**
2422

25-
- Previews of your assets: extra images that display your pack to convince the user to purchase it. If you contribute a Free Asset Pack, preview assets are not mandatory:
23+
- Size: 16:9 ratio. Example: `1280x720` or `1920x1080`
24+
- File: `.png`
25+
- Name: `thumbnail.png`
2626

27-
- They can be from 1 to 9
28-
- Must be named `preview1.png`, `preview2.png`, ..., `preview9.png`
29-
- Must be 16:9, `1280x720` or `1920x1080`
30-
- File format in `.png` or `.gif`
27+
**Previews of your assets:** Extra images that display your pack to convince the user to purchase it. If you contribute a Free Asset Pack, preview assets are not mandatory.
3128

32-
All preview images must be submitted inside a folder named `previewImages`.
29+
- They can be from 1 to 9
30+
- Must be named `preview1.png`, `preview2.png`, ..., `preview9.png`
31+
- Must be 16:9, `1280x720` or `1920x1080`
32+
- File format in `.png` or `.gif`
3333

34-
### Name your Pack
34+
### Name your pack
3535

3636
Having a good title is important, buyers search using keywords. Choose a unique and short title that represents your pack.
3737
A good asset pack title is concise, descriptive, and engaging, clearly indicating the pack's primary content and making it easily discoverable and memorable for users.
3838

39-
### Get a Description
39+
### Get a description
4040

4141
A good asset pack description clearly and concisely communicates the contents and value of the pack to potential users by highlighting included items, intended use cases, and any relevant details.
4242

43-
### Define a Price
43+
### Define a price
4444

4545
(This step can be skipped for free packs.)
4646

@@ -52,7 +52,7 @@ A paid pack can have two different prices, to fit the needs of the buyer.
5252
Usually the Unlimited Commercial price is 20% to 30% more expensive.
5353
You can mention the prices in Euro (€) or USD ($).
5454

55-
### Choose a Category
55+
### Choose a category
5656

5757
Your pack must comply with at least one of these main categories:
5858

@@ -91,7 +91,7 @@ Some examples of folder names
9191

9292
When a pack contains a lot of objects, more specific folders and sub-folders can be used.
9393

94-
### Follow Naming Best Practices
94+
### Follow naming best practices
9595

9696
The object names must be descriptive. They are used by the search engine of the asset store.
9797

@@ -108,13 +108,13 @@ Generic names to avoid:
108108
- Item 37
109109
- Robert (a proper noun)
110110

111-
## Package your Art
111+
## Package your art
112112

113113
There are two ways you can package your Asset Pack to submit it to the GDevelop Store:
114114

115-
- **Recommended: Through the engine:** Set your objects in the engine and export the `.gdo` file that was automatically generated. This file will include the complete object configuration and folder structure as set up in the engine.
115+
- **Recommended:** Set your objects through the engine, and export the `.gdo` file that was automatically generated. This file will include the complete object configuration and folder structure as set up in the engine.
116116

117-
- **Manual packaging:** If you have a large number of assets, you can create a pack by manually organizing the files without using the game engine editor, following [the provided technical specifications](./technical-speficication.md).
117+
- **Manual packaging:** Set your files manually, if you have a large number of assets, you can create a pack by manually organizing the files without using the game engine editor, following [the provided technical specifications](./technical-speficication.md).
118118

119119
To export a `.gdo` file from the GDevelop editor, follow these steps:
120120

@@ -124,7 +124,7 @@ To export a `.gdo` file from the GDevelop editor, follow these steps:
124124

125125
![](export-gdo.png)
126126

127-
### Fit Art with an Object
127+
### Fit art with an object
128128

129129
Your files must all match an object type, please [follow the object page](/gdevelop5/objects/) which details each type and will help you to integrate your files correctly.
130130

@@ -136,7 +136,7 @@ Formats supported are:
136136
- .ttf
137137
- .otf
138138

139-
### Package Audio
139+
### Package audio
140140

141141
Put your audio files `.aac`, `.wav`, `.mp3` (prefer `.aac`) directly into an `Audio` folder, with the name to be displayed: `Laser effect.aac`, `Background music.aac`.
142142

@@ -145,7 +145,7 @@ Put your audio files `.aac`, `.wav`, `.mp3` (prefer `.aac`) directly into an `Au
145145
🚨 Careful about the size! Players are sensitive to the size of a game download (especially on mobile and on the web). **Try to keep music file sizes around 1 to 2 MB. In rare cases, these can be 4 or 5 MB, but not larger.** Consider downgrading the quality a bit to keep the music files around these sizes.
146146
Sound effects are usually even smaller. If a sound file is larger than 200 or 300 KB, consider downgrading the quality.
147147

148-
### Other Objects
148+
### Other objects
149149

150150
If you are in doubt, ask to the GDevelop team or the community if your files can be supported by an objects, or fit a [custom objects (prefab)](gdevelop5/objects/custom-objects-prefab-template/).
151151

@@ -160,12 +160,12 @@ GDevelop have several limitation for now, as they are:
160160
- GDevelop does not support image the origin point for different animations yet.
161161
- Audio files are not yet supported within the `.gdo` format. Please place your audio files in an `Audio` folder located in the same directory as your `.gdo` file. Subsequently, compress both the `.gdo` file and the Audio folder into a `.zip` or `.rar` archive for submission via the application form.
162162

163-
## Something Unclear?
163+
## Something unclear?
164164

165165
Ask a question on [this Trello board](https://trello.com/c/s8RctC9M/2-asset-rules-and-regulations) card. If the rules here are too complicated or are giving you too much work, you can suggest a new rule and we'll see if we can adapt the importer so that it can understand your asset structure.
166166
The goal is to make objects more or less automatically!
167167

168-
## Submitting the Asset Pack
168+
## Submitting the asset pack
169169

170170
When you're ready to submit your asset pack (free or paid), compress the folder containing the `.gdo` or the other folders of your pack, then send it to GDevelop by filling the application form with the button below:
171171

0 commit comments

Comments
 (0)