How to integrate MessagePack C# for Unity? (.NET, XCode, IL2CPP)
MessagePack is widely used for games because of its performance. However, it’s not easy to integrate it with Unity due to a lack of documentation and tutorials.
In particular, there are plenty of problems you may encounter when running your app with MessagePack-CSharp library on the IOS device.
Even if you follow the documentation to set up the MessagePack-CSharp library, it might not be easy to make it work.
This tutorial aims to help you smoothly integrate MessagePack-CSharp for Unity.
- MacBook Air
- Unity 2019.3.14f with .NET 4.x
- MessagePack C# v2.1.165
- XCode v11.5
Check out the source codes from GitHub MessagePack C# and place it in your project as below.
- Why not install a MessagePack package and related DLL files?
- Because this way can reduce your time to find and install proper dependent DLL files for MessagePack.
- Of course, you can manually install them if you want.
Define the struct or class to be serialized and annotate.
If you build your game in IL2CPP, you need to run dotnet mpc command to pre-generate codes for your class. Because Unity IL2CPP forbid runtime code generation.
First of all, install dotnet mpc command as below on your mac.
dotnet tool install --global MessagePack.Generator
dotnet new tool-manifest
dotnet tool install MessagePack.Generator
Then run below to test check it work properly.
dotnet mpc -h
Run the command below to generate codes for your class.
dotnet mpc -i Assembly-CSharp.csproj -o <your_output_path>/MessagePackGenerated.cs
- Assembly-CSharp.csproj is your C# project.
- If you use the old version of Unity and select Monno in Script backend of Unity, you may not need to pre-generate codes.
- MessagePack Library requires using C# v3.5+. If you use C# in 2.0, it's impossible to be compiled by Unity.
Create a MessagePackStartup class as shown below to set up MessagePack lib.
using UnityEngine;public class MessagePackStartup
static bool serializerRegistered = false;[RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
static void Initialize()
var option = MessagePackSerializerOptions.Standard.WithResolver(StaticCompositeResolver.Instance);MessagePackSerializer.DefaultOptions = option;
serializerRegistered = true;
static void EditorInitialize()
The most important part is you need to define proper Instances to register to MessagePackSerializerOptions as shown below.
What if you define it as below, what will happen?
You will encounter a problem below when running your game on the IOS device.
FormatterNotRegisteredException: Your Class is not registered in resolver:
Build and run your game on the IOS device and test.
This’s all. I hope this tutorial can save your time and successfully integrate MessagePack C# for Unity.
Thanks for reading.
You might be interested in
How to create a Serverless Cron Job in AWS Batch?
AWS Batch is a managed service to allow you to run batch jobs on AWS like big data analyzing or updating data in MYSQL.
Tips to test In-App-Purchase for Subscriptions on TestFlight/Sandbox
Testing subscriptions in In-App-Purchase is not an easy task on TestFlight/Sandbox. Because it’s too tricky to make it…
How to reverse engineer Unity3D Games?
Before writing this article, I thought Unity’s games were much safer than some browser games built by Java Script…