com.beamable 5.1.0-PREVIEW.RC7 → 5.1.0-PREVIEW.RC8

package/CHANGELOG.md

@@ -28,6 +28,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - "Beam Library" Window is now "Beam Samples" Window and was updated with latest docs and samples
 - AdminFlow prefab (ConsoleFlow) was removed from the Beam Samples Window and is now considered Deprecated
 - Now Renamed content entries will be shown as Modified Renamed in the Content Manager Window rather than a New and Deleted entries.
+- Default assets and content are imported manually on first visit to Content Manager
 
 ## [5.0.1] - 2026-04-02
 ### Fixed

package/Editor/ContentService/CliContentService.cs

@@ -83,6 +83,23 @@ namespace Beamable.Editor.ContentService
 		public bool isReloading;
 		public List<string> availableManifestIds;
 
+		/// <summary>
+		/// True once the most recent <see cref="Reload"/> has finished fetching the realm's remote
+		/// manifest list. Until this is true the realm's emptiness is unknown (still loading).
+		/// </summary>
+		public bool RemoteManifestsLoaded { get; private set; }
+		/// <summary>
+		/// True when the last remote-manifest fetch errored. Used so the Content Manager does not
+		/// misread a transient failure as "this realm is empty".
+		/// </summary>
+		public bool RemoteManifestsErrored { get; private set; }
+		/// <summary>
+		/// Number of remote manifests on the realm as of the last successful fetch. Zero means the
+		/// realm has never had content published — the signal used to offer the opt-in default
+		/// content import (see DefaultContentImporter).
+		/// </summary>
+		public int RemoteManifestCount { get; private set; }
+
 		public Dictionary<string, LocalContentManifestEntry> EntriesCache { get; }
 
 		private readonly Dictionary<string, ContentObject> _contentScriptableCache;
@@ -735,10 +752,10 @@ namespace Beamable.Editor.ContentService
 				_contentWatcher.OnProgressStreamContentPsProgressMessage(dp => { LatestProgressUpdate = dp.data; });
 				_ = _contentWatcher.Command.Run();
 
-				bool addedAnyDefault = false;
+				RemoteManifestsLoaded = false;
+				RemoteManifestsErrored = false;
 				var getAvailableManifestsPromise = _cli.ContentListManifests(new ContentListManifestsArgs()).OnStreamContentListManifestsCommandResults(dp =>
 				{
-					
 					var manifestIds = new HashSet<string>();
 					foreach (var id in dp.data.localManifests)
 					{
@@ -749,41 +766,25 @@ namespace Beamable.Editor.ContentService
 					{
 						manifestIds.Add(id);
 					}
-					
-					if (dp.data.remoteManifests.Count == 0)
-					{
-						// If no remote manifest on remote, it means that it is the first time that the customer is using this realm
-						// If so, we need to create the default contents
-						string[] guids = BeamableAssetDatabase.FindAssets<ContentObject>(new[] {Constants.Directories.DEFAULT_DATA_DIR});
-						foreach (string guid in guids)
-						{
-							string path = AssetDatabase.GUIDToAssetPath(guid);
-							ContentObject obj = AssetDatabase.LoadAssetAtPath<ContentObject>(path);
 
-							if (obj == null)
-								continue;
-
-							string fileName = Path.GetFileNameWithoutExtension(path);
-							obj.SetContentName(fileName);
-							SaveContent(obj);
-							addedAnyDefault = true;
-						}
-					}
+					// A realm with zero remote manifests has never had content published to it.
+					// Seeding default content is deferred to an explicit, user-initiated action
+					// (see DefaultContentImporter) so we never mutate the AssetDatabase / Addressables
+					// at init time. Here we only record the signal the Content Manager uses to offer
+					// the opt-in import prompt.
+					RemoteManifestCount = dp.data.remoteManifests.Count;
+					RemoteManifestsLoaded = true;
 
 					availableManifestIds = manifestIds.ToList();
 				}).OnError(dp =>
 				{
+					RemoteManifestsErrored = true;
 					Debug.LogError(dp.data.message);
 				}).Run();
-				
+
 				await manifestIsFetchedTaskCompletion.Task;
 				await getAvailableManifestsPromise;
 
-				if (addedAnyDefault)
-				{
-					await PublishContents();
-				}
-
 				ManifestChangedCount++;
 			}
 			finally

