eolib 1.1.0__py3-none-any.whl → 1.2.0__py3-none-any.whl

eolib/protocol/_generated/net/client/guild_player_client_packet.py

@@ -11,6 +11,9 @@ from .....data.eo_writer import EoWriter
 from .....data.eo_reader import EoReader
 
 class GuildPlayerClientPacket(Packet):
+    """
+    Request to join a guild
+    """
     _byte_size: int = 0
     _session_id: int = None # type: ignore [assignment]
     _guild_tag: str = None # type: ignore [assignment]
@@ -96,18 +99,24 @@ class GuildPlayerClientPacket(Packet):
             writer (EoWriter): The writer that the data will be serialized to.
             data (GuildPlayerClientPacket): The data to serialize.
         """
-        if data._session_id is None:
-            raise SerializationError("session_id must be provided.")
-        writer.add_int(data._session_id)
-        writer.add_byte(0xFF)
-        if data._guild_tag is None:
-            raise SerializationError("guild_tag must be provided.")
-        writer.add_string(data._guild_tag)
-        writer.add_byte(0xFF)
-        if data._recruiter_name is None:
-            raise SerializationError("recruiter_name must be provided.")
-        writer.add_string(data._recruiter_name)
-        writer.add_byte(0xFF)
+        old_string_sanitization_mode: bool = writer.string_sanitization_mode
+        try:
+            writer.string_sanitization_mode = True
+            if data._session_id is None:
+                raise SerializationError("session_id must be provided.")
+            writer.add_int(data._session_id)
+            writer.add_byte(0xFF)
+            if data._guild_tag is None:
+                raise SerializationError("guild_tag must be provided.")
+            writer.add_string(data._guild_tag)
+            writer.add_byte(0xFF)
+            if data._recruiter_name is None:
+                raise SerializationError("recruiter_name must be provided.")
+            writer.add_string(data._recruiter_name)
+            writer.add_byte(0xFF)
+            writer.string_sanitization_mode = False
+        finally:
+            writer.string_sanitization_mode = old_string_sanitization_mode
 
     @staticmethod
     def deserialize(reader: EoReader) -> "GuildPlayerClientPacket":

eolib/protocol/_generated/net/client/guild_rank_client_packet.py

@@ -11,6 +11,9 @@ from .....data.eo_writer import EoWriter
 from .....data.eo_reader import EoReader
 
 class GuildRankClientPacket(Packet):
+    """
+    Update a member's rank
+    """
     _byte_size: int = 0
     _session_id: int = None # type: ignore [assignment]
     _rank: int = None # type: ignore [assignment]
@@ -104,15 +107,19 @@ class GuildRankClientPacket(Packet):
             writer (EoWriter): The writer that the data will be serialized to.
             data (GuildRankClientPacket): The data to serialize.
         """
-        if data._session_id is None:
-            raise SerializationError("session_id must be provided.")
-        writer.add_int(data._session_id)
-        if data._rank is None:
-            raise SerializationError("rank must be provided.")
-        writer.add_char(data._rank)
-        if data._member_name is None:
-            raise SerializationError("member_name must be provided.")
-        writer.add_string(data._member_name)
+        old_string_sanitization_mode: bool = writer.string_sanitization_mode
+        try:
+            if data._session_id is None:
+                raise SerializationError("session_id must be provided.")
+            writer.add_int(data._session_id)
+            if data._rank is None:
+                raise SerializationError("rank must be provided.")
+            writer.add_char(data._rank)
+            if data._member_name is None:
+                raise SerializationError("member_name must be provided.")
+            writer.add_string(data._member_name)
+        finally:
+            writer.string_sanitization_mode = old_string_sanitization_mode
 
     @staticmethod
     def deserialize(reader: EoReader) -> "GuildRankClientPacket":

eolib/protocol/_generated/net/client/guild_remove_client_packet.py

@@ -11,6 +11,9 @@ from .....data.eo_writer import EoWriter
 from .....data.eo_reader import EoReader
 
 class GuildRemoveClientPacket(Packet):
+    """
+    Leave guild
+    """
     _byte_size: int = 0
     _session_id: int = None # type: ignore [assignment]
 
