# Iris UNetObjectFilter (custom dynamic filter) linker error

**URL:** <https://forums.unrealengine.com/t/iris-unetobjectfilter-custom-dynamic-filter-linker-error/2456805>\
**Category:** C++\
**Tags:** unreal-engine, CPP, question\
**Created:** [April 14, 2025, 6:07pm UTC](https://forums.unrealengine.com/t/iris-unetobjectfilter-custom-dynamic-filter-linker-error/2456805 "2025-04-14T18:07:35Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![kaiagan1](https://d1ap1mz92jnks1.cloudfront.net/user_avatar/forums.unrealengine.com/kaiagan1/32/1056413_2.png) [@kaiagan1](https://forums.unrealengine.com/u/kaiagan1)\
**Post date:** [April 14, 2025, 6:07pm UTC](https://forums.unrealengine.com/t/iris-unetobjectfilter-custom-dynamic-filter-linker-error/2456805/1 "2025-04-14T18:07:35Z")

</div>

Hi,

Official documentation about Iris is rather sparse (and as I noticed in several instances, slightly outdated). Epic is very quiet about Iris, hopefully it won’t be silently abandonned as it is very useful for what I’m planning for my project 😶.

I’m using 5.4.4 and am trying to make my own dynamic filter:

> **[Iris Filtering in Unreal Engine | Unreal Engine 5.5 Documentation | Epic...](https://dev.epicgames.com/documentation/en-us/unreal-engine/iris-filtering-in-unreal-engine#createadynamicfilter)**
>
> Filter object replication to certain network connections with Iris in Unreal Engine.

I’m stuck even before being able to start. Visual Studio outputs some linker error, even though everything looks fine to me:

```auto
1>Module.UnrealBlox.2.cpp.obj : error LNK2019: unresolved external symbol "private: static class UClass * __cdecl UNetObjectFilter::GetPrivateStaticClass(void)" (?GetPrivateStaticClass@UNetObjectFilter@@CAPEAVUClass@@XZ) referenced in function "public: static class UClass *__cdecl UNetObjectFilter::StaticClass(void)" (?StaticClass@UNetObjectFilter@@SAPEAVUClass@@XZ)
1>Module.UnrealBlox.2.cpp.obj : error LNK2019: unresolved external symbol "public: __cdecl UNetObjectFilter::UNetObjectFilter(class FVTableHelper &)" (??0UNetObjectFilter@@QEAA@AEAVFVTableHelper@@@Z) referenced in function "class UObject *__cdecl InternalVTableHelperCtorCaller<class UBloxNetObjectFilter>(class FVTableHelper &)" (??$InternalVTableHelperCtorCaller@VUBloxNetObjectFilter@@@@YAPEAVUObject@@AEAVFVTableHelper@@@Z)
1>Module.UnrealBlox.2.cpp.obj : error LNK2019: unresolved external symbol "public: virtual __cdecl UNetObjectFilter::~UNetObjectFilter(void)" (??1UNetObjectFilter@@UEAA@XZ) referenced in function "public: virtual__cdecl UBloxNetObjectFilter::~UBloxNetObjectFilter(void)" (??1UBloxNetObjectFilter@@UEAA@XZ)
1>E:\Documents\repos\UnrealBlock\Plugins\UnrealBlox\Binaries\Win64\UnrealEditor-UnrealBlox.dll : fatal error LNK1120: 3 unresolved externals

```

I’m using the following in my module build.cs:

`SetupIrisSupport(Target);`

So it is already adding “IrisCore” to the private dependency modules. I also tried adding it to the public dependency modules instead, frantically deleting Intermediates/Binaries and regenerating the VS files for the project along the way, to no avail.

Here is my header file:

```auto
#pragma once

#include "Iris/ReplicationSystem/Filtering/NetObjectFilter.h"

#include "BloxNetObjectFilter.generated.h"

UCLASS()
class UBloxNetObjectFilter : public UNetObjectFilter
{
	GENERATED_BODY()

protected:

	// UNetObjectFilter interface
	virtual void OnInit(FNetObjectFilterInitParams& Params) override;
	//virtual void AddConnection(uint32 ConnectionId) override;
	//virtual void RemoveConnection(uint32 ConnectionId) override;
	virtual bool AddObject(uint32 ObjectIndex, FNetObjectFilterAddObjectParams& Params) override;
	virtual void RemoveObject(uint32 ObjectIndex, const FNetObjectFilteringInfo& Info) override;
	virtual void UpdateObjects(FNetObjectFilterUpdateParams& Params) override;
	//virtual void PreFilter(FNetObjectPreFilteringParams&) override;
	virtual void Filter(FNetObjectFilteringParams& Params) override;
	//virtual void PostFilter(FNetObjectPostFilteringParams& Params) override;
	
};

```

I can also use other classes/typedefs from “Iris/ReplicationSystem/Filtering/NetObjectFilter.h” (such as UE::Net::FNetObjectFilterHandle) without linking errors so I guess the issue lies with the UNetObjectFilter class itself.

Any idea?

---

<div class="post-metadata">

**Author:** ![kaiagan1](https://d1ap1mz92jnks1.cloudfront.net/user_avatar/forums.unrealengine.com/kaiagan1/32/1056413_2.png) [@kaiagan1](https://forums.unrealengine.com/u/kaiagan1)\
**Post date:** [April 17, 2025, 8:35am UTC](https://forums.unrealengine.com/t/iris-unetobjectfilter-custom-dynamic-filter-linker-error/2456805/2 "2025-04-17T08:35:12Z")

</div>

My bad, the issue is that you can’t use UCLASS on this (and I don’t need to actually).

---

<div class="post-metadata">

**Author:** ![kaiagan1](https://d1ap1mz92jnks1.cloudfront.net/user_avatar/forums.unrealengine.com/kaiagan1/32/1056413_2.png) [@kaiagan1](https://forums.unrealengine.com/u/kaiagan1)\
**Post date:** [April 19, 2025, 7:18pm UTC](https://forums.unrealengine.com/t/iris-unetobjectfilter-custom-dynamic-filter-linker-error/2456805/3 "2025-04-19T19:18:54Z")

</div>

Well, now I get an ensure about Iris not finding my class, even though I followed the steps described on the linked page in the OP. I submitted a bug report.

I was able to replicate this in a blank project and still get errors, and I’ve been trying a few times already so unless I made typing errors every time, this just isn’t working.

```auto
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: === Handled ensure: ===
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: 
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: Ensure condition failed: NetObjectFilterClass != nullptr [File:D:\build\++UE5\Sync\Engine\Source\Runtime\Experimental\Iris\Core\Private\Iris\ReplicationSystem\Filtering\ReplicationFiltering.cpp] [Line: 2455] 
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: NetObjectFilter class is not a NetObjectFilter or could not be found: /Script/MyProject.MyDynamicFilter
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: Stack: 
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffac4f35858 UnrealEditor-IrisCore.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffac4fbc5b5 UnrealEditor-IrisCore.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffac4fbcdb5 UnrealEditor-IrisCore.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffac4fb2677 UnrealEditor-IrisCore.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffaa34f8d44 UnrealEditor-Engine.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffaa3514e24 UnrealEditor-Engine.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffa688179d8 UnrealEditor-OnlineSubsystemUtils.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffa688196cd UnrealEditor-OnlineSubsystemUtils.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffaa43b3e58 UnrealEditor-Engine.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffaa2cd39ca UnrealEditor-Engine.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffaa2d17218 UnrealEditor-Engine.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffaa078834d UnrealEditor-UnrealEd.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffaa07b3a09 UnrealEditor-UnrealEd.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffaa07891fc UnrealEditor-UnrealEd.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffaa07d3496 UnrealEditor-UnrealEd.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffaa07d760e UnrealEditor-UnrealEd.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffaa07d6c0e UnrealEditor-UnrealEd.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffaa003c4a0 UnrealEditor-UnrealEd.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffaa0cbf6b6 UnrealEditor-UnrealEd.dll!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ff74a708e0b UnrealEditor.exe!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ff74a72e33c UnrealEditor.exe!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ff74a72e42a UnrealEditor.exe!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ff74a7318a4 UnrealEditor.exe!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ff74a7470c4 UnrealEditor.exe!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ff74a74a37a UnrealEditor.exe!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffb1559e8d7 KERNEL32.DLL!UnknownFunction []
[2025.04.19-18.59.26:430][431]LogOutputDevice: Error: [Callstack] 0x00007ffb16db14fc ntdll.dll!UnknownFunction []

```

---

<div class="post-metadata">

**Author:** ![Eserem](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@Eserem](https://forums.unrealengine.com/u/Eserem)\
**Post date:** [April 29, 2025, 1:18pm UTC](https://forums.unrealengine.com/t/iris-unetobjectfilter-custom-dynamic-filter-linker-error/2456805/4 "2025-04-29T13:18:29Z")

</div>

Did you manage to resolve this? I am running into the same problem right now.

---

<div class="post-metadata">

**Author:** ![kaiagan1](https://d1ap1mz92jnks1.cloudfront.net/user_avatar/forums.unrealengine.com/kaiagan1/32/1056413_2.png) [@kaiagan1](https://forums.unrealengine.com/u/kaiagan1)\
**Post date:** [April 29, 2025, 10:15pm UTC](https://forums.unrealengine.com/t/iris-unetobjectfilter-custom-dynamic-filter-linker-error/2456805/5 "2025-04-29T22:15:01Z")

</div>

Sadly, no. I did report the bug, though (but had no further communication since). If you want, you can do the same, maybe it will help get a solution faster:  
[https://www.unrealengine.com/en-US/support/report-a-bug](https://www.unrealengine.com/en-US/support/report-a-bug)

In my case I wanted to build a filter that kinda acts like the existing spatial grid filter, but optimised for my project (which is cell-based already, so I could make a very efficient custom filter). Using the existing one is okay for now. Putting this here in case this is helpful:

`UE::Net::FNetObjectFilterHandle FilterHandle = ReplicationSystem->GetFilterHandle(FName("Spatial"));`

---

<div class="post-metadata">

**Author:** ![kaiagan1](https://d1ap1mz92jnks1.cloudfront.net/user_avatar/forums.unrealengine.com/kaiagan1/32/1056413_2.png) [@kaiagan1](https://forums.unrealengine.com/u/kaiagan1)\
**Post date:** [July 28, 2025, 9:36pm UTC](https://forums.unrealengine.com/t/iris-unetobjectfilter-custom-dynamic-filter-linker-error/2456805/6 "2025-07-28T21:36:59Z")

</div>

I have just upgraded to 5.5, which has fixed the linker error when tagging the net filter object as UCLASS.

Another issue that I then faced was an ensure about missing the ‘MyNetFilterConfig’ class. I simply had to create this class (empty UCLASS derived from UNetObjectFilterConfig) myself, but this isn’t explictly said on the following page:

> **[Iris Filtering in Unreal Engine | Unreal Engine 5.6 Documentation | Epic...](https://dev.epicgames.com/documentation/en-us/unreal-engine/iris-filtering-in-unreal-engine#createadynamicfilter)**
>
> Filter object replication to certain network connections with Iris in Unreal Engine.

So here is the final header file:

> #pragma once
> 
> #include “Iris/ReplicationSystem/Filtering/NetObjectFilter.h”
> 
> #include “MyNetObjectFilter.generated.h”
> 
> UCLASS(Transient, MinimalAPI)  
> class UMyNetObjectFilterConfig final : public UNetObjectFilterConfig  
> {  
> GENERATED\_BODY()  
> };
> 
> UCLASS()  
> class UMyNetObjectFilter : public UNetObjectFilter  
> {  
> GENERATED\_BODY()
> 
> public:
> 
> // UNetObjectFilter interface  
> virtual void OnInit(const FNetObjectFilterInitParams& Params) override;  
> virtual void OnDeinit() override;  
> virtual void OnMaxInternalNetRefIndexIncreased(uint32 NewMaxInternalIndex) override;  
> virtual void AddConnection(uint32 ConnectionId) override;  
> virtual void RemoveConnection(uint32 ConnectionId) override;  
> virtual bool AddObject(uint32 ObjectIndex, FNetObjectFilterAddObjectParams& Params) override;  
> virtual void RemoveObject(uint32 ObjectIndex, const FNetObjectFilteringInfo& Info) override;  
> virtual void UpdateObjects(FNetObjectFilterUpdateParams& Params) override;  
> virtual void PreFilter(FNetObjectPreFilteringParams& Parms) override;  
> virtual void Filter(FNetObjectFilteringParams& Params) override;  
> virtual void PostFilter(FNetObjectPostFilteringParams& Params) override;
> 
> };

The first three methods (OnInit, OnDeinit, OnMaxInternalNetRefIndexIncreased) must be overridden (pure virtual). The remaining are optional.

And finally, in DefaultEngine.ini:

[/Script/IrisCore.NetObjectFilterDefinitions]  
+NetObjectFilterDefinitions=(FilterName=MyNetObjectFilter, ClassName=/Script/MyProjectName.MyNetObjectFilter, ConfigClassName=/Script/MyProjectName.MyNetObjectFilterConfig)

---

<div class="post-metadata">

**Author:** ![ShadowBr0kerz](https://d1ap1mz92jnks1.cloudfront.net/user_avatar/forums.unrealengine.com/shadowbr0kerz/32/1201558_2.png) [@ShadowBr0kerz](https://forums.unrealengine.com/u/ShadowBr0kerz)\
**Post date:** [October 30, 2026, 11:10am UTC](https://forums.unrealengine.com/t/iris-unetobjectfilter-custom-dynamic-filter-linker-error/2456805/7 "2026-10-30T11:10:48Z")

</div>

the linker error is the clue here, the base filter class is not meant to be subclassed as a UCLASS with generated boilerplate, plain C++ subclassing without the macros links clean. the follow-up ensure about NetObjectFilterClass then means the config entry does not resolve to the new class, usually a path typo in DefaultEngine.ini or a missing module dependency.

add the Iris core module to the build dependencies, rebuild, and confirm the class path in the log matches the registered name exactly, then test in a blank project with one filter and one actor.

you can also look at Iris Readiness Kit, an Iris replication plugin that audits the filter classes that fail registration: [Iris Readiness Kit — Audit Your Project Before Enabling Iris Replication | Fab](https://www.fab.com/listings/867dcb9a-60fd-4044-a4fe-aa89a737ca4a) there’s a shorts playlist on iris filtering basics too: [https://www.youtube.com/playlist?list=PLWrCzz951TwA](https://www.youtube.com/playlist?list=PLWrCzz951TwA)