package/Editor/ContentService/DefaultContentImporter.cs

@@ -0,0 +1,248 @@
+using Beamable.Common;
+using Beamable.Common.Content;
+using System.Collections.Generic;
+using System.IO;
+using System.Threading.Tasks;
+using UnityEditor;
+using UnityEditor.AddressableAssets;
+using UnityEditor.AddressableAssets.Settings;
+using UnityEditor.AddressableAssets.Settings.GroupSchemas;
+using UnityEngine;
+
+namespace Beamable.Editor.ContentService
+{
+	/// <summary>
+	/// Opt-in, user-initiated seeding of Beamable's default content (currency gems/coins) into a
+	/// realm that has never had content published.
+	///
+	/// This replaces the old behaviour where <see cref="CliContentService.Reload"/> silently seeded
+	/// and published default content at editor init time. That ran AssetDatabase / Addressables
+	/// mutation during initialization, which was risky (potential refresh loops). Seeding now only
+	/// happens when the user explicitly asks for it — via the Content Manager empty-state prompt or
+	/// the "Import Default Content" menu item.
+	///
+	/// The currency icons are Addressable sprite references. The seed sprites ship in the
+	/// Unity-ignored <c>DefaultAssets~</c> folder with pinned-GUID meta files; importing copies them
+	/// into the project (where the pinned GUID registers for the first time, avoiding a collision),
+	/// marks them addressable, and only then seeds the content — whose serialized references already
+	/// point at the pinned GUIDs.
+	/// </summary>
+	public static class DefaultContentImporter
+	{
+		private const string DISMISS_PREF_PREFIX = "beamable.contentmanager.defaultcontent.dismissed";
+
+		/// <summary>Per-realm EditorPrefs key controlling whether the in-window prompt is shown.</summary>
+		public static string DismissKey(string cid, string pid) => $"{DISMISS_PREF_PREFIX}.{cid}.{pid}";
+
+		public static bool IsDismissed(string cid, string pid)
+		{
+			if (string.IsNullOrEmpty(cid) || string.IsNullOrEmpty(pid))
+				return false;
+			return EditorPrefs.GetBool(DismissKey(cid, pid), false);
+		}
+
+		public static void SetDismissed(string cid, string pid, bool dismissed = true)
+		{
+			if (string.IsNullOrEmpty(cid) || string.IsNullOrEmpty(pid))
+				return;
+			EditorPrefs.SetBool(DismissKey(cid, pid), dismissed);
+		}
+
+		[MenuItem(Constants.MenuItems.Windows.Paths.MENU_ITEM_PATH_WINDOW_BEAMABLE_UTILITIES + "/Import Default Content")]
+		public static async void ImportDefaultContent_MenuItem()
+		{
+			bool confirmed = EditorUtility.DisplayDialog(
+				"Import Default Content",
+				"This will create Beamable's default content (gems & coins currencies) as local content, " +
+				"copying their icon sprites into Assets/Beamable/DefaultAssets and registering them as " +
+				"Addressables.",
+				"Import",
+				"Cancel");
+
+			if (confirmed)
+			{
+				await ImportDefaultContent();
+			}
+		}
+
+		/// <summary>
+		/// Shared import routine used by both the menu item and the Content Manager prompt. Seeds the
+		/// default content as local content; the user can review and publish it themselves.
+		/// </summary>
+		public static async Task ImportDefaultContent()
+		{
+			var api = BeamEditorContext.Default;
+			await api.InitializePromise;
+			var contentService = api.ServiceScope.GetService<CliContentService>();
+
+			// 1. Ensure Addressables settings exist (GetSettings(true) creates them if missing).
+			var settings = AddressableAssetSettingsDefaultObject.GetSettings(true);
+			if (settings == null)
+			{
+				EditorUtility.DisplayDialog(
+					"Addressables Required",
+					"Beamable's default content uses Unity Addressables for its currency icons, but the " +
+					"Addressables settings could not be created. Please configure the Addressables package " +
+					"and try again.",
+					"OK");
+				return;
+			}
+
+			// 2. Copy seed sprites into the project and register them as addressables (idempotent).
+			if (!EnsureDefaultAssetsImported(settings))
+			{
+				return;
+			}
+
+			// 3. Seed the content locally. The default content's serialized icon references already
+			//    point at the pinned GUIDs, so no per-asset remap is needed.
+			SeedDefaultContent(contentService);
+
+			// 4. Refresh the Content Manager view. The seeded content is left local for the user to
+			//    review and publish on their own terms.
+			await contentService.Reload();
+		}
+
+		/// <summary>
+		/// Copies the seed sprites out of the Unity-ignored source folder into the project and
+		/// ensures each is an entry in the "Beamable Assets" Addressables group. Idempotent: sprites
+		/// already present (by pinned GUID) are reused rather than re-copied.
+		/// </summary>
+		private static bool EnsureDefaultAssetsImported(AddressableAssetSettings settings)
+		{
+			var sourceRoot = ResolveSourceRoot();
+			if (string.IsNullOrEmpty(sourceRoot) || !Directory.Exists(sourceRoot))
+			{
+				EditorUtility.DisplayDialog(
+					"Default Content Unavailable",
+					$"Could not locate the default content seed assets at '{Constants.Directories.DEFAULT_ASSET_SOURCE_DIR}'.",
+					"OK");
+				return false;
+			}
+
+			var knownGuids = new List<string>();
+			var copiedAnything = false;
+
+			foreach (var typeDir in Directory.GetDirectories(sourceRoot))
+			{
+				var typeName = Path.GetFileName(typeDir); // e.g. "currency"
+				var destDir = $"{Constants.Directories.ASSET_DIR}/{typeName}";
+
+				foreach (var src in Directory.GetFiles(typeDir))
+				{
+					if (src.EndsWith(".meta"))
+						continue;
+
+					var metaSrc = src + ".meta";
+					if (!File.Exists(metaSrc))
+						continue; // a pinned-GUID meta is required
+
+					var knownGuid = ReadGuidFromMeta(metaSrc);
+					if (string.IsNullOrEmpty(knownGuid))
+						continue;
+
+					knownGuids.Add(knownGuid);
+
+					// Short-circuit: already imported (by pinned GUID) -> reuse, don't duplicate.
+					var existingPath = AssetDatabase.GUIDToAssetPath(knownGuid);
+					if (!string.IsNullOrEmpty(existingPath) && File.Exists(existingPath))
+						continue;
+
+					Directory.CreateDirectory(destDir);
+					var fileName = Path.GetFileName(src);
+					var dest = Path.Combine(destDir, fileName);
+					File.Copy(src, dest, true);
+					// Copy the pinned-GUID meta so the imported asset keeps the known GUID.
+					File.Copy(metaSrc, dest + ".meta", true);
+					copiedAnything = true;
+				}
+			}
+
+			if (copiedAnything)
+			{
+				AssetDatabase.Refresh();
+			}
+
+			// Ensure the addressables group exists, then ensure each seed sprite is an entry in it.
+			var group = settings.FindGroup(Constants.BEAMABLE_ASSET_GROUP);
+			if (group == null)
+			{
+				group = settings.CreateGroup(
+					Constants.BEAMABLE_ASSET_GROUP,
+					setAsDefaultGroup: false,
+					readOnly: false,
+					postEvent: true,
+					schemasToCopy: new List<AddressableAssetGroupSchema>(),
+					typeof(ContentUpdateGroupSchema), typeof(BundledAssetGroupSchema));
+			}
+
+			var entries = new List<AddressableAssetEntry>();
+			foreach (var knownGuid in knownGuids)
+			{
+				var path = AssetDatabase.GUIDToAssetPath(knownGuid);
+				if (string.IsNullOrEmpty(path))
+				{
+					Debug.LogWarning($"[Default Content] Seed sprite with GUID {knownGuid} did not import; its currency icon may not resolve.");
+					continue;
+				}
+
+				var entry = settings.CreateOrMoveEntry(knownGuid, group);
+				if (entry != null)
+					entries.Add(entry);
+			}
+
+			if (entries.Count > 0)
+			{
+				settings.SetDirty(AddressableAssetSettings.ModificationEvent.EntryMoved, entries, true);
+			}
+
+			return true;
+		}
+
+		/// <summary>
+		/// Loads the default content objects shipped in the package and saves them as local content.
+		/// </summary>
+		private static void SeedDefaultContent(CliContentService contentService)
+		{
+			string[] guids = BeamableAssetDatabase.FindAssets<ContentObject>(new[] { Constants.Directories.DEFAULT_DATA_DIR });
+			foreach (string guid in guids)
+			{
+				string path = AssetDatabase.GUIDToAssetPath(guid);
+				ContentObject obj = AssetDatabase.LoadAssetAtPath<ContentObject>(path);
+				if (obj == null)
+					continue;
+
+				string fileName = Path.GetFileNameWithoutExtension(path);
+				obj.SetContentName(fileName);
+				contentService.SaveContent(obj);
+			}
+		}
+
+		/// <summary>
+		/// Resolves the seed-asset source folder to an absolute path. The folder is "~"-suffixed so
+		/// Unity ignores it; we read it with System.IO. <see cref="Path.GetFullPath"/> resolves the
+		/// "Packages/com.beamable/..." virtual path for embedded/local packages.
+		/// </summary>
+		private static string ResolveSourceRoot()
+		{
+			var relative = Constants.Directories.DEFAULT_ASSET_SOURCE_DIR;
+			if (Directory.Exists(relative))
+				return relative;
+
+			var full = Path.GetFullPath(relative);
+			return Directory.Exists(full) ? full : null;
+		}
+
+		private static string ReadGuidFromMeta(string metaPath)
+		{
+			foreach (var line in File.ReadLines(metaPath))
+			{
+				var trimmed = line.Trim();
+				if (trimmed.StartsWith("guid:"))
+					return trimmed.Substring("guid:".Length).Trim();
+			}
+
+			return null;
+		}
+	}
+}

