Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Submitting to the Asset Store

소개

This tutorial aims to serve as a guide on how you can submit your own assets to the Godot Asset Store and share them with the Godot community.

As mentioned in the Using the Asset Store Website page, in order to be able to submit assets to the Asset Store, you need to have a registered account, and be logged in.

제출 지침

애셋을 제출하기 전에 모든 요구 사항을 준수하는지 확인하고 권장 사항을 따르는 것도 고려하십시오.

요구 사항

Generally speaking, most assets people submit to the Asset Store are accepted. However, in order for your asset to be accepted, there are a few requirements it needs to meet to be approved.

  • 애셋은 작동해야 합니다. 애셋이 실행되지 않거나 지정된 Godot 버전에서 작동하지 않으면 거부됩니다.

  • 애셋에는 적절한 .gitignore 파일이 있어야 합니다. 리포지토리에서 중복된 데이터를 제거하는 것이 중요합니다. 템플릿은 다음과 같습니다.

  • 하위 모듈이 없거나 하위 모듈이 필수적이지 않아야 합니다. GitHub는 다운로드한 ZIP 파일에 하위 모듈을 포함하지 않으므로 애셋에 하위 모듈의 콘텐츠가 필요한 경우 애셋이 작동하지 않습니다.

  • The license needs to be correct. The license listed on the Asset Store must match the license in the repository. The repository must have a license file, called either "LICENSE" or "LICENSE.md". This file must contain the license text itself and a copyright statement that includes the year(s) and copyright holder.

  • 애셋 이름과 설명에 적절한 영어를 사용하세요. 여기에는 올바른 대소문자 사용, 설명에 전체 문장 사용이 포함됩니다. 다른 언어를 포함할 수도 있지만 최소한 영어 버전이 있어야 합니다.

  • 아이콘 링크는 직접 링크여야 합니다. GitHub에 호스팅된 아이콘의 경우 링크는 "github.com"이 아닌 "raw.githubusercontent.com"으로 시작해야 합니다.

권장 사항

These things are not required for your asset to be approved, but if you follow these recommendations, you can help make the asset store a better place for all users.

  • 프로젝트가 아닌 애셋을 만들 때 파일을 addons/asset_name/ 폴더 안에 배치하는 것이 일반적입니다. 파일이 다른 애셋이나 애셋을 설치하는 사용자 파일과 충돌하는 것을 방지하려면 이렇게 하세요. 이 폴더는 사용자가 애셋을 설치할 때 자동으로 생성되지 않습니다.

  • 모든 스크립트 경고를 수정하거나 억제합니다. 경고 시스템은 코드 문제를 식별하는 데 도움이 되지만 애셋을 사용하는 사람들은 이를 볼 필요가 없습니다.

  • Make your code conform to the official style guides. Having a consistent style helps other people read your code, and it also helps if other people wish to contribute to your asset. See the GDScript 스타일 가이드 or the C# 스타일 가이드.

  • If you have screenshots in your repository, place them in their own subfolder and add an empty .gdignore file in the same folder (note: gd, not git). This prevents Godot from importing your screenshots. On Windows, open a command prompt in the project folder and run type nul > .gdignore to create a file whose name starts with a period.

  • 애셋이 다른 파일 작업을 위한 라이브러리인 경우 애셋에 예제 파일을 포함하는 것이 좋습니다.

  • Consider adding a .gitattributes file to your repository. This file allows giving extra instructions to Git, such as specifying line endings and listing files not required for your asset to function with the export-ignore directive. This directive removes such files from the resulting ZIP file, preventing them from being downloaded by Asset Store users. These are common examples of .gitattributes:

    # Normalize line endings for all files that Git considers text files.
* text=auto eol=lf

  • 플러그인을 제출하는 경우 라이센스 사본과 추가 정보를 플러그인 폴더 자체에 추가하세요. 이는 사용자가 프로젝트와 함께 보관하도록 보장되는 폴더이므로 복사본을 통해 해당 파일을 항상 편리하게 사용할 수 있습니다(라이센스 조건을 이행하는 데 도움이 됩니다).

  • While the Asset Store allows more than just GitHub, consider hosting your asset's source code on GitHub. Other services may not work reliably, and a lack of familiarity can be a barrier to contributors.

제출하기

Once you are logged in, click on Upload Asset on the top right of the website. It will take you to the following page:

../../_images/asset_store_submit.webp

Here is a breakdown of each field:

  • Publisher: This is the public name associated with the asset. For example, the XR Tools asset has the publisher "Godot XR".

  • Publisher Name: The name of the new publisher you are creating.

  • Publisher URL Slug: how the publisher will appear in its link. For example, the XR Tools asset has the following URL: https://store.godotengine.org/asset/godot-xr/godot-xr-tools/

    The publisher URL Slug in that is "godot-xr".

  • Asset Name: The name of your asset. Should be a unique, descriptive title of what your asset is.

  • Asset URL: How the asset will be named in its link. For example, the XR Tools asset has the following URL: https://store.godotengine.org/asset/godot-xr/godot-xr-tools/

    The asset URL for that link is "godot-xr-tools".

After filling out those fields, agree to the terms of service after reading them, and click "Continue". You will be brought to the asset's management page, where you can edit almost everything about how it will appear on the store, as well as upload different versions.

../../_images/asset_store_management.webp

Management pages

개요

The overview tab lets you submit your asset for review. You can also view analytics including how many times it's been downloaded, page visits, and the number of people who have added it to their library.

You can also delete the asset at the bottom of the page from this tab.

설정

This tab is where you set up the following general information about your asset:

  • Asset Summary

  • Detailed description

  • 태그

  • Asset type (Full Project or Addon)

  • License

  • Link to source code

  • AI usage disclosure (This is mandatory if you use AI)

Media

The media tab is where you upload your thumbnail, screenshots, an image for the featured page if you want, and link to a YouTube video if you have one.

버전

This is where you upload the actual asset files. For each version you upload you can give it a name, write a changelog, and specify the minimum Godot version (and maximum if applicable). There is also an additional information field for anything miscellaneous.

Each individual version has a maximum file size of 1GB.

Pricing

While paid assets can't be uploaded yet, there are some settings relevant to free assets. You can link to another website where you accept donations, such as Patreon or Ko-Fi. You can also disable reviews if you want (in the future paid assets will not have this option).

Submitting for review

Once you are done, press "Submit". Your asset will be entered into the review queue. You will be informed when your asset is reviewed. If it was rejected, you will be told why that may have been, and you will be able to submit it again with the appropriate changes.