@@ -78,9 +81,13 @@ class GuildRemoveClientPacket(Packet):
             writer (EoWriter): The writer that the data will be serialized to.
             data (GuildRemoveClientPacket): The data to serialize.
         """
-        if data._session_id is None:
-            raise SerializationError("session_id must be provided.")
-        writer.add_int(data._session_id)
+        old_string_sanitization_mode: bool = writer.string_sanitization_mode
+        try:
+            if data._session_id is None:
+                raise SerializationError("session_id must be provided.")
+            writer.add_int(data._session_id)
+        finally:
+            writer.string_sanitization_mode = old_string_sanitization_mode
 
     @staticmethod
     def deserialize(reader: EoReader) -> "GuildRemoveClientPacket":

eolib/protocol/_generated/net/client/guild_report_client_packet.py

@@ -11,6 +11,9 @@ from .....data.eo_writer import EoWriter
 from .....data.eo_reader import EoReader
 
 class GuildReportClientPacket(Packet):
+    """
+    Requested general information of a guild
+    """
     _byte_size: int = 0
     _session_id: int = None # type: ignore [assignment]
     _guild_identity: str = None # type: ignore [assignment]
@@ -87,12 +90,16 @@ class GuildReportClientPacket(Packet):
             writer (EoWriter): The writer that the data will be serialized to.
             data (GuildReportClientPacket): The data to serialize.
         """
-        if data._session_id is None:
-            raise SerializationError("session_id must be provided.")
-        writer.add_int(data._session_id)
-        if data._guild_identity is None:
-            raise SerializationError("guild_identity must be provided.")
-        writer.add_string(data._guild_identity)
+        old_string_sanitization_mode: bool = writer.string_sanitization_mode
+        try:
+            if data._session_id is None:
+                raise SerializationError("session_id must be provided.")
+            writer.add_int(data._session_id)
+            if data._guild_identity is None:
+                raise SerializationError("guild_identity must be provided.")
+            writer.add_string(data._guild_identity)
+        finally:
+            writer.string_sanitization_mode = old_string_sanitization_mode
 
     @staticmethod
     def deserialize(reader: EoReader) -> "GuildReportClientPacket":

eolib/protocol/_generated/net/client/guild_request_client_packet.py

@@ -11,6 +11,9 @@ from .....data.eo_writer import EoWriter
 from .....data.eo_reader import EoReader
 
 class GuildRequestClientPacket(Packet):
+    """
+    Requested to create a guild
+    """
     _byte_size: int = 0
     _session_id: int = None # type: ignore [assignment]
     _guild_tag: str = None # type: ignore [assignment]
@@ -96,18 +99,24 @@ class GuildRequestClientPacket(Packet):
             writer (EoWriter): The writer that the data will be serialized to.
             data (GuildRequestClientPacket): The data to serialize.
         """
-        if data._session_id is None:
-            raise SerializationError("session_id must be provided.")
-        writer.add_int(data._session_id)
-        writer.add_byte(0xFF)
-        if data._guild_tag is None:
-            raise SerializationError("guild_tag must be provided.")
-        writer.add_string(data._guild_tag)
-        writer.add_byte(0xFF)
-        if data._guild_name is None:
-            raise SerializationError("guild_name must be provided.")
-        writer.add_string(data._guild_name)
-        writer.add_byte(0xFF)
+        old_string_sanitization_mode: bool = writer.string_sanitization_mode
+        try:
+            writer.string_sanitization_mode = True
+            if data._session_id is None:
+                raise SerializationError("session_id must be provided.")
+            writer.add_int(data._session_id)
+            writer.add_byte(0xFF)
+            if data._guild_tag is None:
+                raise SerializationError("guild_tag must be provided.")
+            writer.add_string(data._guild_tag)
+            writer.add_byte(0xFF)
+            if data._guild_name is None:
+                raise SerializationError("guild_name must be provided.")
+            writer.add_string(data._guild_name)
+            writer.add_byte(0xFF)
+            writer.string_sanitization_mode = False
+        finally:
+            writer.string_sanitization_mode = old_string_sanitization_mode
 
     @staticmethod
     def deserialize(reader: EoReader) -> "GuildRequestClientPacket":

eolib/protocol/_generated/net/client/guild_take_client_packet.py

@@ -12,9 +12,13 @@ from .....data.eo_writer import EoWriter
 from .....data.eo_reader import EoReader
 
 class GuildTakeClientPacket(Packet):
+    """
+    Request guild description, rank list, or bank balance
+    """
     _byte_size: int = 0
     _session_id: int = None # type: ignore [assignment]
     _info_type: GuildInfoType = None # type: ignore [assignment]
+    _guild_tag: str = None # type: ignore [assignment]
 
     @property
     def byte_size(self) -> int:
@@ -50,6 +54,22 @@ class GuildTakeClientPacket(Packet):
     def info_type(self, info_type: GuildInfoType) -> None:
         self._info_type = info_type
 
+    @property
+    def guild_tag(self) -> str:
+        """
+        Note:
+          - Length must be `3`.
+        """
+        return self._guild_tag
+
+    @guild_tag.setter
+    def guild_tag(self, guild_tag: str) -> None:
+        """
+        Note:
+          - Length must be `3`.
+        """
+        self._guild_tag = guild_tag
+
     @staticmethod
     def family() -> PacketFamily:
         """