package/Editor/ContentService/DefaultContentImporter.cs.meta

@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: a0e852440982b4314ad6589271754b95

package/Editor/Modules/Content/DefaultAssets~/currency/coins.png.meta

@@ -0,0 +1,135 @@
+fileFormatVersion: 2
+guid: a7796303ede2490ea179355045c77b7e
+TextureImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 12
+  mipmaps:
+    mipMapMode: 0
+    enableMipMap: 1
+    sRGBTexture: 1
+    linearTexture: 0
+    fadeOut: 0
+    borderMipMap: 0
+    mipMapsPreserveCoverage: 0
+    alphaTestReferenceValue: 0.5
+    mipMapFadeDistanceStart: 1
+    mipMapFadeDistanceEnd: 3
+  bumpmap:
+    convertToNormalMap: 0
+    externalNormalMap: 0
+    heightScale: 0.25
+    normalMapFilter: 0
+  isReadable: 0
+  streamingMipmaps: 0
+  streamingMipmapsPriority: 0
+  vTOnly: 0
+  ignoreMasterTextureLimit: 0
+  grayScaleToAlpha: 0
+  generateCubemap: 6
+  cubemapConvolution: 0
+  seamlessCubemap: 0
+  textureFormat: 1
+  maxTextureSize: 2048
+  textureSettings:
+    serializedVersion: 2
+    filterMode: 1
+    aniso: 1
+    mipBias: 0
+    wrapU: 1
+    wrapV: 1
+    wrapW: 1
+  nPOTScale: 0
+  lightmap: 0
+  compressionQuality: 50
+  spriteMode: 1
+  spriteExtrude: 1
+  spriteMeshType: 1
+  alignment: 0
+  spritePivot: {x: 0.5, y: 0.5}
+  spritePixelsToUnits: 100
+  spriteBorder: {x: 0, y: 0, z: 0, w: 0}
+  spriteGenerateFallbackPhysicsShape: 1
+  alphaUsage: 1
+  alphaIsTransparency: 1
+  spriteTessellationDetail: -1
+  textureType: 8
+  textureShape: 1
+  singleChannelComponent: 0
+  flipbookRows: 1
+  flipbookColumns: 1
+  maxTextureSizeSet: 0
+  compressionQualitySet: 0
+  textureFormatSet: 0
+  ignorePngGamma: 0
+  applyGammaDecoding: 0
+  cookieLightType: 0
+  platformSettings:
+  - serializedVersion: 3
+    buildTarget: DefaultTexturePlatform
+    maxTextureSize: 2048
+    resizeAlgorithm: 0
+    textureFormat: -1
+    textureCompression: 1
+    compressionQuality: 50
+    crunchedCompression: 0
+    allowsAlphaSplitting: 0
+    overridden: 0
+    androidETC2FallbackOverride: 0
+    forceMaximumCompressionQuality_BC6H_BC7: 0
+  - serializedVersion: 3
+    buildTarget: Standalone
+    maxTextureSize: 2048
+    resizeAlgorithm: 0
+    textureFormat: -1
+    textureCompression: 1
+    compressionQuality: 50
+    crunchedCompression: 0
+    allowsAlphaSplitting: 0
+    overridden: 0
+    androidETC2FallbackOverride: 0
+    forceMaximumCompressionQuality_BC6H_BC7: 0
+  - serializedVersion: 3
+    buildTarget: Server
+    maxTextureSize: 2048
+    resizeAlgorithm: 0
+    textureFormat: -1
+    textureCompression: 1
+    compressionQuality: 50
+    crunchedCompression: 0
+    allowsAlphaSplitting: 0
+    overridden: 0
+    androidETC2FallbackOverride: 0
+    forceMaximumCompressionQuality_BC6H_BC7: 0
+  - serializedVersion: 3
+    buildTarget: Android
+    maxTextureSize: 2048
+    resizeAlgorithm: 0
+    textureFormat: -1
+    textureCompression: 1
+    compressionQuality: 50
+    crunchedCompression: 0
+    allowsAlphaSplitting: 0
+    overridden: 0
+    androidETC2FallbackOverride: 0
+    forceMaximumCompressionQuality_BC6H_BC7: 0
+  spriteSheet:
+    serializedVersion: 2
+    sprites: []
+    outline: []
+    physicsShape: []
+    bones: []
+    spriteID: 0b1370abfc5b4c3b81bf007ca6b9664a
+    internalID: 0
+    vertices: []
+    indices: 
+    edges: []
+    weights: []
+    secondaryTextures: []
+    nameFileIdTable: {}
+  spritePackingTag: 
+  pSDRemoveMatte: 0
+  pSDShowRemoveMatteOption: 0
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Editor/Modules/Content/DefaultAssets~/currency/gems.png.meta

