PyMemoryEditor

순수 Python 라이브러리(ctypes 기반)로, 몇 줄의 Python 코드만으로 실행 중인 모든 프로세스의 메모리를 검사, 수정, 검색할 수 있습니다 — Windows, Linux, macOS에서 Cheat Engine 워크플로우를 지원합니다!

Python에서 직접 모든 프로세스의 메모리를 읽고, 쓰고, 스캔하세요.
하나의 통합 API. 세 가지 운영체제. C 컴파일러 불필요. 네이티브 빌드 단계 없음.

🪟 Windows · 🐧 Linux · 🍎 macOS — 32비트 및 64비트 지원.

PyMemoryEditor app attached to a running process

실행 중인 게임의 값을 조정하세요 · 라이브 프로그램의 상태를 검사하세요 · RAM에서 직접 데이터를 수집하세요.

설치

pip install PyMemoryEditor

번들 GUI 앱(Cheat Engine 스타일 스캐너)도 함께 설치하려면 app 엑스트라를 사용하세요:

pip install "PyMemoryEditor[app]"
pymemoryeditor

대규모 프로세스에서 더 빠른 스캔이 필요하다면 speed 엑스트라를 추가하세요. NumPy를 설치하고 숫자 스캔 비교 루프를 자동으로 벡터화하여 선택적 스캔에서 약 10~30배 더 빠릅니다:

pip install "PyMemoryEditor[speed]"

📖 전체 가이드는 Read the Docs 에서 확인하세요.

실제 사용 예시

from PyMemoryEditor import OpenProcess

with OpenProcess(name="game.exe") as process:

    # 값 100을 보유한 모든 주소를 프로세스 전체에서 스캔합니다.
    for address in process.search_by_value(int, value=100):
        print(f"Found at 0x{address:X}")

    # 현재 값을 읽은 다음 새 값을 다시 씁니다.
    current = process.read_int(address)
    process.write_int(address, current + 500)

이것으로 끝입니다 — 세 줄로 다른 프로세스를 읽거나, 쓰거나, 스캔할 수 있으며 모든 플랫폼에서 동일하게 작동합니다.

📖 문서

전체 문서는 pymemoryeditor.readthedocs.io 에 있습니다 — 설치, Cheat Engine 워크플로우, 모든 메서드와 매개변수, GUI 앱 가이드, 플랫폼별 참고 사항 및 문제 해결 방법을 다룹니다.

빠른 탐색을 위한 안내:

빠른 시작	프로세스 열기, 읽기, 쓰기 및 첫 스캔 실행.
메모리 검색	값 스캔, 범위, 결과 정제, Cheat Engine 루프.
패턴 스캔	바이트 시그니처(AOB)와 정규식으로 코드/데이터 찾기.
포인터	다중 레벨 포인터 체인과 라이브 `RemotePointer`.
포인터 스캔	ASLR을 견디는 정적 포인터 찾기.
GUI 앱	번들로 제공되는 Cheat Engine 스타일 스캐너.
API 참조	모든 공개 클래스, 메서드 및 매개변수.
플랫폼 참고 사항	Windows, Linux, macOS의 권한 및 특이사항.
문제 해결	일반적인 오류와 해결 방법.

무엇을 만들 수 있나요?

🎮 게임 모딩 및 스피드런 도구 — 전형적인 Cheat Engine 사용 사례.
🔬 디버깅 및 내부 검사 — 디버거를 연결하지 않고 라이브 상태 검사.
📊 관측 가능성 도구 — 실행 중인 프로세스의 변수 샘플링을 통한 텔레메트리.
🔐 보안 및 리버스 엔지니어링 연구 — 소유하거나 테스트 권한이 있는 시스템에서.
🎓 학습 — 번들 앱은 메모리 스캐닝 작동 방식을 배우기에 훌륭한 교육 도구입니다.

[!NOTE] 책임 있는 사용. PyMemoryEditor는 OS 수준 API를 통해 다른 프로세스와 통신합니다. 소유하거나 명시적 검사 권한이 있는 프로세스에만 사용하세요.

🤝 기여

풀 리퀘스트, 버그 리포트, 기능 제안은 언제나 환영합니다. 개발 환경 설정, 테스트 구조 및 알아야 할 플랫폼별 특이사항은 CONTRIBUTING.md를 참조하세요.

PyMemoryEditor가 프로젝트에 도움이 되었다면 저장소에 ⭐를 눌러주세요 — 작업을 지원하고 다른 사람들이 라이브러리를 발견하도록 돕는 가장 쉬운 방법입니다.

라이선스

MIT License로 배포됩니다 — 개인 및 상업적 용도로 자유롭게 사용할 수 있습니다.

PyMemoryEditor v2.2.0

카테고리