@@ -88,12 +108,21 @@ class GuildTakeClientPacket(Packet):
             writer (EoWriter): The writer that the data will be serialized to.
             data (GuildTakeClientPacket): The data to serialize.
         """
-        if data._session_id is None:
-            raise SerializationError("session_id must be provided.")
-        writer.add_int(data._session_id)
-        if data._info_type is None:
-            raise SerializationError("info_type must be provided.")
-        writer.add_short(int(data._info_type))
+        old_string_sanitization_mode: bool = writer.string_sanitization_mode
+        try:
+            if data._session_id is None:
+                raise SerializationError("session_id must be provided.")
+            writer.add_int(data._session_id)
+            if data._info_type is None:
+                raise SerializationError("info_type must be provided.")
+            writer.add_short(int(data._info_type))
+            if data._guild_tag is None:
+                raise SerializationError("guild_tag must be provided.")
+            if len(data._guild_tag) != 3:
+                raise SerializationError(f"Expected length of guild_tag to be exactly 3, got {len(data._guild_tag)}.")
+            writer.add_fixed_string(data._guild_tag, 3, False)
+        finally:
+            writer.string_sanitization_mode = old_string_sanitization_mode
 
     @staticmethod
     def deserialize(reader: EoReader) -> "GuildTakeClientPacket":
@@ -112,10 +141,11 @@ class GuildTakeClientPacket(Packet):
             reader_start_position: int = reader.position
             data._session_id = reader.get_int()
             data._info_type = GuildInfoType(reader.get_short())
+            data._guild_tag = reader.get_fixed_string(3, False)
             data._byte_size = reader.position - reader_start_position
             return data
         finally:
             reader.chunked_reading_mode = old_chunked_reading_mode
 
     def __repr__(self):
-        return f"GuildTakeClientPacket(byte_size={repr(self._byte_size)}, session_id={repr(self._session_id)}, info_type={repr(self._info_type)})"
+        return f"GuildTakeClientPacket(byte_size={repr(self._byte_size)}, session_id={repr(self._session_id)}, info_type={repr(self._info_type)}, guild_tag={repr(self._guild_tag)})"

eolib/protocol/_generated/net/client/guild_tell_client_packet.py

@@ -11,6 +11,9 @@ from .....data.eo_writer import EoWriter
 from .....data.eo_reader import EoReader
 
 class GuildTellClientPacket(Packet):
+    """
+    Requested member list of a guild
+    """
     _byte_size: int = 0
     _session_id: int = None # type: ignore [assignment]
     _guild_identity: str = None # type: ignore [assignment]
@@ -87,12 +90,16 @@ class GuildTellClientPacket(Packet):
             writer (EoWriter): The writer that the data will be serialized to.
             data (GuildTellClientPacket): The data to serialize.
         """
-        if data._session_id is None:
-            raise SerializationError("session_id must be provided.")
-        writer.add_int(data._session_id)
-        if data._guild_identity is None:
-            raise SerializationError("guild_identity must be provided.")
-        writer.add_string(data._guild_identity)
+        old_string_sanitization_mode: bool = writer.string_sanitization_mode
+        try:
+            if data._session_id is None:
+                raise SerializationError("session_id must be provided.")
+            writer.add_int(data._session_id)
+            if data._guild_identity is None:
+                raise SerializationError("guild_identity must be provided.")
+            writer.add_string(data._guild_identity)
+        finally:
+            writer.string_sanitization_mode = old_string_sanitization_mode
 
     @staticmethod
     def deserialize(reader: EoReader) -> "GuildTellClientPacket":

eolib/protocol/_generated/net/client/guild_use_client_packet.py

@@ -11,6 +11,9 @@ from .....data.eo_writer import EoWriter
 from .....data.eo_reader import EoReader
 
 class GuildUseClientPacket(Packet):
+    """
+    Accepted a join request
+    """
     _byte_size: int = 0
     _player_id: int = None # type: ignore [assignment]
 