@@ -0,0 +1,135 @@
+fileFormatVersion: 2
+guid: 5a08d920469e4ee0a87a745623583807
+TextureImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 12
+  mipmaps:
+    mipMapMode: 0
+    enableMipMap: 1
+    sRGBTexture: 1
+    linearTexture: 0
+    fadeOut: 0
+    borderMipMap: 0
+    mipMapsPreserveCoverage: 0
+    alphaTestReferenceValue: 0.5
+    mipMapFadeDistanceStart: 1
+    mipMapFadeDistanceEnd: 3
+  bumpmap:
+    convertToNormalMap: 0
+    externalNormalMap: 0
+    heightScale: 0.25
+    normalMapFilter: 0
+  isReadable: 0
+  streamingMipmaps: 0
+  streamingMipmapsPriority: 0
+  vTOnly: 0
+  ignoreMasterTextureLimit: 0
+  grayScaleToAlpha: 0
+  generateCubemap: 6
+  cubemapConvolution: 0
+  seamlessCubemap: 0
+  textureFormat: 1
+  maxTextureSize: 2048
+  textureSettings:
+    serializedVersion: 2
+    filterMode: 1
+    aniso: 1
+    mipBias: 0
+    wrapU: 1
+    wrapV: 1
+    wrapW: 0
+  nPOTScale: 0
+  lightmap: 0
+  compressionQuality: 50
+  spriteMode: 1
+  spriteExtrude: 1
+  spriteMeshType: 1
+  alignment: 0
+  spritePivot: {x: 0.5, y: 0.5}
+  spritePixelsToUnits: 100
+  spriteBorder: {x: 0, y: 0, z: 0, w: 0}
+  spriteGenerateFallbackPhysicsShape: 1
+  alphaUsage: 1
+  alphaIsTransparency: 1
+  spriteTessellationDetail: -1
+  textureType: 8
+  textureShape: 1
+  singleChannelComponent: 0
+  flipbookRows: 1
+  flipbookColumns: 1
+  maxTextureSizeSet: 0
+  compressionQualitySet: 0
+  textureFormatSet: 0
+  ignorePngGamma: 0
+  applyGammaDecoding: 1
+  cookieLightType: 1
+  platformSettings:
+  - serializedVersion: 3
+    buildTarget: DefaultTexturePlatform
+    maxTextureSize: 2048
+    resizeAlgorithm: 0
+    textureFormat: -1
+    textureCompression: 1
+    compressionQuality: 50
+    crunchedCompression: 0
+    allowsAlphaSplitting: 0
+    overridden: 0
+    androidETC2FallbackOverride: 0
+    forceMaximumCompressionQuality_BC6H_BC7: 0
+  - serializedVersion: 3
+    buildTarget: Standalone
+    maxTextureSize: 2048
+    resizeAlgorithm: 0
+    textureFormat: -1
+    textureCompression: 1
+    compressionQuality: 50
+    crunchedCompression: 0
+    allowsAlphaSplitting: 0
+    overridden: 0
+    androidETC2FallbackOverride: 0
+    forceMaximumCompressionQuality_BC6H_BC7: 0
+  - serializedVersion: 3
+    buildTarget: Server
+    maxTextureSize: 2048
+    resizeAlgorithm: 0
+    textureFormat: -1
+    textureCompression: 1
+    compressionQuality: 50
+    crunchedCompression: 0
+    allowsAlphaSplitting: 0
+    overridden: 0
+    androidETC2FallbackOverride: 0
+    forceMaximumCompressionQuality_BC6H_BC7: 0
+  - serializedVersion: 3
+    buildTarget: Android
+    maxTextureSize: 2048
+    resizeAlgorithm: 0
+    textureFormat: -1
+    textureCompression: 1
+    compressionQuality: 50
+    crunchedCompression: 0
+    allowsAlphaSplitting: 0
+    overridden: 0
+    androidETC2FallbackOverride: 0
+    forceMaximumCompressionQuality_BC6H_BC7: 0
+  spriteSheet:
+    serializedVersion: 2
+    sprites: []
+    outline: []
+    physicsShape: []
+    bones: []
+    spriteID: dda64ca25ea5446da563ba3807929558
+    internalID: 0
+    vertices: []
+    indices: 
+    edges: []
+    weights: []
+    secondaryTextures: []
+    nameFileIdTable: {}
+  spritePackingTag: 
+  pSDRemoveMatte: 0
+  pSDShowRemoveMatteOption: 0
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Editor/Modules/Content/DefaultContent/currency/coins.asset

