pcsx2-memory-accessor 1.0

A Python API for reading & writing PCSX2's emulator memory, using the Pine IPC protocol.

PCSX2 Memory Accessor

A Python API for reading & writing PCSX2's emulator memory, using the Pine IPC protocol.

Installation

pip install pcsx2-memory-accessor

Enable Pine IPC in PCSX2:

• Open PCSX2
• Go to Settings
• Under Advanced, scroll down to PINE Setting, check enable. Set the port to 28011
• Restart PCSX2

Quick Start

import pcsx2_memory_accessor as p

# Initialize connection
if p.init():
    # Read a 32-bit integer
    health = p.read_u32(0x00100000)
    print(f"Health: {health}")
    
    # Write a 32-bit integer
    p.write_u32(0x00100000, 69)
    
    # Read multiple bytes (12 bytes in this case)
    data = p.read_pcsx2_memory(0x00200000, 12)

    # Write multiple bytes (9 bytes in this case)
    my_bytes = bytes([0x11, 0x22, 0x33, 0x44, 0x55, 0x66, 0x77, 0x88, 0x99])
    data = p.write_pcsx2_memory(0x00200000, my_bytes)

    # Write a binary file to PCSX2 Memory ---
    BIN_FILENAME = "memory_patch.bin"

    # Read data from the binary file in binary mode ('rb')
    with open(BIN_FILENAME, 'rb') as f:
        file_data = f.read()
    
    # Write the file data (byte array) directly to PCSX2 memory
    if file_data:
        TARGET_ADDRESS = 0x00300000
        p.write_pcsx2_memory(0x00300000, file_data)
    
    # Cleanup
    p.shutdown()

API Reference

# Read single values
health = pcsx2_memory_accessor.read_u8(address)   # Read 8-bit integer
score = pcsx2_memory_accessor.read_u16(address)   # Read 16-bit integer
value = pcsx2_memory_accessor.read_u32(address)   # Read 32-bit integer
big_num = pcsx2_memory_accessor.read_u64(address) # Read 64-bit integer

# Write single values
pcsx2_memory_accessor.write_u8(address, value)    # Write 8-bit integer
pcsx2_memory_accessor.write_u16(address, value)   # Write 16-bit integer
pcsx2_memory_accessor.write_u32(address, value)   # Write 32-bit integer
pcsx2_memory_accessor.write_u64(address, value)   # Write 64-bit integer

# Read multiple bytes (returns bytes object)
data = pcsx2_memory_accessor.read_pcsx2_memory(address, num_bytes)

# Write multiple bytes
pcsx2_memory_accessor.write_pcsx2_memory(address, data_bytes)

Requirements

• Python 3.6+
• PCSX2 with Pine IPC support

Credits

• Pine by GovanifY

Links

• PCSX2: https://pcsx2.net/
• Pine: https://github.com/GovanifY/pine