Quick Start

A quick start on writing plugins for OQ.MineBot. This can be seen as a tl;dr version of the Introduction, however it's still highly recommended to read the Introduction section.

To get quickly started with plugin making simply follow these instructions:
Part 1: creating project and setting up dependencies.
Create a Class Library (.NET Framework)
 
Ensure that you have all of the necessary pre-requisites:
Open NuGet package manager.
 
Install the OQ.MineBot.PluginBase package.
 
Every plugin is required to have a PluginCore which is used for things like defining attributes like the name of the plugin, version, and description:
 
Then you will need to have an OnLoad method which will be called once the plugin is loaded/reloaded, which is usually when the bot is started. The settings are optional and can be overwritten if you don't want to include any settings:
 
Finally, you will need an OnStart method which will register all of your task classes and is called as soon as the plugin is started on a bot:
 
Part 2: creating tasks
Create a task class, which will allow you to interact with the bot and it's environment.
Inherit from ITask (and optionally any of the Listeners):
 
Implement Exec, which will tell the bot if any of the Listeners can be called, and add any listener code:
 
​🎉
 That's it, now you can build the plugin and test it on the bot🎉
 
For a more in-depth guide check out the Introduction page.

ExamplePlugin.zip
3KB
Binary
Download Template Code Here

Introduction

Next - Examples

Start Plugins

Last modified 3yr ago