import struct import pytest from src.decode import photon from src.decode import translate from src.decode.photon import PhotonDecoder, decode_message18 from src.decode.translate import into_game_message from src.decode.world import IdCache, World from src.net.capture import _extract_udp_payload # --- Protocol18 value builders ------------------------------------------------- def p18_short(value): return bytes([photon.P18['Short']]) + struct.pack('= 0 else ((-value << 1) - 1) out = bytes([photon.P18['CompressedInt']]) while True: b = zz & 0x7F zz >>= 7 if zz: out += bytes([b | 0x80]) else: return out + bytes([b]) def params_table(entries): out = bytes([len(entries)]) for key, encoded in entries: out += bytes([key]) + encoded return out def event_payload(opcode, entries): table = params_table([(252, p18_short(opcode))] + list(entries)) return bytes([0xF3, 0x04, 0x01]) + table def flagged_event_payload(opcode, entries): table = params_table([(252, p18_short(opcode))] + list(entries)) return bytes([0xF3, 0x84, 0x01]) + table def response_payload(opcode, entries): table = params_table([(253, p18_short(opcode))] + list(entries)) debug = bytes([photon.P18['Null']]) return bytes([0xF3, 0x03, 0x01]) + struct.pack('HBBI', 0, 0, 1, 0) + struct.pack('>I', 0) command_header = struct.pack('>BBBB', command, 0, 0, 0) command_header += struct.pack('>I', length) + struct.pack('>I', 0) return header + command_header + msg_bytes def enet_unreliable_packet(command, msg_bytes): unreliable_seq = struct.pack('>I', 17) length = 12 + len(unreliable_seq) + len(msg_bytes) header = struct.pack('>HBBI', 0, 0, 1, 0) + struct.pack('>I', 0) command_header = struct.pack('>BBBB', command, 0, 0, 0) command_header += struct.pack('>I', length) + struct.pack('>I', 0) return header + command_header + unreliable_seq + msg_bytes # --- Protocol18 primitives ------------------------------------------------------ def test_varint_roundtrip(): assert photon.rd_varint(bytes([0x00]), 0) == (0, 1) assert photon.rd_varint(bytes([0x80, 0x01]), 0) == (128, 2) assert photon.rd_varint(bytes([0xAC, 0x02]), 0) == (300, 2) def test_zigzag(): assert photon.zigzag(0) == 0 assert photon.zigzag(1) == -1 assert photon.zigzag(2) == 1 assert photon.zigzag(3) == -2 def test_decode_params_and_compressed_int(): table = params_table([(0, p18_compressed_int(280962)), (2, p18_string('bionicKatana')), (3, p18_compressed_int(4))]) params, pos = photon.decode_params18(table, 0) assert params[0] == 280962 assert params[2] == 'bionicKatana' assert params[3] == 4 assert pos == len(table) def test_decode_message18_event(): payload = event_payload(1, [(0, p18_compressed_int(277536))]) message, pos = decode_message18(payload, 0) assert message.kind == 'Event' assert message.code == 1 assert message.params[252] == 1 assert message.params[0] == 277536 assert pos == len(payload) def test_decode_message18_flagged_event(): payload = flagged_event_payload(1, [(0, p18_compressed_int(277536))]) message, pos = decode_message18(payload, 0) assert message.kind == 'Event' assert message.params[252] == 1 assert message.params[0] == 277536 assert pos == len(payload) # --- eNet envelope + fragments -------------------------------------------------- def test_decode_packet_reliable(): decoder = PhotonDecoder() packet = enet_packet( photon.CMD_SEND_RELIABLE, event_payload(90, [(0, p18_short(7))])) messages = decoder.decode_packet(packet) assert len(messages) == 1 assert messages[0].params[252] == 90 def test_decode_packet_observed_unreliable_fragment_command(): decoder = PhotonDecoder() packet = enet_unreliable_packet( photon.CMD_SEND_UNRELIABLE_FRAGMENT, flagged_event_payload(1, [(0, p18_short(7))])) messages = decoder.decode_packet(packet) assert len(messages) == 1 assert messages[0].params[252] == 1 assert messages[0].params[0] == 7 def test_fragment_reassembly(): decoder = PhotonDecoder() full = event_payload(29, [(0, p18_short(1234))]) split = 5 parts = [full[i:i + split] for i in range(0, len(full), split)] messages = [] for i, part in enumerate(parts): start_seq, count = 5, len(parts) length = 12 + photon.FRAG_HEADER_LEN + len(part) header = struct.pack('>HBBI', 0, 0, 1, 0) + struct.pack('>I', 0) cmd = struct.pack('>BBBB', photon.CMD_SEND_FRAGMENT, 0, 0, 0) cmd += struct.pack('>I', length) + struct.pack('>I', 0) cmd += struct.pack('>IIIII', start_seq, count, i, len(full), i * split) messages.extend(decoder.decode_packet(header + cmd + part)) assert len(messages) == 1 assert messages[0].params[252] == 29 assert messages[0].params[0] == 1234 # --- translate ------------------------------------------------------------------ @pytest.mark.parametrize('opcode,name', [ (1, 'Leave'), (6, 'HealthUpdate'), (29, 'NewCharacter'), (82, 'UpdateFame'), (90, 'CharacterEquipmentChanged'), (91, 'RegenerationHealthChanged'), (166, 'KnockedDown'), (231, 'PartyJoined'), (233, 'PartyPlayerJoined'), (235, 'PartyPlayerLeft'), ]) def test_event_opcode_translation(opcode, name): message, _ = decode_message18(event_payload(opcode, []), 0) game = into_game_message(message) assert game is not None assert game.name == name def test_operation_translation(): message, _ = decode_message18(response_payload(2, [(0, p18_short(63))]), 0) game = into_game_message(message) assert game is not None assert game.name == 'Join' def test_unknown_opcode_ignored(): message, _ = decode_message18(event_payload(9999, []), 0) assert into_game_message(message) is None # --- world ---------------------------------------------------------------------- def game(name, params=None): return translate.GameMessage(name, 0, params or {}) def test_id_cache_reuses_id_for_name(): cache = IdCache() cache.save(100, 'Alice') assert cache.get_static_id(100) == 0 cache.save(200, 'Alice') assert cache.get_static_id(200) == 0 assert cache.get_static_id(100) is None assert cache.get_static_id(300) is None def test_world_new_character_player_appeared(): world = World() events = world.transform(game('NewCharacter', {0: 1234, 1: 'Alice'})) names = [e['name'] for e in events] assert 'PlayerAppeared' in names appeared = next(e for e in events if e['name'] == 'PlayerAppeared') assert appeared['value'] == {'id': 0, 'name': 'Alice'} def test_world_join_emits_zone_change_and_main_player(): world = World() events = world.transform(game('Join', {0: 63, 2: 'Alice'})) assert events[0] == {'name': 'ZoneChange'} assert events[1]['name'] == 'MainPlayerAppeared' assert world.main_player_id == 0 second = world.transform(game('Join', {0: 77, 2: 'Alice'})) assert {'name': 'ZoneChange'} not in second def test_world_main_player_leave_emits_zone_change(): world = World() world.transform(game('Join', {0: 63, 2: 'Alice'})) events = world.transform(game('Leave', {0: 63})) assert events == [{'name': 'ZoneChange'}] def test_world_health_update_damage_and_heal(): world = World() world.transform(game('NewCharacter', {0: 10, 1: 'Victim'})) world.transform(game('NewCharacter', {0: 20, 1: 'Attacker'})) damage = world.transform(game('HealthUpdate', {0: 10, 6: 20, 2: -80.0})) assert damage[0]['name'] == 'DamageDone' assert damage[0]['value']['source'] == 1 # attacker assert damage[0]['value']['target'] == 0 # victim assert damage[0]['value']['value'] == 80.0 heal = world.transform(game('HealthUpdate', {0: 10, 6: 20, 2: 40.0})) assert heal[0]['name'] == 'HealthReceived' assert heal[0]['value']['source'] == 1 assert heal[0]['value']['value'] == 40.0 def test_world_health_update_unknown_actor_dropped(): world = World() world.transform(game('NewCharacter', {0: 10, 1: 'Victim'})) assert world.transform(game('HealthUpdate', {0: 10, 6: 999, 2: -50.0})) == [] def test_world_regeneration_combat_states(): world = World() world.transform(game('NewCharacter', {0: 10, 1: 'Alice'})) enter = world.transform(game('RegenerationHealthChanged', {0: 10})) assert enter[0]['name'] == 'EnterCombat' leave = world.transform(game('RegenerationHealthChanged', {0: 10, 4: 5.0})) assert leave[0]['name'] == 'LeaveCombat' def test_world_knocked_down_leaves_combat(): world = World() world.transform(game('NewCharacter', {0: 10, 1: 'Alice'})) events = world.transform(game('KnockedDown', {0: 10})) assert events[0]['name'] == 'LeaveCombat' def test_world_update_fame_uses_gained(): world = World() world.transform(game('NewCharacter', {0: 10, 1: 'Alice'})) events = world.transform(game('UpdateFame', {0: 10, 1: 5000000, 2: 30000})) assert events[0]['name'] == 'UpdateFame' assert events[0]['value']['value'] == pytest.approx(3.0) def test_world_update_fame_delta_from_total(): world = World() world.transform(game('NewCharacter', {0: 10, 1: 'Alice'})) assert world.transform(game('UpdateFame', {0: 10, 1: 2000000})) == [] events = world.transform(game('UpdateFame', {0: 10, 1: 2001000})) assert events[0]['value']['value'] == pytest.approx(0.1) def test_world_unconsumed_equipment_replayed_on_new_character(): world = World() # equipment arrives before the player is named -> buffered assert world.transform( game('CharacterEquipmentChanged', {0: 55, 2: [0, 1]})) == [] events = world.transform(game('NewCharacter', {0: 55, 1: 'Alice'})) names = [e['name'] for e in events] assert 'PlayerAppeared' in names assert 'UpdateItems' in names def test_party_events_from_structures(): world = World() world.party.set_main_player_name('Alice') world.cache.save(1, 'Alice') joined = world.transform( game('PartyJoined', {4: [[1, 0], [2, 0]], 5: ['Alice', 'Bob']})) assert joined[0]['name'] == 'UpdateParty' assert joined[0]['value']['player_names'] == ['Alice', 'Bob'] left = world.transform(game('PartyPlayerLeft', {1: [2, 0]})) assert left[0]['value']['player_names'] == ['Alice'] def test_party_main_player_left_disbands(): world = World() world.party.set_main_player_name('Alice') world.transform(game('PartyJoined', {4: [[1, 0], [2, 0]], 5: ['Alice', 'Bob']})) events = world.transform(game('PartyPlayerLeft', {1: [1, 0]})) assert events[0]['value']['player_names'] == [] # --- capture frame extraction --------------------------------------------------- def build_ethernet_ipv4_udp(src_port, dst_port, payload): udp = struct.pack('>HHHH', src_port, dst_port, 8 + len(payload), 0) + payload ip = bytearray(20) ip[0] = 0x45 ip[2:4] = struct.pack('>H', 20 + len(udp)) ip[9] = 17 ip[12:16] = bytes([10, 0, 0, 1]) ip[16:20] = bytes([10, 0, 0, 2]) ethernet = bytes(12) + struct.pack('>H', 0x0800) return ethernet + bytes(ip) + udp def test_extract_udp_payload_game_port(): frame = build_ethernet_ipv4_udp(12345, 5056, b'hello') assert _extract_udp_payload(frame) == b'hello' def test_extract_udp_payload_other_port_ignored(): frame = build_ethernet_ipv4_udp(12345, 1234, b'hello') assert _extract_udp_payload(frame) is None def test_extract_udp_payload_with_vlan(): inner = build_ethernet_ipv4_udp(5056, 12345, b'world') header = inner[:12] tagged = header + struct.pack('>H', 0x8100) + struct.pack('>H', 42) + inner[12:] assert _extract_udp_payload(tagged) == b'world' def build_ethernet_ipv6_udp(src_port, dst_port, payload): udp = struct.pack('>HHHH', src_port, dst_port, 8 + len(payload), 0) + payload ip = bytearray(40) ip[0] = 0x60 ip[6] = 17 ip[8:24] = bytes.fromhex('fe800000000000000000000000000001') ip[24:40] = bytes.fromhex('fe800000000000000000000000000002') ethernet = bytes(12) + struct.pack('>H', 0x86DD) return ethernet + bytes(ip) + udp def test_extract_udp_payload_ipv6(): frame = build_ethernet_ipv6_udp(5056, 12345, b'v6') assert _extract_udp_payload(frame) == b'v6' def test_interface_names_excludes_loopback(): from src.net.capture import CaptureEngine names = CaptureEngine.interface_names() assert isinstance(names, list) assert 'lo' not in names