06UI
The binding is broken and the screen still looks fine
A failed UI Toolkit binding does not raise an error. It leaves your design-time text in place, which is the last bug anyone finds.
9 min↗
Unity troubleshooting guides
When input stops, assets disappear, or frames drop
Unity 6 troubleshooting that starts from the real error: Input System, SerializeField, URP pink materials, coroutines, Addressables, and build failures.
Browse the guides ↓Unity version · official source · review scope
Recently checked guides5 guides
07Build & deploy
Why you do not hand-delete a test file that shipped
A release validator on another engine's project caught a development test file. Deleting it was not the fix; rebuilding was.
7 min↗
08Devlog
Keeping a thumb tremor from firing the volley: a DPI-aware tap/drag gate
Ice Breaker fires the volley when a drag is released. To keep a thumb tremor or a small tap from launching it, only a drag whose peak travel reaches or exceeds the threshold counts as an aim gesture; the threshold is max(22px, dpi×0.10). A PlayMode test pins both sides of the boundary.
6 min↗
09Asset management
Two paths to settle before you turn on remote content
Mix up build path and load path and the build succeeds while the device gets a 404. After a release it is hard to undo.
11 min↗
10Devlog
Recycling balls instead of destroying them: a test that pins what the pool must not leak
An Ice Breaker volley starts at 10 balls and pickups can grow it to a hard 99 ceiling. Instead of creating and destroying that set every volley, the design returns balls to a pool to reduce creation and allocation work. The real risk is live state leaking into the next volley, so a PlayMode test locks the counter round trip.
6 min↗
11Build & deploy
Why an update build fails at upload, not at review
These are the fields we checked shipping our 1.0.1 update. Most rejections happen at upload, before any review.
8 min↗
12Devlog
A combo that was only displayed becomes score: lock the multiplier ladder with EditMode tests
Ice Breaker measured a combo, flashed a badge and threw the number away. Adding a 1·2·3·5 ladder kept scores below the first tier unchanged and pinned every threshold in EditMode tests.
6 min↗
13Graphics
Porting exactly one custom pass to render graph
Hand-written URP passes tend to break in the same place under render graph: wherever they grabbed the camera target directly.
12 min↗
14Testing
A 102 pixel screenshot failure that was not a regression
We hit this first on a project built in another engine. A reference frame that depends on saved progress is not a baseline.
9 min↗
15Devlog
An upgrade recipe is not enough: test whether the required cards can appear
Ice Breaker keeps a primary ability and its support available in a 12-turn run. Test the route to an evolution as well as the final condition.
6 min↗
16Editor
Three files to read before you raise the Editor version
Unity Korea covered what changed in the 6.3 LTS Editor. Before the new features, check what your own project can lose.
10 min↗
17Devlog
Unity aiming UI: estimate the first hit without promising the whole volley
Ice Breaker shows target HP, first-hit damage and a conditional hit count. Keep a one-bounce aim query separate from a full volley prediction.
6 min↗
18Build & deploy
The first thing we cut from a heavy WebGL build
Trimming our brick breaker's WebGL build started with textures out of habit. The report said audio.
8 min↗
19Build & deploy
What bites first when you build without opening the Editor
Command line builds usually fail quietly. Pin down the log file and the exit code before tuning any other argument.
9 min↗
20Animation
Animator transition never fires even though the condition is met
Has Exit Time, parameter types, and trigger consumption timing block transitions more often than wrong conditions. Walk the transition inspector up to live values.
8 min↗
21Graphics
Pixel art looks blurry when scaled (smudged sprites)
90% of the blur lives in import settings: filtering and compression. Point filtering, no compression, no mip maps, and integer scaling fix it.
7 min↗
22Editor
Multiple precompiled assemblies errors after importing a package
The same DLL exists twice in the project. The error names the file, so find both locations and keep exactly one.
7 min↗
23Input
UI buttons stop responding after switching to Input System
Game input can work while UI pointers are dead: UI is a separate module. Swapping the EventSystem module and assigning the actions asset fixes most cases in a minute.
7 min↗
24Build
Android build fails with Gradle dependency conflicts (Duplicate class)
The error message names the culprit. Identify the clashing library, pin one version, and enforce it through the template in three steps.
8 min↗
25Mobile UX
On a phone, the dialogue needed the space more than the menu
Four controls stayed in the quick bar, with saving and the Gallery inside Menu. A real round trip exposed an About/Return overlap, so we adjusted the phone-menu padding.
5 min↗
26Assets
Addressables loads fail after building (Invalid Key, catalog mismatch)
Often the key is fine and the catalog/bundle is simply the last successful build's. Verify the rebuild order, the key kind, and profile consistency in that order.
9 min↗
27Serialization
When a Dictionary does not appear in the Unity 6.6 Inspector
Unity 6.6 serializes Dictionary fields directly, but only when the declared type and SerializeField opt-in are correct. Nested collections and Prefab Overrides add a few important boundaries.
8 min↗
28Graphics
URP particles and shaders visible in Editor but missing in build
The build most likely stripped shader variants the scene never referenced at build time. Narrow it down with the stripping rules, Always Included Shaders, and a variant collection.
9 min↗
29Audio
CC0 sound workflow with Unity AudioMixer ducking and memory compression
Separate compression settings for background music and sound effects. Configure AudioMixer sidechain ducking and logarithmic decibel scaling.
10 min↗
30Data & Tooling
Tuning gameplay numbers without rebuilds using runtime JSON loading
Stop recompiling for balance changes. Move gameplay constants into an external balance.json file loaded at runtime via JsonUtility.
9 min↗
31Optimization & Rendering
Packing AI character expression sheets into a Unity Sprite Atlas for single draw calls
Loading separate AI-generated textures breaks sprite batching. Group character poses into a Sprite Atlas and swap expressions with single draw call efficiency.
10 min↗
32Narrative
After the café ending, we let the player define the relationship
A six-week epilogue follows the café and exam endings. The player chooses a date or a partnership, while earlier state shapes Hana's reply.
5 min↗
33UI & Text
TextMeshPro CJK font fallback chains and clean word wrapping
Baking thousands of CJK glyphs into static SDF textures blows up memory. Configure Dynamic SDF fallback chains and adapt layout boxes for language length variance.
10 min↗
34Build & Delivery
Automating Google Play AAB builds without Keystore mistakes
Manual Editor builds risk missed signing credentials or incorrect Target API levels. Automate Android App Bundle generation and Keystore assignment in headless scripts.
11 min↗
35Input System
Eliminating touch lag in mobile drag aiming with the New Input System
Polling Touchscreen arrays causes missed phases and swapped touch indexes. Use EnhancedTouch events and explicit Z-distance projections for responsive mobile aiming.
10 min↗
36Devlog
Naptide Devlog 1: When a sleeping cat blocks the way
Every swipe moves the awake cats together, and a sleeping cat can block the route. From three hand-placed tutorial rooms to selecting solvable boards, an Android screen and Play submission.
6 min↗
37Assets & Textures
Removing checkerboard fringe from AI-generated sprites for Unity
AI tools often bake preview checkerboards into RGB data. Restore clean alpha masks with border flood fill and configure Unity Texture Importers correctly.
9 min↗
38Android
The Android permission dialog never appears
Android permissions require a final Manifest declaration, a runtime request, and a check of the current grant state. A missing dialog can also mean that access is already granted or that repeated denial has suppressed another prompt.
10 min↗
39Builds
When a type disappears in an IL2CPP build
The Unity linker can remove code whose call path is not discoverable at build time. Types supplied only through external configuration should be preserved with a narrow Preserve attribute or link.xml entry.
11 min↗
40Data design
ScriptableObject shared data: keep runtime state off the source asset
A Unity 6000.5.3f1 reproduction checks two consumers of one asset, isolated current health, propagation from a shared mutation, and a detached runtime clone.
11 min↗
41Performance
Reduce GC Alloc in Update: measured strings and Physics arrays
A Unity 6000.5.3f1 reproduction compares 600 string updates and 200 Physics queries. It shows the gain from change guards and reused buffers, plus the truncation boundary when a NonAlloc buffer fills.
11 min↗
422D Physics
When a Unity 2D ball sticks to a wall: a measured Bounce Threshold fix
Bounciness 1 does not guarantee a reflection when the contact-normal speed falls below Bounce Threshold. A Unity 6000.5.3f1 reproduction separates the default, a lower test value, glancing impact, and Continuous detection.
11 min↗
43Scripting
When a DontDestroyOnLoad manager duplicates after reloading its source scene
Reloading the Boot scene in the same Play session creates a fresh manager beside the survivor. A Unity 6.5 reproduction separates that cause from Domain Reload and proves the guard with 1→2→3 versus 1→1→1 counts.
9 min↗
44Prefabs
When a Prefab value does not propagate to other instances
An Edit Mode change to a scene instance becomes a local override. An asset change does not replace an overridden property, and Play Mode changes reset on exit.
9 min↗
45Execution order
When one Awake depends on another Awake
Start follows all Awake calls for active objects in the initial scene, but the relative order between different Awake methods is not guaranteed. Make same-stage dependencies explicit.
10 min↗
46Scripting
A Unity coroutine stops with its GameObject, not the script
SetActive(false) kills the coroutines on that object; setting enabled=false on the component does not. Hide the visuals without killing the routine.
8 min↗
47Scripting
Why your SerializeField isn't showing in the Inspector
The value usually isn't lost - static, const, readonly, Dictionary, or a compile error puts it outside Unity's serialization rules. Check them in this order.
9 min↗
01Input Systems
Unity Input System: the setup order that avoids dead input
Package installed but no input arrives? Check Active Input Handling, the Action Map, and PlayerInput in the order that finds silent failures.
12 min↗
02Asset Management
Unity Addressables: decide these four things before converting
Stable addresses, group schemas, labels, and release ownership — set them before marking assets addressable, or the migration becomes a rebuild.
10 min↗
03Performance
Find CPU bottlenecks and GC allocations in the Unity Profiler
A practical order for CPU spikes, GC.Alloc call stacks, GPU comparison, and target-device measurement.
15 min↗
04Build & Release
A scene changes in the Editor but fails in a build
When SceneManager looks right but only the build fails, check the Build Profile scene list, scene name, and order first.
9 min↗
05Graphics
No SRP in use or pink materials? Check the render pipeline asset
The error means Unity has no active Render Pipeline Asset. Check the Graphics default and the Quality-level override, then the material's shader.
11 min↗
Find by problem
UI↓Build & deploy↓Devlog↓Asset management↓Graphics↓Testing↓Editor↓Animation↓Input↓Build↓Mobile UX↓Assets↓Serialization↓Audio↓Data & Tooling↓Optimization & Rendering↓Narrative↓UI & Text↓Build & Delivery↓Input System↓Assets & Textures↓Android↓Builds↓Data design↓Performance↓2D Physics↓Scripting↓Prefabs↓Execution order↓Input Systems↓Asset Management↓Build & Release↓
UI
Build & deploy
Devlog
- Keeping a thumb tremor from firing the volley: a DPI-aware tap/drag gate↗
- Recycling balls instead of destroying them: a test that pins what the pool must not leak↗
- A combo that was only displayed becomes score: lock the multiplier ladder with EditMode tests↗
- An upgrade recipe is not enough: test whether the required cards can appear↗
- Unity aiming UI: estimate the first hit without promising the whole volley↗
- Naptide Devlog 1: When a sleeping cat blocks the way↗
Asset management
Graphics
Testing
Editor
Animation
Input
Build
Mobile UX
Assets
Serialization
Audio
Data & Tooling
Optimization & Rendering
Narrative
UI & Text
Build & Delivery
Input System
Assets & Textures
Android
Builds
Data design
Performance
2D Physics
Scripting
Prefabs
Execution order
Input Systems
Asset Management
Build & Release
Every guide shows the Unity version and official sources used for review.