@@ -16,7 +16,7 @@ MonoBehaviour:
   - base
   _serializedValidationGUID: 00000000-0000-0000-0000-000000000008
   icon:
-    m_AssetGUID: 819869afaafce0144b1fba88a5e4b040
+    m_AssetGUID: a7796303ede2490ea179355045c77b7e
     m_SubObjectName: 
     m_SubObjectType: 
     m_EditorAssetChanged: 0

package/Editor/Modules/Content/DefaultContent/currency/gems.asset

@@ -16,7 +16,7 @@ MonoBehaviour:
   - base
   _serializedValidationGUID: 00000000-0000-0000-0000-000000000009
   icon:
-    m_AssetGUID: ddded4a9a76c8ff439eab5570826ad89
+    m_AssetGUID: 5a08d920469e4ee0a87a745623583807
     m_SubObjectName: 
     m_SubObjectType: 
     m_EditorAssetChanged: 0

package/Editor/UI/ContentWindow/ContentWindow.cs

@@ -33,6 +33,7 @@ namespace Beamable.Editor.UI.ContentWindow
 		private int _lastManifestChangedCount;
 		private int _lastProgressUpdateVersion;
 		private EditorGUISplitView _mainSplitter;
+		private bool _importingDefaultContent;
 
 		static ContentWindow()
 		{
@@ -215,8 +216,20 @@ namespace Beamable.Editor.UI.ContentWindow
 				return;
 			}
 
