Second commit

2026-09-20 15:26:03 +03:00
commit 36840f3ad4
@@ -0,0 +1,50 @@
+//
+// This file is part of the Tremble package by Tiny Goose.
+// Copyright (c) 2024-2026 TinyGoose Ltd., All Rights Reserved.
+//
+
+using UnityEngine;
+
+namespace TinyGoose.Tremble.Editor
+{
+	[ManualPage("Troubleshooting/'dylib can't be opened' (macOS only)")]
+	public class TroubleshootingDLLPage : ManualPageBase
+	{
+		protected override void OnGUI()
+		{
+			Image("T_Manual_Trouble_DLL1", width: 200f);
+
+			Text(
+				"This can sometimes occur because Q3Map2, the converter which transforms your .map",
+				"file into something Tremble can understand, is not currently signed.",
+				"(this may change in future!)"
+			);
+
+			Text(
+				"It's a warning from macOS that you may not wish to trust the Q3Map2 binary."
+			);
+
+			Foldout("Why should I trust it?", () =>
+			{
+				Bullet("Q3Map2 is distributed with Tremble from the Asset Store and is safe to use");
+				Bullet("You can verify the source code OR build your own Q3Map2 library, if you prefer");
+
+				ActionBar_SingleAction("Verify Q3Map2 source on Github", () => Application.OpenURL("https://github.com/tinygooseuk/q3map2/tree/libq3map2"));
+			});
+
+			H1("To fix the error, do the following:");
+
+			Number("Click 'Done' to close the 'can't be opened' dialogue");
+			Number("Open 'System Settings' on your Mac, and scroll down to 'Privacy & Security' in the left sidebar");
+			Number("Scroll down to 'Security', and click 'Allow Anyway'");
+
+			Image("T_Manual_Trouble_DLL2");
+
+			Number("You may be prompted to enter your password or use Touch ID. Do so");
+			Number("Close System Settings and return to Unity");
+			Number("Try to import the map again. You will see the same error, but this time there will be an 'Open' button. Click 'Open'");
+
+			Text("This should now work!");
+		}
+	}
+}
@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: 4dcb872d73a04f568fdea7a559b18319
+timeCreated: 1723448843
+AssetOrigin:
+  serializedVersion: 1
+  productId: 277805
+  packageName: Tremble - Map Importer
+  packageVersion: 1.11.1
+  assetPath: Assets/Tremble/Editor/Manual/Pages/Troubleshooting/TroubleshootingDLLPage.cs
+  uploadId: 939664
@@ -0,0 +1,32 @@
+//
+// This file is part of the Tremble package by Tiny Goose.
+// Copyright (c) 2024-2026 TinyGoose Ltd., All Rights Reserved.
+//
+
+using UnityEngine;
+
+namespace TinyGoose.Tremble.Editor
+{
+	[ManualPage("Troubleshooting/Get Help & Support")]
+	public class TroubleshootingGetHelpPage : ManualPageBase
+	{
+		protected override void OnGUI()
+		{
+			H1("Discord");
+			Text(
+				"If you need help, please first join us on our Discord server:",
+				"https://discord.gg/aUTmYxbVHZ."
+			);
+
+			ActionBar_SingleAction("Open Discord", () => Application.OpenURL("https://discord.gg/aUTmYxbVHZ"));
+
+			H1("Email Support");
+			Text(
+				"For further assistance, or if you do not have access to Discord, do",
+				"not hesitate to contact us at: hello@tinygoose.com."
+			);
+
+			ActionBar_SingleAction("Send Email", () => Application.OpenURL("mailto:hello@tinygoose.com"));
+		}
+	}
+}
@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: ce80159b60eb429c822dbbab4c39d44b
+timeCreated: 1723448946
+AssetOrigin:
+  serializedVersion: 1
+  productId: 277805
+  packageName: Tremble - Map Importer
+  packageVersion: 1.11.1
+  assetPath: Assets/Tremble/Editor/Manual/Pages/Troubleshooting/TroubleshootingGetHelpPage.cs
+  uploadId: 939664
@@ -0,0 +1,56 @@
+//
+// This file is part of the Tremble package by Tiny Goose.
+// Copyright (c) 2024-2026 TinyGoose Ltd., All Rights Reserved.
+//
+
+using UnityEditor;
+
+namespace TinyGoose.Tremble.Editor
+{
+	[ManualPage("Troubleshooting/Too dark or too bright materials")]
+	public class TroubleshootingMaterialBrightnessPage : ManualPageBase
+	{
+		protected override void OnGUI()
+		{
+			Image("T_Manual_Trouble_MaterialBrightness");
+
+			Text("Some users experience issues with materials exporting too bright or too dark when",
+				"viewed in TrenchBroom. This can be due to the way Tremble captures Unity Materials to",
+				"texture PNGs - which uses specific lighting, but can sometimes take on the environment",
+				"from your scene.");
+
+			Text("Please note that this does NOT affect how your materials will appear in Unity/your game!");
+
+			Text("As a workaround, you can adjust how Tremble lights your materials in Tremble's Settings,",
+				"under Advanced/Materials.");
+
+			Callout("When changing these settings or force-resyncing below, note that you should",
+				"Refresh Texture Collections (F5) and Refresh Entity Definitions (F6) in TrenchBroom",
+				"to update to the latest data.");
+
+			Image("T_Manual_Trouble_MaterialBrightnessSettings");
+
+			ActionBar_SingleAction("Open in Settings", ()
+				=> SettingsService.OpenProjectSettings("Project/Tremble/4 Advanced/3 Materials"));
+
+			Text("As a last resort, you can also try force-syncing your project to TrenchBroom. You can do this",
+				"by clearing the cache and then re-syncing, from Tools > Tremble > Sync Project to TrenchBroom (Clean, Slow)",
+				"- or by pressing the button below.");
+
+			ActionBar_SingleAction("Force-resync for me", ()=>
+			{
+				TrembleEditorAPI.InvalidateMaterialAndPrefabCache(silent: true);
+				TrembleEditorAPI.SyncToTrenchBroom();
+
+				if (TrenchBroomUtil.IsTrenchBroomRunning)
+				{
+					EditorUtility.DisplayDialog(
+						title: "TrenchBroom is running",
+						message: "You may need to refresh Textures and Entities in TrenchBroom (press F5, then F6 in TrenchBroom)!",
+
+						"Oh, okay!");
+				}
+			});
+		}
+	}
+}
@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: ef8cfc4d6b7b43baa6078bbb722dca8f
+timeCreated: 1723448882
+AssetOrigin:
+  serializedVersion: 1
+  productId: 277805
+  packageName: Tremble - Map Importer
+  packageVersion: 1.11.1
+  assetPath: Assets/Tremble/Editor/Manual/Pages/Troubleshooting/TroubleshootingMaterialBrightnessPage.cs
+  uploadId: 939664
@@ -0,0 +1,57 @@
+//
+// This file is part of the Tremble package by Tiny Goose.
+// Copyright (c) 2024-2026 TinyGoose Ltd., All Rights Reserved.
+//
+
+using UnityEngine;
+
+namespace TinyGoose.Tremble.Editor
+{
+	[ManualPage("Troubleshooting/Missing Geometry")]
+	public class TroubleshootingMissingGeoPage : ManualPageBase
+	{
+		private const float IMAGE_WIDTH = 300f;
+
+		protected override void OnGUI()
+		{
+			Text("If you create an area in a map that is completely enclosed (known in the mapping",
+				"community as being 'sealed'), you might find that Tremble culls the",
+				"inside of these areas entirely!");
+
+			GUILayout.BeginHorizontal();
+			{
+				Bold("TrenchBroom (before):", width: IMAGE_WIDTH);
+				Bold("Unity (before):", width: IMAGE_WIDTH);
+			}
+			GUILayout.EndHorizontal();
+
+			GUILayout.BeginHorizontal();
+			{
+				Image("T_Manual_MissingGeo_TB1", width: IMAGE_WIDTH, centred: false);
+				Image("T_Manual_MissingGeo_Unity1", width: IMAGE_WIDTH, centred: false);
+			}
+			GUILayout.EndHorizontal();
+
+			Text("This is because Q3Map2 (the map compiler) determines that these areas can never",
+				"be reached, and thus is unnecessary geometry.");
+
+			Text("In order to keep this geometry around, you need to place a Point or Brush entity",
+				"(or a prefab) inside this area. Tremble will no longer cull the area, as it",
+				"determines that there are gameplay elements inside the area and thus it is important.");
+
+			GUILayout.BeginHorizontal();
+			{
+				Bold("TrenchBroom (after):", width: IMAGE_WIDTH);
+				Bold("Unity (after):", width: IMAGE_WIDTH);
+			}
+			GUILayout.EndHorizontal();
+
+			GUILayout.BeginHorizontal();
+			{
+				Image("T_Manual_MissingGeo_TB2", width: IMAGE_WIDTH, centred: false);
+				Image("T_Manual_MissingGeo_Unity2", width: IMAGE_WIDTH, centred: false);
+			}
+			GUILayout.EndHorizontal();
+		}
+	}
+}
@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: 2319b986770f4d8c9ddcbb9b6d37ba62
+timeCreated: 1724754283
+AssetOrigin:
+  serializedVersion: 1
+  productId: 277805
+  packageName: Tremble - Map Importer
+  packageVersion: 1.11.1
+  assetPath: Assets/Tremble/Editor/Manual/Pages/Troubleshooting/TroubleshootingMissingGeoPage.cs
+  uploadId: 939664
@@ -0,0 +1,34 @@
+//
+// This file is part of the Tremble package by Tiny Goose.
+// Copyright (c) 2024-2026 TinyGoose Ltd., All Rights Reserved.
+//
+
+using UnityEngine;
+
+namespace TinyGoose.Tremble.Editor
+{
+	[ManualPage("Troubleshooting/Pink materials in TrenchBroom")]
+	public class TroubleshootingPinkMaterialsPage : ManualPageBase
+	{
+		protected override void OnGUI()
+		{
+			Text("Pink materials can appear in either Unity or TrenchBroom, and they indicate that",
+				"a Material or Shader could not be found.");
+
+			Image("T_Manual_Trouble_PinkMaterials");
+
+			H1("For your own materials/textures not rendering");
+			Text("Try to run Map Repair on the map with pink materials. You will be able to swap the",
+				"missing materials for valid ones.");
+			ActionBar_SingleAction("Open Map Repair", MapRepairWindow.OpenMapRepair);
+
+			H1("For Tremble sample materials not rendering, under URP or HDRP");
+			Text("Tremble's sample project materials are built for the Built-In Render Pipeline.",
+				"This means, if you're using URP or HDRP, you should manually upgrade them to your pipeline.");
+
+			Text("There's a great tutorial for this by SpawnCampGames on YouTube:");
+			Image("T_Manual_Trouble_FixPinkMaterialsVideo");
+			ActionBar_SingleAction("Open Video", () => Application.OpenURL("https://www.youtube.com/watch?v=V_EGF1M3fgY"));
+		}
+	}
+}
@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: 8a86dbcdd6714f008d781a4d19f04b82
+timeCreated: 1723453626
+AssetOrigin:
+  serializedVersion: 1
+  productId: 277805
+  packageName: Tremble - Map Importer
+  packageVersion: 1.11.1
+  assetPath: Assets/Tremble/Editor/Manual/Pages/Troubleshooting/TroubleshootingPinkMaterialsPage.cs
+  uploadId: 939664