@@ -78,9 +81,13 @@ class GuildUseClientPacket(Packet):
             writer (EoWriter): The writer that the data will be serialized to.
             data (GuildUseClientPacket): The data to serialize.
         """
-        if data._player_id is None:
-            raise SerializationError("player_id must be provided.")
-        writer.add_short(data._player_id)
+        old_string_sanitization_mode: bool = writer.string_sanitization_mode
+        try:
+            if data._player_id is None:
+                raise SerializationError("player_id must be provided.")
+            writer.add_short(data._player_id)
+        finally:
+            writer.string_sanitization_mode = old_string_sanitization_mode
 
     @staticmethod
     def deserialize(reader: EoReader) -> "GuildUseClientPacket":

eolib/protocol/_generated/net/client/init_init_client_packet.py

@@ -12,6 +12,10 @@ from .....data.eo_writer import EoWriter
 from .....data.eo_reader import EoReader
 
 class InitInitClientPacket(Packet):
+    """
+    Connection initialization request.
+    This packet is unencrypted.
+    """
     _byte_size: int = 0
     _challenge: int = None # type: ignore [assignment]
     _version: Version = None # type: ignore [assignment]
@@ -107,21 +111,25 @@ class InitInitClientPacket(Packet):
             writer (EoWriter): The writer that the data will be serialized to.
             data (InitInitClientPacket): The data to serialize.
         """
-        if data._challenge is None:
-            raise SerializationError("challenge must be provided.")
-        writer.add_three(data._challenge)
-        if data._version is None:
-            raise SerializationError("version must be provided.")
-        Version.serialize(writer, data._version)
-        writer.add_char(112)
-        if data._hdid_length is None:
-            raise SerializationError("hdid_length must be provided.")
-        writer.add_char(data._hdid_length)
-        if data._hdid is None:
-            raise SerializationError("hdid must be provided.")
-        if len(data._hdid) > 252:
-            raise SerializationError(f"Expected length of hdid to be 252 or less, got {len(data._hdid)}.")
-        writer.add_fixed_string(data._hdid, data._hdid_length, False)
+        old_string_sanitization_mode: bool = writer.string_sanitization_mode
+        try:
+            if data._challenge is None:
+                raise SerializationError("challenge must be provided.")
+            writer.add_three(data._challenge)
+            if data._version is None:
+                raise SerializationError("version must be provided.")
+            Version.serialize(writer, data._version)
+            writer.add_char(112)
+            if data._hdid_length is None:
+                raise SerializationError("hdid_length must be provided.")
+            writer.add_char(data._hdid_length)
+            if data._hdid is None:
+                raise SerializationError("hdid must be provided.")
+            if len(data._hdid) > 252:
+                raise SerializationError(f"Expected length of hdid to be 252 or less, got {len(data._hdid)}.")
+            writer.add_fixed_string(data._hdid, data._hdid_length, False)
+        finally:
+            writer.string_sanitization_mode = old_string_sanitization_mode
 
     @staticmethod
     def deserialize(reader: EoReader) -> "InitInitClientPacket":

eolib/protocol/_generated/net/client/item_drop_client_packet.py

@@ -13,6 +13,9 @@ from .....data.eo_writer import EoWriter
 from .....data.eo_reader import EoReader
 
 class ItemDropClientPacket(Packet):
+    """
+    Dropping items on the ground
+    """
     _byte_size: int = 0
     _item: ThreeItem = None # type: ignore [assignment]
     _coords: ByteCoords = None # type: ignore [assignment]
@@ -40,7 +43,7 @@ class ItemDropClientPacket(Packet):
         """
         The official client sends 255 byte values for the coords if an item is dropped via
         the GUI button.
-        255 values here should be interpreted to mean "drop at current coords".
+        255 values here should be interpreted to mean "drop at current coords".
         Otherwise, the x and y fields contain encoded numbers that must be explicitly
         decoded to get the actual x and y values.
         """
@@ -51,7 +54,7 @@ class ItemDropClientPacket(Packet):
         """
         The official client sends 255 byte values for the coords if an item is dropped via
         the GUI button.
-        255 values here should be interpreted to mean "drop at current coords".
+        255 values here should be interpreted to mean "drop at current coords".
         Otherwise, the x and y fields contain encoded numbers that must be explicitly
         decoded to get the actual x and y values.
         """
