About NullReferenceFix
From ThunderstoreFixes recurring NullReferenceException/log spam (ZNetScene.RemoveObjects, AzuCraftyBoxes, EnemyHud conflicts, TMP missing glyphs), oversized item tooltip shake/cut-off (two columns), and KeenCombat skill text on non-weapons.
NullReferenceFix
A small collection of independent Harmony patches, each fixing one specific recurring bug — mostly NullReferenceExceptions that repeat every single frame for the rest of your play session once triggered (spamming the log and wasting CPU), plus the occasional leaked-resource bug that quietly accumulates until it causes lag or a freeze. Every patch targets a different root cause and can trigger (or not) completely independently of the others.
한국어 설명 보기 | English Description
🇰🇷 한국어 (Korean)
개요
NullReferenceFix는 서로 독립적인 여러 개의 작은 Harmony 패치를 모아둔 모드입니다. 대부분은 한 번 터지면 세션이 끝날 때까지 매 프레임 반복해서 터지는 NullReferenceException 버그를 담당하고, 일부는 조용히 누적되다가 렉이나 프리징을 유발하는 리소스 누수를 담당합니다. 패치마다 원인이 다르고, 서로 완전히 독립적으로 발동합니다 — 즉 설치된 다른 모드 구성에 따라 일부 패치는 평생 한 번도 발동하지 않을 수도 있습니다.
현재 7가지 버그를 고칩니다:
- 바닐라 발헤임 자체 버그 (
ZNetScene.RemoveObjects) - AzuCraftyBoxes 모드 버그 (제작함 근처 재료 확인)
- EnemyHud를 건드리는 모드 간 충돌 (EpicMMOSystem 등)
- 바닐라 발헤임 TMP 폰트의 비라틴 스크립트(한글/일본어/중국어/아랍어 등) 글리프 누락 경고 (닉네임/길드명 등이 공백으로 표시됨)
- 바닐라 발헤임 아이템 툴팁이 화면보다 클 때 발생하는 화면 흔들림/잘림 (스탯·효과를 많이 추가하는 모드 사용 시)
- Azumatt AAA_Crafting 제작창(제작/업그레이드 탭) 아이템 호버 툴팁이 화면 오른쪽 끝에서 흔들리고 잘리는 문제 (화면 가운데 고정 + 2열 분할)
- KeenCombat의 무기 스킬 툴팁("BLINK STRIKE" 등)이 무기가 아닌 아이템에도 표시되는 문제 (비무기 아이템에서만 제거)
📦 필수 모드 (Dependencies)
| 모드 | 버전 | 필수 여부 | |------|------|----------| | BepInExPack_Valheim | 5.4.2200+ | 필수 | | AzuCraftyBoxes | 아무 버전 | 선택 — 설치되어 있을 때만 해당 패치가 활성화됩니다 | | EpicMMOSystem | 아무 버전 | 선택 — 설치되어 있지 않아도 다른 두 패치는 정상 작동합니다 |
이 모드는 어떤 조합으로 설치해도 안전합니다. 위 모드들이 없어도 해당 패치만 조용히 비활성화될 뿐, 나머지 패치는 그대로 작동합니다.
🐛 버그 1 — ZNetScene.RemoveObjects (바닐라 발헤임)
같은 프레임 안에서 어떤 ZNetView의 GameObject가 다른 경로로 먼저 파괴되면, 바닐라 ZNetScene.RemoveObjects가 그 오브젝트를 내부 추적 딕셔너리(m_instances)에서 제거하기도 전에 NullReferenceException을 던집니다. 이 예외 때문에 문제의 entry가 딕셔너리에서 끝내 제거되지 못하고 남아버리고, 그 결과 다음 프레임에도 똑같은 예외가 또 발생 — 이 과정이 세션이 끝날 때까지 매 프레임 무한 반복됩니다.
이건 특정 모드가 만든 버그가 아니라 발헤임 엔진 자체의 오래된 결함입니다. 모드를 하나도 설치하지 않아도 발생할 수 있으며, 몬스터 스폰/디스폰이 잦은 상황(전투, 대규모 소환 등)일수록 더 쉽게 걸립니다.
이 모드가 하는 일: ZNetScene.RemoveObjects에 Harmony Finalizer 패치를 추가해 해당 예외만 정확히 잡아내고, 이미 파괴된(fake-null) ZNetView entry를 m_instances에서 직접 제거합니다.
🐛 버그 2 — AzuCraftyBoxes 제작함 조건 확인
AzuCraftyBoxes는 근처에서 본 모든 제작함을 HashSet<Container>에 정적으로 계속 쌓아둡니다. 상자가 철거될 때는 Container.OnDestroyed 패치로 항목을 지우지만, 일부 파괴 경로(구역/청크 언로드 등)는 이 메서드를 거치지 않고 GameObject를 바로 파괴해버려서, 이미 죽은(fake-null) Container가 세트에 그대로 남습니다. 이후 제작 메뉴가 열려 있는 동안 매 프레임 실행되는 재료 확인 로직이 이 죽은 항목의 GetPrefabName()을 호출하면서 NullReferenceException이 반복 발생합니다 — 제작 메뉴를 닫기 전까지 계속됩니다.
이 모드가 하는 일: AzuCraftyBoxes가 설치되어 있을 때만 활성화되는 패치로, 해당 예외를 잡아내고 파괴된 Container 항목들을 세트에서 직접 제거합니다.
🐛 버그 3 — EnemyHud를 건드리는 모드 간 충돌 (EpicMMOSystem 등)
일부 팩션/마켓플레이스 계열 모드는 자체 EnemyHud.LateUpdate 패치 안에서 EnemyHud.ShowHud를 직접 강제로 재호출해 HUD를 즉시 새로고침하려 합니다. 그런데 이 재호출이 이미 로그아웃했거나 디스폰된 캐릭터를 대상으로 발생하면, 그 캐릭터의 HUD 항목(m_huds)이 아직 정리되지 않은 채 남아있을 수 있고, 이걸 전제로 동작하는 다른 모드의 ShowHud 패치(예: EpicMMOSystem의 PvP 플레이어 이름 색상 표시 패치 DataMonsters.MonsterColorTexts)가 죽은 참조를 건드리면서 NullReferenceException이 반복 발생합니다.
이 모드가 하는 일: EpicMMOSystem이나 특정 모드를 콕 집어 패치하지 않고, 발헤임 기본 EnemyHud.ShowHud에 Finalizer를 걸어서 어떤 모드의 postfix에서 터지든 잡아내고, 문제의 오래된 m_huds 항목과 남은 HUD GameObject를 직접 정리합니다. 그러면 다음 프레임에 정상적인 새 항목이 만들어집니다.
🐛 버그 4 — TMP 비라틴 스크립트 글리프 누락 경고
발헤임 바닐라·TMP 내장 폰트(예: Valheim-Prstartk, LiberationSans SDF)는 라틴 문자만 커버하고, 한글·일본어·중국어·아랍어·히브리어·태국어 등 비라틴 스크립트 글리프는 자체 글리프 테이블과 폴백 체인에 포함하지 않습니다. 플레이어 닉네임·길드명처럼 사용자가 직접 입력한 비라틴 텍스트가 이런 폰트로 렌더링되는 TMP_Text 오브젝트(예: EpicMMOSystem의 네임플레이트/ 길드명/정보 패널)를 통해 표시될 때마다 "The character with Unicode value ... was not found in the [...] font asset..." 경고가 반복 출력되고, 해당 글자는 공백이나 네모(□)로 대체됩니다. 발헤임은 자체 다국어 로컬라이제이션을 위해 스크립트별 Noto 계열 폰트(NotoSansKR, NotoSansJP, NotoSansSC, NotoSansArabic 등 11개 스크립트 + 이모지)를 이미 게임 파일에 내장하고 있지만, 플레이어가 직접 입력하는 텍스트용 TMP 전역 폴백 목록에는 연결되어 있지 않습니다.
이 모드가 하는 일: 발헤임이 지원하는 각 언어의 폰트를 찾아 세션당 한 번 TMP의 전역 폴백 목록(TMP_Settings.fallbackFontAssets)에 전부 등록합니다. 새 폰트를 번들링하지 않고 발헤임이 이미 갖고 있는 리소스만 사용하며, 어떤 모드가 만든 TMP 텍스트든 상관없이 어떤 언어의 텍스트든 공백/네모 대신 정상적으로 표시되도록 합니다.
🐛 버그 5 — 화면보다 큰 아이템 툴팁 (화면 흔들림 / 잘림)
스탯·효과를 많이 추가하는 모드(스킬트리, 마법 효과 모드 등)를 쓰면 아이템 툴팁이 화면 높이보다 길어질 수 있습니다. 바닐라 UITooltip은 매 프레임 Utils.ClampUIToScreen으로 툴팁을 화면 안으로 밀어 넣는데, 이 함수는 "위가 화면 밖" 보정과 "아래가 화면 밖" 보정을 연달아 적용합니다. 화면보다 큰 툴팁에서는 두 조건이 모두 참이라 위로 밀었다가 다시 아래로 되밀리고, 마우스가 조금만 움직여도 결과가 뒤집혀 화면이 반복적으로 흔들립니다. 게다가 화면에 들어가지 않는 부분은 읽을 수 없습니다.
이 모드가 하는 일: UITooltip.LateUpdate에 Postfix 패치를 추가해, 툴팁이 화면보다 클 때만 본문을 두 열로 나눕니다. 첫 번째 열은 화면에 들어가는 만큼의 줄을, 두 번째 열은 그 오른쪽에 나머지 줄을 표시하고, 두 열을 한 묶음으로 화면 상단에 고정합니다. 색상 등 리치텍스트 태그는 나뉘는 지점에서 자동으로 닫고 다시 엽니다. 화면에 들어가는 일반 툴팁은 전혀 건드리지 않습니다.
🐛 버그 6 — AAA_Crafting 제작창 아이템 툴팁 (화면 흔들림 / 잘림)
Azumatt의 AAA_Crafting은 제작창 오른쪽 아이템 목록(제작/업그레이드 탭)에 마우스를 올리면 뜨는 호버 툴팁을 바닐라 UITooltip이 아닌 자체 클래스(RecipeHoverTooltip)로 처리합니다. 이 툴팁은 마우스 위치에 뜨는데 목록이 화면 오른쪽 끝에 있어, 스탯·효과가 많은 아이템은 툴팁이 화면 밖으로 밀려 흔들리고 내용이 잘립니다. 버그 5의 패치는 UITooltip만 대상이라 여기에는 적용되지 않습니다.
이 모드가 하는 일: RecipeHoverTooltip.LateUpdate에 Postfix 패치를 추가해, 이 툴팁을 항상 화면 가운데에 고정합니다. 툴팁이 화면보다 크면 버그 5와 같은 방식으로 두 열로 나눕니다(첫 번째 열은 화면 높이를 가득 채우고, 넘친 줄은 오른쪽 두 번째 열에 아래쪽 기준으로 채움). AAA_Crafting이 설치되어 있지 않으면 아무 일도 하지 않습니다.
🐛 버그 7 — KeenCombat 스킬 툴팁이 비무기 아이템에 표시됨
KeenCombat은 ItemDrop.ItemData.GetTooltip의 모든 오버로드 끝에 무기 스킬 설명(예: "BLINK STRIKE", 설명, 쿨타임)을 덧붙입니다. 다른 모드가 재료·음식·모드 추가 아이템에 무기용 스킬 타입을 지정해 두면 무기가 아닌 아이템에도 같은 스킬 툴팁이 붙습니다. KeenCombat에는 이 툴팁을 끄는 설정이 없습니다.
Highlights
From source dataLoaders
Runs on BepInEx.
Footprint
Rated a light load on a server.
Last update
Its author last shipped an update 47d ago.
NullReferenceFix on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Valheim servers, for BepInEx servers. We download it from Thunderstore, place it, and restart the server.
- Server side
- Optional on the server
- Server type needed
- BepInEx
- Server load
- light
- Smallest plan we suggest
- Valheim — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 1.0.26, released 2026-10-06
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| BepInEx |
From 15 recorded builds of NullReferenceFix.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 1.0.26 | 2026-10-06 | n/a | BepInEx |
| 1.0.25 | 2026-10-04 | n/a | BepInEx |
| 1.0.23 | 2026-10-02 | n/a | BepInEx |
| 1.0.20 | 2026-09-10 | n/a | BepInEx |
| 1.0.17 | 2026-08-17 | n/a | BepInEx |
| 1.0.14 | 2026-08-17 | n/a | BepInEx |
Dependencies
- Required: BepInExPack Valheim
Declared by the newest build that lists any. Required ones are installed with it on one-click installs.
Run NullReferenceFix on a Valheim server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogLibraries & compatibility
Foundations and fixes other mods build on. Usually installed because something else needs it.
Works on a server
From source side supportThunderstore lists server-side support for NullReferenceFix as optional: it can run on a server, but isn’t required there.
Compatibility
- Game
- Valheim
- Loaders
- BepInEx
- Runs on
- Serveroptional on the server
- Requires
- One-click install needs a BepInEx server.
Verified at the source
- ✓ThunderstoreOfficial listing, checked 2026-10-15Open ↗
- ✓AuthorkorCaptain, as published on Thunderstore
- ✓LicenseNot published by the sourceFree



