MemoryPackでシリアライズ・デシリアライズをカスタマイズするいくつかの方法

public class Player
{
    public string Name { get; }
    public List<Weapon> Weapons { get; private set; }
}

public class Weapon
{
    public int Id { get; }
    public string Name { get; }
    public int Power { get; }
    // その他ゲームに関する様々なパラメータがあるとする
}

// たとえばこういうデータベースクラスがあるとする
// 簡単のためにstaticで定義した。
public static class WeaponDatabase
{
    public static Weapon Get(int id)
    {
        return id switch
        {
            1 => new Weapon(1, "ナイフ", 1),
            2 => new Weapon(2, "短剣", 2),
            3 => new Weapon(3, "長剣", 3),
        };
    }
}

// こんな感じでとれるとする
var weapon = WeaponDatabase.Get(1);

using System.Collections.Generic;
using System.Linq;
using MemoryPack;

[MemoryPackable]
public partial class Player1
{
    // Weaponsそのものはシリアライズしない
    [MemoryPackIgnore]
    public List<Weapon> Weapons { get; } = new();

    // 代わりにId一覧をシリアライズする
    // こっちは外から参照されなくていいのでprivateで定義
    [MemoryPackInclude]
    private int[] WeaponIds { get; set; }

    // MemoryPackのシリアライズが行われる前に呼び出される
    [MemoryPackOnSerializing]
    private static voidOnSerializing(
        ref MemoryPackWriter writer, ref Player1? value)
    {
        // WeaponsからId配列を作成する
        value.WeaponIds = value.Weapons
            .Select(w => w.Id)
            .ToArray();
        // このメソッド呼び出し後に、MemoryPackの実際のシリアライズが行われる
    }

    // MemoryPackのデシリアライズが行われた後に呼び出される
    [MemoryPackOnDeserialized]
    private static voidOnDeserialized(
        ref MemoryPackReader reader, ref Player1? value)
    {
        // Id配列からWeaponsを復元
        value.Weapons.AddRange(
            value.WeaponIds.Select(WeaponDatabase.Get)
        );
    }
}

using System.Collections.Generic;
using System.Linq;
using MemoryPack;

public partial class Player2
{
    // 今回もこちらはシリアライズしないので
    // MemoryPackIgnore
    [MemoryPackIgnore]
    public List<Weapon> Weapons { get; } = new();

    [MemoryPackOnSerialized]
    private static void OnSerialized(
        ref MemoryPackWriter writer, ref Player2? value)
    {
        // ID配列を直接MemoryPackWriterで配列として追記する
        writer.WriteArray(
            value.Weapons.Select(w => w.Id).ToArray()
        );
    }

    [MemoryPackOnDeserialized]
    private static void OnDeserialized(
        ref MemoryPackReader reader, ref Player2? value)
    {
        // 追記しておいたID配列を読み込み
        int[] ids = null;
        reader.ReadArray(ref ids);

        // そこからWeaponsを復元
        value.Weapons.AddRange(
            ids.Select(WeaponDatabase.Get)
        );
    }
}

using System.Collections.Generic;
using System.Linq;
using MemoryPack;

// シリアライズしたいクラス
public class Player
{
    public string Name { get; }
    public List<Weapon> Weapons { get; } = new();

    public Player(string name, List<Weapon> weapons)
    {
        Name = name;
        Weapons = weapons;
    }
}

// Playerシリアライズ用の型
// こっちはPlayerクラスと別アセンブリとかにしても問題なし
[MemoryPackable]
public partial class PlayerSerializable
{
    [MemoryPackIgnore]
    public readonly Player Player;

    // シリアライズ対象のプロパティを定義して
    // そのまま元のPlayerのプロパティを参照する
    [MemoryPackInclude]
    private string Name => Player.Name;
    // WeaponsはIDとしてシリアライズする
    [MemoryPackInclude] private int[] WeaponIds
        => Player.Weapons.Select(w => w.Id).ToArray();

    // デシリアライズ時にMemoryPackが呼び出すコンストラクタ
    [MemoryPackConstructor]
    public PlayerSerializable(string Name, int[] WeaponIds)
    {
        // ここで Playerを復元する
        Player = new Player(
            Name,
            // ID配列からWeapons配列を復元
            WeaponIds.Select(WeaponDatabase.Get).ToList()
        );
    }

    // こっちのコンストラクタはシリアライズ時に使う
    public PlayerSerializable(Player player)
    {
        Player = player;
    }
}

var p = new Player("Taro", new List<Weapon>
{
    WeaponDatabase.Get(1),
    WeaponDatabase.Get(3),
});

// PlayerSerializableを介する
var bin = MemoryPackSerializer.Serialize(new PlayerSerializable(p));
var val = MemoryPackSerializer.Deserialize<PlayerSerializable>(bin).Player;

// Name = Taro
Debug.Log($"Name = {val.Name}");
// WeaponCount = 2
Debug.Log($"WeaponCount = {val.Weapons.Count}");
// Weapon[0].Id = 1
Debug.Log($"Weapon[0].Id = {val.Weapons[0].Id}");
// Weapon[0].Name = ナイフ
Debug.Log($"Weapon[0].Name = {val.Weapons[0].Name}");
// Weapon[1].Id = 3
Debug.Log($"Weapon[1].Id = {val.Weapons[1].Id}");
// Weapon[1].Name = 長剣
Debug.Log($"Weapon[1].Name = {val.Weapons[1].Name}");

// Playerのカスタムフォーマッター
// シリアライズ・デシリアライズ自体は全部
// PlayerSerializableに委譲する
public class PlayerFormatter : MemoryPackFormatter<Player>
{
    public override void Serialize(
        ref MemoryPackWriter writer, ref Player value)
    {
        if (value == null)
        {
            writer.WriteNullObjectHeader();
            return;
        }

        // PlayerSerializable経由でシリアライズ
        writer.WritePackable(new PlayerSerializable(value));
    }

    public override void Deserialize(
        ref MemoryPackReader reader, ref Player value)
    {
        if (reader.PeekIsNull())
        {
            value = null;
            return;
        }

        // PlayerSerializable経由でデシリアライズ
        var wrapped = reader.ReadPackable<PlayerSerializable>();
        value = wrapped.Player;
    }
}

// これをアプリケーションの初期化で１度呼ぶ
MemoryPackFormatterProvider.Register(new PlayerFormatter());

var p = new Player("Taro", new List<Weapon>
{
    WeaponDatabase.Get(1),
    WeaponDatabase.Get(3),
});

// Playerクラスを直接シリアライズしてる風
var bin = MemoryPackSerializer.Serialize(p);
// Playerクラスとして直接デシリアライズしてる風
var val = MemoryPackSerializer.Deserialize<Player>(bin);

// Name = Taro
Debug.Log($"Name = {val.Name}");
// WeaponCount = 2
Debug.Log($"WeaponCount = {val.Weapons.Count}");
// Weapon[0].Id = 1
Debug.Log($"Weapon[0].Id = {val.Weapons[0].Id}");
// Weapon[0].Name = ナイフ
Debug.Log($"Weapon[0].Name = {val.Weapons[0].Name}");
// Weapon[1].Id = 3
Debug.Log($"Weapon[1].Id = {val.Weapons[1].Id}");
// Weapon[1].Name = 長剣
Debug.Log($"Weapon[1].Name = {val.Weapons[1].Name}");