@@ -95,12 +98,16 @@ class ItemDropClientPacket(Packet):
             writer (EoWriter): The writer that the data will be serialized to.
             data (ItemDropClientPacket): The data to serialize.
         """
-        if data._item is None:
-            raise SerializationError("item must be provided.")
-        ThreeItem.serialize(writer, data._item)
-        if data._coords is None:
-            raise SerializationError("coords must be provided.")
-        ByteCoords.serialize(writer, data._coords)
+        old_string_sanitization_mode: bool = writer.string_sanitization_mode
+        try:
+            if data._item is None:
+                raise SerializationError("item must be provided.")
+            ThreeItem.serialize(writer, data._item)
+            if data._coords is None:
+                raise SerializationError("coords must be provided.")
+            ByteCoords.serialize(writer, data._coords)
+        finally:
+            writer.string_sanitization_mode = old_string_sanitization_mode
 
     @staticmethod
     def deserialize(reader: EoReader) -> "ItemDropClientPacket":

eolib/protocol/_generated/net/client/item_get_client_packet.py

@@ -11,6 +11,9 @@ from .....data.eo_writer import EoWriter
 from .....data.eo_reader import EoReader
 
 class ItemGetClientPacket(Packet):
+    """
+    Taking items from the ground
+    """
     _byte_size: int = 0
     _item_index: int = None # type: ignore [assignment]
 
@@ -78,9 +81,13 @@ class ItemGetClientPacket(Packet):
             writer (EoWriter): The writer that the data will be serialized to.
             data (ItemGetClientPacket): The data to serialize.
         """
-        if data._item_index is None:
-            raise SerializationError("item_index must be provided.")
-        writer.add_short(data._item_index)
+        old_string_sanitization_mode: bool = writer.string_sanitization_mode
+        try:
+            if data._item_index is None:
+                raise SerializationError("item_index must be provided.")
+            writer.add_short(data._item_index)
+        finally:
+            writer.string_sanitization_mode = old_string_sanitization_mode
 
     @staticmethod
     def deserialize(reader: EoReader) -> "ItemGetClientPacket":

eolib/protocol/_generated/net/client/item_junk_client_packet.py

@@ -12,6 +12,9 @@ from .....data.eo_writer import EoWriter
 from .....data.eo_reader import EoReader
 
 class ItemJunkClientPacket(Packet):
+    """
+    Junking items
+    """
     _byte_size: int = 0
     _item: Item = None # type: ignore [assignment]
 
@@ -71,9 +74,13 @@ class ItemJunkClientPacket(Packet):
             writer (EoWriter): The writer that the data will be serialized to.
             data (ItemJunkClientPacket): The data to serialize.
         """
-        if data._item is None:
-            raise SerializationError("item must be provided.")
-        Item.serialize(writer, data._item)
+        old_string_sanitization_mode: bool = writer.string_sanitization_mode
+        try:
+            if data._item is None:
+                raise SerializationError("item must be provided.")
+            Item.serialize(writer, data._item)
+        finally:
+            writer.string_sanitization_mode = old_string_sanitization_mode
 
     @staticmethod
     def deserialize(reader: EoReader) -> "ItemJunkClientPacket":

eolib/protocol/_generated/net/client/item_use_client_packet.py

@@ -11,6 +11,9 @@ from .....data.eo_writer import EoWriter
 from .....data.eo_reader import EoReader
 
 class ItemUseClientPacket(Packet):
+    """
+    Using an item
+    """
     _byte_size: int = 0
     _item_id: int = None # type: ignore [assignment]
 
@@ -78,9 +81,13 @@ class ItemUseClientPacket(Packet):
             writer (EoWriter): The writer that the data will be serialized to.
             data (ItemUseClientPacket): The data to serialize.
         """
-        if data._item_id is None:
-            raise SerializationError("item_id must be provided.")
-        writer.add_short(data._item_id)
+        old_string_sanitization_mode: bool = writer.string_sanitization_mode
+        try:
+            if data._item_id is None:
+                raise SerializationError("item_id must be provided.")
+            writer.add_short(data._item_id)
+        finally:
+            writer.string_sanitization_mode = old_string_sanitization_mode
 
     @staticmethod
     def deserialize(reader: EoReader) -> "ItemUseClientPacket":

eolib/protocol/_generated/net/client/jukebox_msg_client_packet.py

@@ -11,6 +11,9 @@ from .....data.eo_writer import EoWriter
 from .....data.eo_reader import EoReader
 
 class JukeboxMsgClientPacket(Packet):
+    """
+    Requesting a song on a jukebox
+    """
     _byte_size: int = 0
     _track_id: int = None # type: ignore [assignment]
 
