x64dbg/plugintemplate

Plugin template for x64dbg.

PluginTemplate

Template CMake project for x64dbg plugins. This uses cmkr, cmake.toml contains the project configuration.

Using the template

You can click the green Use this template button. See the article Creating a repository from a template by GitHub for more details.

Alternatively you can download a ZIP of this repository and set up the template locally.

Getting started

• Pretty much all of the available functionality can be found in bridgemain.h.
• You can find some (commented) example code in src/plugin.cpp.
• Example plugins: https://plugins.x64dbg.com.
• References:
  • https://help.x64dbg.com/en/latest/developers/plugins/index.html
  • https://x64dbg.com/blog/2016/10/04/architecture-of-x64dbg.html
  • https://x64dbg.com/blog/2016/10/20/threading-model.html
  • https://x64dbg.com/blog/2016/07/30/x64dbg-plugin-sdk.html

Building

From a Visual Studio command prompt:

cmake -B build64 -A x64
cmake --build build64 --config Release

You will get build64\PluginTemplate.sln that you can open in Visual Studio.

To build a 32-bit plugin:

cmake -B build32 -A Win32
cmake --build build32 --config Release

Alternatively you can open this folder in Visual Studio/CLion/Qt Creator.

Creating releases

This template has GitHub Actions set up in .github/workflows/build.yml. If you push a tag prefixed with v (for instance v1.0) it will automatically publish a GitHub release with the plugin binaries compiled for both architectures.

Automatic reloading

You can set up the PluginDevHelper utility to automatically unload and reload the plugin from x64dbg when compiling. See the README there for more detailled instructions.

plugintemplate's Issues

Better to add a way to import the PluginTemplate to VS2017

I use VS2017, and I found it not accessible to get the installed template through tutorial---

copy *.zip to Documents\Visual Studio 2017\Templates\ProjectTemplates\Visual C++ Project\.

But I did succeed by exporting the solution as template.
So this is just an advice.

build error C3861

i already include "plugin.h"

how to solve the problem

cgo

Please binding for cgo, thank you

Is there a API lookup address list?

like this：
StructList FindAdressList(duint StartAdress,duint Number) ；

StartAdress = 77534886
FindAdressList(0x77534886,10);

return:
77534889 0
7753488F 1
77534895 2
77534897 3
7753489A 4
7753489C 5
775348A0 6
775348A2 7
775348A4 8
775348A6 9

"_plugin_registerformatfunction" is not supported by this plugin SDK.