Documenting the dark corners of the Unity Engine. https://uninomicon.com/ 2026-04-05T02:27:19+00:00 https://uninomicon.com/ https://uninomicon.com/_media/wiki/logo.png text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/animation_rigging_package?rev=1736915747&do=diff Animation Rigging (Package) The new Unity animation system. It uses burst, which makes it speedy. General Notes: * The RigBuilder component is so called because it “Builds” a hierarchy of constraints into a set of AnimationJobs. * The RigBuilder Build step happens on Awake text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/assetmodificationprocessor?rev=1736915747&do=diff AssetModificationProcessor IsOpenForEdit * assetOrMetaFilePaths contains either the asset.meta file (when clicking on imported files), or the asset file path (when clicking on unity assets). * assetOrMetaFilePaths never seems to contain more than one asset, even if multiple assets are selected. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/asyncgpureadback?rev=1736915747&do=diff AsyncGPUReadback Metal/iOS In at least 2018.2 and possibly other versions there appears to be an undocumented bug that readback requests mess with the command buffer: * Readback requests inserted in the middle will split the command buffer, however the second part will have LoadAction=Clear which destroys everything rendered before the request text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/buildreport?rev=1736915747&do=diff BuildReport General Notes: * Use the Build Report Inspector tool to debug builds. * The “Source Assets” category does not necessarily imply the asset was actually included in the build. text/html 2025-05-27T20:33:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/camera?rev=1748377997&do=diff Camera Camera.SetReplacementShader SetReplacementShader will not render objects if their original materials don't contain any properties required by the replacement shader. For example, if your replacement shader uses _MainTex, and there is an object in the scene that doesn't have _MainTex, it won't be rendered at all. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/churn?rev=1736915747&do=diff Churn 'Churn' is a short hand for un-necessary changes Unity saves into in a file (usually a Unity scene file). It is usually used to describe any changes that show up in version control, that are un-related to the real changes you made in the file. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/computeshader?rev=1736915747&do=diff ComputeShader FindKernel On Android standalone when using the OpenGLES2 Graphics API (which does not support compute shaders), this function throws an exception (documentation says “error”, which is wrong). This cannot be reproduced in the editor with feature level emulation enabled. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/constraintmanager?rev=1736915747&do=diff ConstraintManager An internal Unity system that evaluates all of the “Constraint” components in a scene. Beyond applying the constraint the ConstraintManager also sorts constraints based on dependencies, in order to avoid drift caused by non-optimal order of evaluation. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/debug?rev=1736915747&do=diff Debug Console messages: * Any class whose name ends with “Logger” that implements a method starting with “Log” is ignored by the console's double click, unless it is the last call in the stack trace. From: Reddit Thread text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/defaultexecutionorder?rev=1736915747&do=diff DefaultExecutionOrder An undocumented attribute that modifies the execution order of all event functions in a MonoBehaviour class. This functionality is identical to the Script Execution Order settings in the Project Settings window, except that it's encoded directly in the script instead of through the editor. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/editorconnection?rev=1736915747&do=diff EditorConnection The EditionConnection class controls the editor-side of the Player/Editor network bridge used for letting the player talk to the editor. Connects fail when using Patch + Run on Android The port used to connect the player to the editor is stored within the Android data files. These are placed in the text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/editorscenemanager?rev=1736915747&do=diff EditorSceneManager It's like SceneManager but only in the editor and provides a bunch more hooks. EditorSceneManager.sceneOpened - Is not called when the project is first opened in the editor and the initial scene is loaded. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/entities.content?rev=1736915747&do=diff Entities.Content This is a sub-package of the Entities package that contains a Content/Asset loading system, written mostly in Burstable code. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/entities.scenes?rev=1736915747&do=diff Entities.Scenes SerializeUtility SerializeUtility is responsible for writing entire Worlds to disk. It is written specifically for serializing Subscene Sections to disk in the editor, and then for streaming them in efficiently during runtime. It can support other use cases, but it is not designed to. text/html 2025-08-11T23:26:59+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/fbx_importing?rev=1754954819&do=diff FBX Importing Importing FBX files in Unity with the correct scale, rotation, and axis is fraught. If you are just looking for a quick way to get models importing into Unity properly, take a look at the Pontoco Import/Export Settings. The FBX Sanitizer tool can be used to validate an FBX file to verify that it will import into Unity with correct scale and rotation. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/fixedupdate?rev=1736915747&do=diff Fixed Update Unity will run the first FixedUpdate, regardless of what Time.fixedDeltaTime is set to. ie. If you set fixedDeltaTime to 10 in Awake of the first scene, the FixedUpdate will still run. The maximum value of Time.fixedDeltaTime seems to be 10. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/globalobjectid?rev=1736915747&do=diff GlobalObjectId Every object in the Editor has a distinct GlobalObjectId. This is (effectively) the identifier Unity uses to hold references to other objects. It is guaranteed to be unique and stable between editor sessions. GlobalObjectIds are not available at runtime. However, they are available in Play Mode in the editor. If you use these in play mode, keep in mind the notes on prefabs below. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/hingejoint?rev=1736915747&do=diff HingeJoint * HingeJoint does not constrain the absolute rotation or localRotation of the Transform that it is attached to. It constrains the relative rotation between its own RigidBody and the Rigidbody in the ConnectedBody field. * HingeJoint.angle text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/ienumerator?rev=1736915747&do=diff IEnumerator Notes on the underlying implementation of C# generators (which are used in Unity for coroutines). You can use SharpLab to view the decompiled C# from a simple generator, to help understand the transformation that is happening. Both .NET and Mono do seem to use the same compiler transformation when turning Generators into anonymous IEnumerator classes. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/il2cpp?rev=1736915747&do=diff IL2CPP IL2CPP is Unity's Ahead of Time (AOT) for C#. Analysis Tools Il2CppInspector - Provides detailed information about a Unity application compiled with IL2CPP. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/ipreprocessbuildwithreport?rev=1736915747&do=diff IPreprocessBuildWithReport OnPreprocessBuild Changes to EditorBuildSettings.scenes will not take effect until the next invocation. The build process seems to read that list before it gets to triggering the callbacks. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/library?rev=1736915747&do=diff Library Folder The library folder is a large cache containing imported assets and other data from the project after import. It is generally always 100% safe to delete the Library folder. As Unity has become more stable, this has become much less necessary than it once was. It is also possible to remove some subfolders without requiring to delete the entire Library folder and have it re-import/re-compile everything.xssss text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/lightingdataasset?rev=1736915747&do=diff Lighting Data Asset aka Lightmapping.lightingDataAsset This asset stores data related to a lightmapping bake. This includes: * The Light Probes for all scenes * Lightmap Scale and Transform for MeshRenderers Just after a scene loads, Unity will read this data asset and apply the settings from it to restore the lightmapping. This happens in the player and at runtime. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/lightmapsettings.lightprobes?rev=1736915747&do=diff Light Probes * Unity stores the probes for all loaded scenes into the LightingData.asset file, even when baking only a single scene. LightmapSettings.lightProbes Honestly, I'm still fairly fuzzy on how this field works. Here's the best of my knowledge. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/meshcollider?rev=1736915747&do=diff MeshCollider MeshCollider.sharedMesh This is the source mesh provided by the user on the component itself, even when the MeshCollider is set to “Convex,” and is using a convex hull of this mesh for collision. The convex hull mesh is not accessible. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/meshrenderer?rev=1736915747&do=diff MeshRenderer MeshRenderer.realtimeLightmapIndex The 'realtime' in this variable refers to the Unity Realtime GI system (aka Enlighten realtime GI). See also <https://forum.unity.com/threads/realtime-lightmap-what-is-that-exactly.592435/> text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/metafiles?rev=1736915747&do=diff Meta Files Unity uses .meta files for each asset you add to a project. These contain a GUID (unique identifier) and additional information about _how_ an asset should be imported, e.g. max texture size, compression settings, ... everything you change in the importer. All the information required to reconstruct the Library representation of an asset is stored in the meta file. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/monobehaviour?rev=1736915747&do=diff MonoBehaviour Event Functions Reset() * Reset is only called in editor mode. * Very useful to setup values for your attributes, i.e. find a child component. * Use it with the RequireComponent attribute to always get a reference for your component. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/navmeshagent?rev=1736915747&do=diff NavMeshAgent NavMeshAgent.remainingDistance This function does only respond with the current remaining distance if the path is straight. It will thus return null or infinite instead of the correct distance (as defined on the Unity documentation). There is a way to calculate the real distance by combining all calculated paths but keep in mind that this is performance heavy. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/objectlayout?rev=1736915747&do=diff Object Layout WARNING: This is an extremely advanced subject, and is not recommended for users unfamiliar with unsafe code or C++. All classes that inherit from UnityEngine.Object are actually wrappers for a native object on the C++ side of the engine. The address of the native object is stored in the class, as seen in the layout below: text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/physicmaterial?rev=1736915747&do=diff PhysicMaterial Friction values Physic Material is a small data object that can be attached to Colliders to provide parameters for their collision behavior. If NVidia PhysX is being used , static and dynamic friction values operate according to the Coulomb model of friction. For a Rigidbody sliding horizontally across another collider, the text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/physics_determinism?rev=1736915747&do=diff Physics Determinism Limited Determinism Unity uses the PhysX engine for physics, and because of this, Unity physics provides Limited Determinism. If a game executes the exact same set of physics API calls using the exact same frame timing, the engine will be perfectly deterministic, globally. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/physics?rev=1736915747&do=diff Physics Physics.CapsuleCast Physics.CapsuleCastAll CapsuleCast may sometimes return invalid an 'invalid hit', where hit.distance == 0 and hit.point == (0,0,0) . By the documentation, this should only happen when the starting cast position already overlaps a target geometry. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/physicscallbacks?rev=1736915747&do=diff Physics Callbacks OnTriggerEnter * Will be called for all collisions for all trigger colliders on this Rigidbody. * There is no way to get a reference to 'this' trigger collider that was entered. OnTriggerExit * Is not called when a Rigidbody which is part of the collision is destroyed. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/playerloop?rev=1736915747&do=diff PlayerLoop The player loop is the configurable set of operations that make up the Unity Frame Loop. The default Player Loop comes with a variety of different subsystems, but the documentation is extraordinarily lacking. Sub Systems Initialization.InputSystemPlayerLoopRunnerInitializationSystem text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/pptr?rev=1736915747&do=diff PPtr This page needs more research, and is partially based on speculation. This is a type that is used to reference Unity Objects in the Unity serialized data format. It is likely that this is a type only on the native side. This type can appear in error messages as well as when querying a text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/prefabs?rev=1736915747&do=diff Prefabs Stray Notes: * In the Editor, if you have a reference to a Component or GameObject inside a PrefabInstance GameObject, and you unpack the Prefab completely, your old reference will still be valid. The new unpacked objects will have new GlobalObjectIds though. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/project_search?rev=1736915747&do=diff Search Box Syntax This pages details the syntax for the built-in search boxes, not the new Quick Search package. The search box exists in the Project tab and the Hierarchy tab. There are a few non-documented options that it supports. Note: The glob syntax applies to asset paths, not asset names. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/raycasthit2d?rev=1736915747&do=diff RaycastHit2D Casts Implicitly To a Bool RaycastHit2D implements the C# implicit bool operator. This allows it to be used in an if statement to check whether a hit is found. public static implicit operator bool(RaycastHit2D hit) => (Object) hit.collider != (Object) null; text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/recttransformutility?rev=1736915747&do=diff RectTransformUtility RectangleContainsScreenPoint When using this method on a RectTransform in a Screenspace Overlay Canvas, pass in null for the camera parameter. Passing in a camera can return false-negatives. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/reflectionprobe?rev=1736915747&do=diff ReflectionProbe * Probe cubemaps are baked and stored as 6×1 horizontal strip images. I'm not aware of any other tools that use this format. This can make it quite difficult to use these images with other tools. * bakedTexture represents the texture that is baked via Unity's lightmapping tools. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/rendersettings?rev=1736915747&do=diff RenderSettings RenderSettings is a static class that modifies a Unity Object with some scene-specific settings. Interestingly, this means you can query the RenderSettings object directly by invoking the private static method “GetRenderSettings()”. That object can then be modified using a text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/runtimeinitializeonload?rev=1736915747&do=diff RuntimeInitializeOnLoadMethod The documentation is not correct about this function running after awake. It does by default, but not if you specify a load type: The order of callbacks is: * SubsystemRegistration * AfterAssembliesLoad * BeforeSplashScreen text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/scenemanager?rev=1736915747&do=diff SceneManager When does scene loading happen? Scene loading and unloading happens at the start of the Update loop, within the EarlyUpdate.UpdatePreloading phase of the PlayerLoop, and once during the Initialization phase of the player, before the first Update loop. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/sceneview?rev=1736915747&do=diff SceneView SetSceneViewShaderReplace A simple wrapper for Camera.SetReplacementShader. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/scriptableobject?rev=1736915747&do=diff ScriptableObject * private fields on ScriptableObjects will be serialized and restored during a domain reload in the Editor. * You can prevent this by adding the [NonSerialized] attribute on the field. * Awake() on ScriptableObjects is called when an instance of the ScriptableObject is created (such as by text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/scriptedimporter?rev=1736915747&do=diff ScriptedImporter Hiding Sub-Assets in the Project View By default, assets added via ctx.AddObjectToAsset will be shown in the foldout of the imported asset in the Project view. This can be cluttered. You can hide sub assets in two ways: ScriptableObjects text/html 2025-07-26T22:37:48+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/serializeddictionary?rev=1753569468&do=diff Serialized Dictionary Unity has at least two Serialized Dictionary implementations but they are rather hidden UnityEngine.Rendering.SerializedDictionary Unity.XR.CoreUtils.Collections.SerializedDictionary text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/serializedobject?rev=1736915747&do=diff SerializedObject Getting/Setting Managed References Getting a managed reference out of a SerializedProperty is very challenging. It's better to just use C# reflection on the original object and force the asset / object to re-save. See: * <https://forum.unity.com/threads/setting-a-serializedproperty-to-a-struct.521752/> * <https://answers.unity.com/questions/1347203/a-smarter-way-to-get-the-type-of-serializedpropert.html> text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/serializedproperty?rev=1736915747&do=diff SerializedProperty Array size for multi-object editing SerializedProperty.arraySize is said to return the smallest number of elements when editing multiple objects at the same time, but the docs are incorrect about that. It will return the array size of the first of the SerializedObject's targets, even if it's not the smallest. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/shadercompiler?rev=1736915747&do=diff Shader Compiler Bug: Samplers are incorrectly stripped when used with stripped Texture2D Consider this code: #pragma shader_feature_local_fragment _ _ALBEDO; TEXTURE2D(_Albedo); TEXTURE2D(_Normal); SAMPLER(sampler_Albedo); half4 Frag(v2f i) { #if _ALBEDO return SAMPLE_TEXTURE2D(_Albedo, sampler_Albedo, i.uv); #endif return SAMPLE_TEXTURE2D(_Normal, sampler_Albedo, i.uv); // we share the albedo sampler } text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/shadergraph?rev=1736915747&do=diff Shader Graph * (Hack) Custom Nodes can inject pragmas and other top-level shader code, by closing the function, and then re-opening and empty one. <https://twitter.com/hybridherbst/status/1388147666106847237> text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/shaderkeyword?rev=1736915747&do=diff Shader Keywords Recommended reading: * <https://docs.unity3d.com/Manual/SL-MultipleProgramVariants.html> Shader Variant Fallbacks Keywords will only take effect if a shader variant is present in the build with that exact set of keywords enabled. If you set the keywords: cmd.EnableShaderKeyword("_KEYWORD1"); cmd.EnableShaderKeyword("_KEYWORD2"); cmd.EnableShaderKeyword("_KEYWORD3"); text/html 2025-01-19T04:20:25+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/start?rev=1737260425&do=diff The Uninomicon Documented here are the dark, scientific secrets of the Unity Engine. Unity is a very complex beast, and much of its behavior is undocumented. While this is often for good reason, many of us still find ourselves doing research into the precise operation of Unity APIs. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/static_batching?rev=1736915747&do=diff Renderer Batching There are a few different ways that Unity can combine meshes together, for optimization: * “Static Batching” - The checkbox in the Unity Player Settings. Can be done on build or at runtime . * “Dynamic Batching” - A now-outdated mode of runtime batching. Not recommended. text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/texture2d?rev=1736915747&do=diff Texture2D Undocumented Constructor Texture2D has an undocumented constructor with an integer mipmap count, instead of just a bool for the whole mipchain, that is: new Texture2D(int width, int height, TextureFormat format, int numMips, bool isLinear) text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/time?rev=1736915747&do=diff Time General Notes * Time.frameCount is equal to 0 before the first update. (ie. During Initialization and Awakening of the first scenes) * Application.targetFrameRate uses Sleep(), and is not suitable for high frame rate applications. Recommended Reading text/html 2026-04-01T21:10:24+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/unity_build_information_detection?rev=1775077824&do=diff доставка на дом спиртного круглосуточно Может быть полезным: <https://premialco.com> или служба доставки алкоголя ночная доставка алкоголя text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/unitywebrequest?rev=1736915747&do=diff UnityWebRequest Local Filesystem Requests When using UnityWebRequest to load from the local filesystem: * macOS and iOS require that file:⁄⁄ be prepended to the location. * Android must not have file:⁄⁄ prepended. * Windows does not require text/html 2025-01-15T04:35:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://uninomicon.com/yamlmerge?rev=1736915747&do=diff Unity YAMLMerge Unity provides a tool for merging scene and prefab files called Unity YAMLMerge. Recommended Reading: * <https://docs.unity3d.com/Manual/SmartMerge.html> Notes * YamlMerge does not function properly with the new “Serialize Inline Mappings On One Line” Editor Setting. YamlMerge will always output inline mappings on two lines, as if this setting were disabled.