PyMemoryEditor

ctypes 上に構築された純Pythonライブラリで、実行中の任意のプロセスのメモリを数行のPythonで検査・変更・検索できます — Windows、Linux、macOSでCheat Engineのワークフローを実現します！

任意のプロセスのメモリを読み取り、書き込み、スキャン — Pythonから直接。
1つの統一API。3つのオペレーティングシステム。Cコンパイラ不要。ネイティブビルドステップ不要。

🪟 Windows · 🐧 Linux · 🍎 macOS で動作 — 32ビットおよび64ビット対応。

実行中のゲームの値を調整 · ライブプログラムの状態を検査 · 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)

これだけです — 別のプロセスの読み取り、書き込み、スキャンを3行で、すべてのプラットフォームで同じ方法で実行できます。

📖 ドキュメント

完全なドキュメントは pymemoryeditor.readthedocs.io にあります — インストール、Cheat Engineワークフロー、すべてのメソッドとパラメータ、GUIアプリガイド、プラットフォーム別の注意事項、トラブルシューティング。

どこを見ればよいかの簡単なマップ：

これで何が作れる？

• 🎮 ゲーム改造＆スピードラン用ツール — 定番のCheat Engineユースケース。
• 🔬 デバッグ＆イントロスペクション — デバッガをアタッチせずにライブ状態を検査。
• 📊 可観測性ツール — 実行中のプロセスの変数をサンプリングしてテレメトリを取得。
• 🔐 セキュリティ＆リバースエンジニアリング研究 — 所有している、またはテスト許可を得たシステム上で。
• 🎓 学習 — 同梱アプリはメモリスキャンの仕組みを学ぶ優れた教材です。

[!NOTE] 責任ある使用について。 PyMemoryEditor はOSレベルのAPIを通じて他のプロセスと通信します。 所有しているプロセス、または明示的な検査許可を得たプロセスにのみ使用してください。

🤝 コントリビューション

プルリクエスト、バグ報告、機能アイデアを歓迎します。開発環境のセットアップ、テスト構成、注意すべきプラットフォーム固有の小さな癖については、CONTRIBUTING.md をお読みください。

PyMemoryEditor があなたのプロジェクトに役立ったなら、ぜひリポジトリに ⭐ を付けてください — 開発を支援し、他の人がこのライブラリを見つけるための最も簡単な方法です。

ライセンス

MIT License の下で公開されています — 個人利用・商用利用ともに無料です。