godot-website/article/asset-library-web-frontend-reaches-beta/index.html

<!doctype html><html lang=en><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=author content="Godot Engine"><meta name=description content="After several months of development, the web frontend to Godot's Asset Library finally reached the beta status!"><meta name=theme-color content="#3d8fcc"><meta property="og:site_name" content="Godot Engine"><meta property="og:url" content="https://godotengine.org/article/asset-library-web-frontend-reaches-beta/"><meta name=twitter:site content="@godotengine"><meta property="og:title" content="The Asset Library web frontend reaches beta"><meta property="og:description" content="After several months of development, the web frontend to Godot's Asset Library finally reached the beta status!"><meta property="og:image" content="https://godotengine.org/storage/app/uploads/public/581/7c8/856/5817c8856eccf877486140.png"><meta property="og:type" content="article"><meta name=twitter:card content="summary_large_image"><title>The Asset Library web frontend reaches beta</title><link rel=alternate type=application/rss+xml title="Godot News" href=/rss.xml><link rel=icon href=/assets/favicon.png sizes=any><link rel=icon href=/assets/favicon.svg type=image/svg+xml><link rel=stylesheet href=/assets/css/main.css?112><link rel=stylesheet href=/assets/css/tobii.min.css><link rel=preload as=font href=/assets/fonts/Montserrat-Bold.woff2 crossorigin><link rel=preload as=font href=/assets/fonts/Montserrat-ExtraBold.woff2 crossorigin><link rel=me href=https://mastodon.gamedev.place/@godotengine><input type=checkbox id=nav_toggle_cb><header><div class="container flex align-center"><div id=nav_head><a href=/ id=logo-link><img class=nav-logo src=/assets/logo.svg width=136 height=48 alt="Godot Engine">
<img class="nav-logo dark-logo" src=/assets/logo_dark.svg width=136 height=48 alt="Godot Engine"></a>
<label for=nav_toggle_cb id=nav_toggle_btn><img src=/assets/icons/hamburger.svg width=24 height=24 alt="Main menu"></label></div><nav id=nav><ul class=left><li><a href=/features/>Features</a><li class=only-on-mobile><a href=/showcase/>Showcase</a><li><a href=/blog/>Blog</a><li><a href=/community/>Community</a><li><a href=/contact/>About</a><li><a href=https://godotengine.org/asset-library/asset>Assets</a></ul><ul class=right><li><a href=/download/windows/ class=set-os-download-url>Download</a><li><a href=https://docs.godotengine.org>Docs</a><li><a href=https://docs.godotengine.org/en/stable/community/contributing/index.html>Contribute</a><li class=fund><a href=https://fund.godotengine.org>❤&#xFE0E; Donate</a></ul></nav></div></header><main><style>body{background-color:var(--background-color)}h1{margin-bottom:8px;margin-top:32px}:not(pre)>code{background:var(--code-background-color);padding:1px 4px;font-size:.95em;border-radius:3px}pre{background:var(--codeblock-background-color);color:var(--codeblock-color)}pre code{display:block;overflow-x:auto;padding:.5em}.date-big{line-height:2;margin-left:32px}article{background-color:var(--base-color);box-shadow:0 3px 2px rgba(0,0,0,.15)}figure{margin:0}figure img{margin:0}article img,article video{max-width:100%;height:auto;display:block;margin:auto;margin-top:16px;margin-bottom:16px}article h1{margin-top:64px}article h2,article h3,article h4{margin-top:42px}.article-info{display:flex;flex-direction:column;gap:8px}.article-metadata{display:flex;gap:24px;align-items:center;font-family:var(--header-font-family);margin-bottom:12px}@media(max-width:900px){.article-metadata{flex-direction:column;align-items:flex-start;gap:16px}}.article-author{color:var(--base-color-text-subtitle-date);font-weight:700;font-size:18px;flex-grow:1;display:flex;gap:12px;align-items:center}.article-author .avatar{border-radius:100%;margin:0}.article-author .by{color:var(--base-color-text-subtitle)}.article-metadata .date{color:var(--base-color-text-subtitle-date)}.article-metadata .date.post-recent-highlight{color:var(--post-recent-highlight-color);opacity:.8}.article-metadata .date.post-recent-highlight::after{font-size:80%;content:"NEW";border:2px solid var(--post-recent-highlight-color);padding:2px 3px;margin-left:8px}.tag.active{filter:saturate(.75)}@media screen and (min-width:900px){article .content{width:70%;margin:auto}}@media(max-width:900px){body{background-color:var(--base-color)}article{background-color:initial;box-shadow:none}article img:first-child,article video:first-child{max-width:100%}}</style><link rel=stylesheet href=/assets/css/highlight.obsidian.min.css><div class=container><article class=padded><div class="content article-container"><figure class=article-cover><img src=/storage/app/uploads/public/581/7c8/856/5817c8856eccf877486140.png title alt=" " class=rounded-lg style=width:100%;height:auto;background-color:initial></figure><div class=article-info><h1>The Asset Library web frontend reaches beta</h1><div class=article-metadata><div class=article-author><span>By:</span>
<img class=avatar width=25 height=25 src=/assets/images/authors/akien.webp alt="Rémi Verschelde" loading=lazy>
<span class=by>Rémi Verschelde</span></div><span class=date data-post-date="2016-10-31 22:44:33 +0000">31 October 2016</span></div><div class=tags><a href=/blog/news><div class="tag active">News</div></a></div></div><div class="card card-warning"><p>This article is from <strong>October 2016</strong>, some of its contents might be outdated and no longer accurate.<br>You can find up-to-date information about the engine in the <a href=https://docs.godotengine.org/en/stable/>official documentation</a>.</div><div class=article-body><p>After several months of waiting (<a href=https://en.wikipedia.org/wiki/Waiting_for_Godot>obligatory joke</a>) and more importantly of development, the web frontend to Godot’s <a href=/asset-library/><em>Asset Library</em></a> finally reached the <a href="https://github.com/godotengine/asset-library/milestone/2?closed=1">beta status</a>!<p>What does it mean? That the Asset Lib frontend is now <a href=/asset-library/>officially public</a> and that the community can start using it extensively. It is still <a href=https://github.com/godotengine/asset-library>in development</a>, but we have a pretty solid base that should allow you to create your account, submit and update your assets - as well of course as seeing the existing assets in the library.<p>Many thanks to <a href=https://github.com/bojidar-bg>Bojidar Marinov</a> for the huge work he did on the Asset Lib so far! <a href=https://github.com/godotengine/asset-library/graphs/contributors>Others</a> have started to contribute too, don’t hesitate to join in if you like (or at least know) PHP :)<p>If you missed the inline links, here they are in clear:<ul><li><a href=/asset-library>Asset Library</a> - browse anonymously or register and login to submit new assets<li><a href=https://github.com/godotengine/asset-library>Source repository</a> - to partake in the development<li><a href=https://github.com/godotengine/asset-library/issues>Issue tracker</a> - to report any issues you may encounter (also usability wise, it’s still a work in progress)</ul><h2 id=how-does-it-work>How does it work?</h2><p>The Asset Library is composed of three parts:<ul><li>The engine frontend in Godot itself (since 2.1 stable), that you can access via the project manager (to install templates and demos) or via the <em>AssetLib</em> tab in your opened project (for all other types of assets).<li>The web backend, which is queried by the engine frontend to retrieve the list of assets and related metadata.<li>The web frontend, which allows you to see the contents of the library in your browser (<a href=/asset-library/asset/4>see this asset</a> for example), and most importantly to submit new assets and edit existing ones registered to your account.</ul><h2 id=what-assets-can-be-submitted>What assets can be submitted?</h2><p>The exact policy for the Asset Lib still needs to be formally written down, but here are the general rules that apply so far:<ul><li>All assets should be licensed under a <em>free and <a href=https://opensource.org/osd>open source</a> license</em> (e.g. MIT, BSD, GPL, CC0, etc.). When picking a license for your assets, you should of course ensure that you have the appropriate rights (i.e. you can’t relicense assets from someone else to submit them to the Asset Lib).<li>All assets should be hosted in a <a href=https://git-scm.com/>Git</a> repository, and accessible through a web frontend. The supported frontends so far are GitHub, GitLab (both gitlab.com and self hosted), Bitbucket, gogs and cgit (those two are also typically self hosted).<li>Each asset should be hosted in its own Git repository, i.e. one asset = one repo.</ul><p>Why do we request this? We are not a company, and we want to give the priority to open source contributions that will benefit all users without having to care for the legal burden of running a commercial asset store. It does <em>not</em> mean that Godot’s engine frontend will not support paid assets in the future, but it is not our focus right now for the godotengine.org platform. People who want to run commercial stores are free to extend on our (obviously open source) <a href=https://github.com/godotengine/asset-library>web frontend and backend code</a> and to host their own platform that can talk to Godot.<p>We also enforce the usage of Git and code hosting platforms such as GitHub or GitLab for security reasons: it allows moderators to review the code included in each asset before accepting them. The specific commit or git tag provided as the version to download in the Asset Lib can be used to generate an archive with a unique cryptographic hash – moderators have to enter this hash when they accept new assets or edits, and Godot users will only be able to download files with a valid hash from within the engine – this ensures that what users download is what moderators approved.<h2 id=how-to-submitedit-assets>How to submit/edit assets</h2><p>Once logged in, click “Submit Asset” in the navigation bar. You will then see a form asking for various details about your git repository and the asset you want to package:<ul><li>Asset name<li>Category: 2D Tools, 3D Tools, Shaders, Materials, Tools, Scripts, Misc, Templates, Projects, Demos (subject to change as we gather community feedback)<li>Frontend type: GitHub, GitLab, Bitbucket, gogs or cgit<li>Repository URL<li>Download commit or tag: this identifies the version you want to submit to the Asset Lib. It will not be automatically updated for the security reasons mentioned above, so please edit your asset to update this hash or tag when needed.<li>Icon URL<li>License<li>Description<li>Optionally image and video previews</ul><p>Once you submit your asset, you will have to wait for an Asset Lib maintainer to review it and accept it (it can take several hours, though we’re usually quite fast).<h2 id=how-to-setup-assets-in-your-git-repositories>How to setup assets in your git repositories</h2><p>We will provide more information about this in the docs in the coming weeks, but in the meantime, please check existing assets and their git repositories to see how it was done.<p>Keep in mind that assets are unzipped directly at the root of your project’s folder. Therefore, for plugins, you should use a <code class="language-plaintext highlighter-rouge">addons/yourassetname/</code> folder in your git repository.<p>If you are in doubt, don’t hesitate to ask for guidance on one of the many <a href=/community>community channels</a>!<h2 id=future-developments>Future developments</h2><p>As you will probably notice, the frontend is not finished yet. For example, rating assets is not implemented in the beta. You can check the existing <a href=https://github.com/godotengine/asset-library/issues>list of issues</a> as well as the <a href=https://github.com/godotengine/asset-library/milestone/3>milestone to the 1.0 release</a> to see what is in the works. If you have issues to report or suggestions to make, please use the issue tracker.<p>For now, enjoy the existing assets and the web frontend, and give us your feedback!</div></div></article></div><link rel=stylesheet href=/assets/css/anchor-link.css?1><link rel=stylesheet href=/assets/css/article-cards.css?2><script src=/assets/js/anchor-link.js></script>
<script>document.addEventListener('DOMContentLoaded',()=>{window.applyAnchorLinks('.article-body'),document.querySelectorAll('.article-cover img, .article-body img').forEach(b=>{if(b.classList.contains('lightbox-ignore'))return;const a=document.createElement('a');a.href=b.src,a.classList.add('lightbox'),a.dataset.group='article',b.parentNode.appendChild(a),a.appendChild(b)})})</script></main><footer><div class="container flex footer-container"><div id=copyright><p>© 2007-2024 Juan Linietsky, Ariel Manzur and <a href=https://github.com/godotengine/godot/blob/master/AUTHORS.md target=_blank rel=noopener>contributors</a>.<br>Hosted by the <a href=https://godot.foundation/ target=_blank rel=noopener>Godot Foundation</a>.<br>Website <a href=https://github.com/godotengine/godot-website target=_blank rel=noopener>source code on GitHub</a>.</div><div id=sitemap><ul class=sitemap-group><li><strong>Get Godot</strong><li><a href=/download/windows/ class=set-os-download-url>Download</a><li><a href=/download/archive/>Release Archive</a><li><a href=https://editor.godotengine.org/releases/latest/>Web Editor</a><li>&nbsp;<li><strong>Public Relations</strong><li><a href=/blog/>Blog</a><li><a href=/community/>Communities and Events</a><li><a href=/press/>Press Kit</a></ul><ul class=sitemap-group><li><strong>About Godot</strong><li><a href=/features/>Features</a><li><a href=/showcase/>Showcase</a><li><a href=/education/>Education</a><li><a href=/license/>License</a><li><a href=/code-of-conduct/>Code of Conduct</a><li><a href=/privacy-policy/>Privacy Policy</a><li><a href=https://fund.godotengine.org>Donate</a></ul><ul class=sitemap-group><li><strong>Project Team</strong><li><a href=/governance/>Governance</a><li><a href=/teams/>Teams</a><li>&nbsp;<li><strong>Extra Resources</strong><li><a href=https://godotengine.org/asset-library/asset>Asset Library</a><li><a href=https://docs.godotengine.org>Documentation</a><li><a href=https://github.com/godotengine>Code Repository</a></ul></div><div id=social class=dark-desaturate><h4 class=text-right><a href=/contact/>Contact us</a></h4><div class="flex justify-space-between" style=gap:3px><a href=https://github.com/godotengine target=_blank rel=noopener><img src=/assets/footer/github_logo.svg width=32 height=32 alt=GitHub></a>
<a href=https://mastodon.gamedev.place/@godotengine target=_blank rel=noopener><img src=/assets/footer/mastodon_logo.svg width=32 height=32 alt=Mastodon></a>
<a href=https://twitter.com/godotengine target=_blank rel=noopener><img src=/assets/footer/twitter_logo.svg width=32 height=32 alt=Twitter></a>
<a href=https://www.facebook.com/groups/godotengine/ target=_blank rel=noopener><img src=/assets/footer/facebook_logo.svg width=32 height=32 alt=Facebook></a>
<a href=https://www.reddit.com/r/godot target=_blank rel=noopener><img src=/assets/footer/reddit_logo.svg width=32 height=32 alt=Reddit></a>
<a href=/rss.xml target=_blank rel=noopener><img src=/assets/footer/feed_logo.svg width=32 height=32 alt="RSS feed"></a></div></div></div></footer><script defer src=/assets/js/tobii.min.js></script>
<script defer src=/assets/js/highlight.min.js?1></script>
<script defer src=/assets/js/highlight.gdscript.min.js?1></script>
<script>document.addEventListener('DOMContentLoaded',()=>{document.querySelectorAll('pre code').forEach(a=>{hljs.highlightBlock(a)}),document.querySelectorAll('[data-post-date]').forEach(a=>{Date.parse(a.dataset.postDate)>Date.now()-1e3*60*60*48&&a.classList.add("post-recent-highlight")}),new Tobii({zoom:!1});const a=document.querySelectorAll('.set-os-download-url');for(let b=0;b<a.length;b++){const c=a[b];let e='download';'version'in c.dataset&&c.dataset.version==='3'&&(e='download/3.x');let d='windows';navigator.platform.indexOf('Mac')!==-1?d='macos':navigator.platform.indexOf('Linux')!==-1&&(d='linux'),c.href=`/${e}/${d}/`}})</script>