@@ -27,6 +30,8 @@ class JukeboxMsgClientPacket(Packet):
     @property
     def track_id(self) -> int:
         """
+        This value is 0-indexed
+
         Note:
           - Value range is 0-64008.
         """
@@ -35,6 +40,8 @@ class JukeboxMsgClientPacket(Packet):
     @track_id.setter
     def track_id(self, track_id: int) -> None:
         """
+        This value is 0-indexed
+
         Note:
           - Value range is 0-64008.
         """
@@ -78,11 +85,15 @@ class JukeboxMsgClientPacket(Packet):
             writer (EoWriter): The writer that the data will be serialized to.
             data (JukeboxMsgClientPacket): The data to serialize.
         """
-        writer.add_char(0)
-        writer.add_char(0)
-        if data._track_id is None:
-            raise SerializationError("track_id must be provided.")
-        writer.add_short(data._track_id)
+        old_string_sanitization_mode: bool = writer.string_sanitization_mode
+        try:
+            writer.add_char(0)
+            writer.add_char(0)
+            if data._track_id is None:
+                raise SerializationError("track_id must be provided.")
+            writer.add_short(data._track_id)
+        finally:
+            writer.string_sanitization_mode = old_string_sanitization_mode
 
     @staticmethod
     def deserialize(reader: EoReader) -> "JukeboxMsgClientPacket":
@@ -99,11 +110,9 @@ class JukeboxMsgClientPacket(Packet):
         old_chunked_reading_mode: bool = reader.chunked_reading_mode
         try:
             reader_start_position: int = reader.position
-            reader.chunked_reading_mode = True
             reader.get_char()
             reader.get_char()
             data._track_id = reader.get_short()
-            reader.chunked_reading_mode = False
             data._byte_size = reader.position - reader_start_position
             return data
         finally:

eolib/protocol/_generated/net/client/jukebox_open_client_packet.py

@@ -12,6 +12,9 @@ from .....data.eo_writer import EoWriter
 from .....data.eo_reader import EoReader
 
 class JukeboxOpenClientPacket(Packet):
+    """
+    Opening the jukebox listing
+    """
     _byte_size: int = 0
     _coords: Coords = None # type: ignore [assignment]
 
@@ -71,9 +74,13 @@ class JukeboxOpenClientPacket(Packet):
             writer (EoWriter): The writer that the data will be serialized to.
             data (JukeboxOpenClientPacket): The data to serialize.
         """
-        if data._coords is None:
-            raise SerializationError("coords must be provided.")
-        Coords.serialize(writer, data._coords)
+        old_string_sanitization_mode: bool = writer.string_sanitization_mode
+        try:
+            if data._coords is None:
+                raise SerializationError("coords must be provided.")
+            Coords.serialize(writer, data._coords)
+        finally:
+            writer.string_sanitization_mode = old_string_sanitization_mode
 
     @staticmethod
     def deserialize(reader: EoReader) -> "JukeboxOpenClientPacket":

eolib/protocol/_generated/net/client/jukebox_use_client_packet.py

@@ -11,6 +11,9 @@ from .....data.eo_writer import EoWriter
 from .....data.eo_reader import EoReader
 
 class JukeboxUseClientPacket(Packet):
+    """
+    Playing a note with the bard skill
+    """
     _byte_size: int = 0
     _instrument_id: int = None # type: ignore [assignment]
     _note_id: int = None # type: ignore [assignment]
@@ -95,12 +98,16 @@ class JukeboxUseClientPacket(Packet):
             writer (EoWriter): The writer that the data will be serialized to.
             data (JukeboxUseClientPacket): The data to serialize.
         """
-        if data._instrument_id is None:
-            raise SerializationError("instrument_id must be provided.")
-        writer.add_char(data._instrument_id)
-        if data._note_id is None:
-            raise SerializationError("note_id must be provided.")
-        writer.add_char(data._note_id)
+        old_string_sanitization_mode: bool = writer.string_sanitization_mode
+        try:
+            if data._instrument_id is None:
+                raise SerializationError("instrument_id must be provided.")
+            writer.add_char(data._instrument_id)
+            if data._note_id is None:
+                raise SerializationError("note_id must be provided.")
+            writer.add_char(data._note_id)
+        finally:
+            writer.string_sanitization_mode = old_string_sanitization_mode
 
     @staticmethod
     def deserialize(reader: EoReader) -> "JukeboxUseClientPacket":