-			
-			
+			if (_importingDefaultContent)
+			{
+				DrawBlockLoading("Importing default content...");
+				return;
+			}
+
+			if (ShouldShowDefaultContentPrompt())
+			{
+				DrawDefaultContentPrompt();
+				return;
+			}
+
+
+
 			EditorGUILayout.BeginVertical();
 			_horizontalScrollPosition = EditorGUILayout.BeginScrollView(_horizontalScrollPosition);
 			
@@ -356,6 +369,91 @@ namespace Beamable.Editor.UI.ContentWindow
 			}
 		}
 		
+		/// <summary>
+		/// Whether to offer the opt-in default-content import. Only shown when the realm's remote
+		/// manifest is confirmed empty (not merely still loading or errored), there is no content
+		/// at all yet, and the user hasn't dismissed the prompt for this realm.
+		/// </summary>
+		private bool ShouldShowDefaultContentPrompt()
+		{
+			if (_contentService == null)
+				return false;
+			if (!_contentService.RemoteManifestsLoaded || _contentService.RemoteManifestsErrored)
+				return false;
+			if (_contentService.RemoteManifestCount > 0)
+				return false;
+			if (_contentService.EntriesCache.Count > 0)
+				return false;
+
+			var cid = _cli?.CurrentRealm?.Cid;
+			var pid = _cli?.CurrentRealm?.Pid;
+			if (string.IsNullOrEmpty(cid) || string.IsNullOrEmpty(pid))
+				return false;
+
+			return !DefaultContentImporter.IsDismissed(cid, pid);
+		}
+
+		private void DrawDefaultContentPrompt()
+		{
+			EditorGUILayout.BeginVertical(new GUIStyle(EditorStyles.helpBox)
+			{
+				padding = new RectOffset(12, 12, 12, 12),
+				margin = new RectOffset(10, 10, 10, 10)
+			});
+
+			EditorGUILayout.TextArea(
+				"This realm doesn't have any content yet. " +
+				"\n\n" +
+				"Would you like to import Beamable's default content? This creates the gems and coins " +
+				"currencies and copies their icon sprites into Assets/Beamable/DefaultAssets, " +
+				"registering them as Addressables. The content is added locally so you can review and " +
+				"publish it yourself.",
+				new GUIStyle(EditorStyles.label) { wordWrap = true });
+
+			EditorGUILayout.BeginHorizontal(new GUIStyle
+			{
+				margin = new RectOffset(0, 0, 12, 12)
+			});
+
+			EditorGUILayout.Space(5, true);
+			EditorGUILayout.Space(5, true);
+
+			var clickedNotNow = BeamGUI.CancelButton("Not now");
+			var clickedImport = BeamGUI.PrimaryButton(new GUIContent("Import"));
+
+			EditorGUILayout.EndHorizontal();
+			EditorGUILayout.EndVertical();
+
+			if (clickedNotNow)
+			{
+				DefaultContentImporter.SetDismissed(_cli?.CurrentRealm?.Cid, _cli?.CurrentRealm?.Pid);
+				Repaint();
+			}
+			else if (clickedImport)
+			{
+				StartDefaultContentImport();
+			}
+		}
+
+		private async void StartDefaultContentImport()
+		{
+			if (_importingDefaultContent)
+				return;
+
+			_importingDefaultContent = true;
+			Repaint();
+			try
+			{
+				// Awaited continuations resume on Unity's main-thread synchronization context.
+				await DefaultContentImporter.ImportDefaultContent();
+			}
+			finally
+			{
+				_importingDefaultContent = false;
+				Repaint();
+			}
+		}
+
 		private List<LocalContentManifestEntry> GetCachedManifestEntries()
 		{
 			var localContentManifestEntries = new List<LocalContentManifestEntry>();

package/Runtime/Environment/Resources/env-default.json

@@ -5,5 +5,5 @@
     "beamMongoExpressUrl": "https://storage.beamable.com",
     "dockerRegistryUrl": "https://microservices.beamable.com/v2/",
     "isUnityVsp": "false",
-    "sdkVersion": "5.1.0-PREVIEW.RC7"
+    "sdkVersion": "5.1.0-PREVIEW.RC8"
 }

package/Runtime/UI/Sprites/icon_gem.png.meta

@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: ddded4a9a76c8ff439eab5570826ad89
+guid: dac36b6d57bb4448398ce9232f5bde36
 TextureImporter:
   internalIDToNameTable: []
   externalObjects: {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "com.beamable",
-  "version": "5.1.0-PREVIEW.RC7",
+  "version": "5.1.0-PREVIEW.RC8",
   "displayName": "Beamable",
   "description": "A better way to build games in Unity\n",
   "unity": "2021.3",