Difference between revisions of "Category:Plugins"

From OpenKore Wiki
Jump to navigation Jump to search
Line 13: Line 13:
 
* It is advised to get the '''entire [http://openkore.svn.sf.net/viewvc/openkore/plugins/example/trunk/ <pluginname>/trunk] folder''' of the plugin.
 
* It is advised to get the '''entire [http://openkore.svn.sf.net/viewvc/openkore/plugins/example/trunk/ <pluginname>/trunk] folder''' of the plugin.
 
* '''Unofficial sources are unsafe''' to get plugins from. (forums, third party, ...)
 
* '''Unofficial sources are unsafe''' to get plugins from. (forums, third party, ...)
* Using the plugins from the OpenKore plugin repository '''helps developers fix and maintain''' them, given that you provide bugreports and feedback..
+
* Using the plugins from the OpenKore plugin repository '''helps developers fix and maintain''' them, given that you provide bugreports and feedback. It also helps you to update them, if you're using svn.
  
 
==Installing==
 
==Installing==
Line 31: Line 31:
 
* '''Additional configuration may be required''' to get the plugins to work. (in: [[loadPlugins|sys.txt]], [[#Configuring|config.txt]], ...)
 
* '''Additional configuration may be required''' to get the plugins to work. (in: [[loadPlugins|sys.txt]], [[#Configuring|config.txt]], ...)
 
* Which plugins folder to use can be configured. (this is unnecessary in most cases)
 
* Which plugins folder to use can be configured. (this is unnecessary in most cases)
* If you '''svn checkout'''ing plugins, you can update them with '''svn up''' too.
+
 
 +
==Downloading, Installing and Updating with SVN==
 +
Installing plugin "example":
 +
svn co https://openkore.svn.sourceforge.net/svnroot/openkore/plugins/example/trunk plugins/example
 +
 
 +
Updating plugin "example":
 +
svn up plugins/example
 +
 
 +
Updating all installed plugins:
 +
svn up plugins/*
  
 
==Configuring==
 
==Configuring==
 
How to configure a specific plugin to your needs can be found on the forum and in some cases in [http://openkore.svn.sf.net/viewvc/openkore/plugins/example/trunk/doc <pluginname>/trunk/doc] or directly in the plugin file. The goal is to port this information to the wiki (ex. [[macro plugin]], [[wx captcha]]).
 
How to configure a specific plugin to your needs can be found on the forum and in some cases in [http://openkore.svn.sf.net/viewvc/openkore/plugins/example/trunk/doc <pluginname>/trunk/doc] or directly in the plugin file. The goal is to port this information to the wiki (ex. [[macro plugin]], [[wx captcha]]).

Revision as of 12:06, 7 May 2010

Introduction

This page aims to describe how to use OpenKore plugins. Plugins are little perl packages (.pl extension) that extend OpenKore's functionality. They do this by reacting to built-in events in kore called hooks.

Downloading

You can download most plugins from the official OpenKore plugin repository at SourceForge:


Notes:

  • It is advised to get the entire <pluginname>/trunk folder of the plugin.
  • Unofficial sources are unsafe to get plugins from. (forums, third party, ...)
  • Using the plugins from the OpenKore plugin repository helps developers fix and maintain them, given that you provide bugreports and feedback. It also helps you to update them, if you're using svn.

Installing

Rename the trunk folder that you downloaded to <pluginname> and place it in the plugins folder so that you end up with plugins/<pluginname>.

plugins/
	macro/
		<files from ^/plugins/macro/trunk>
	state/
		<files from ^/plugins/state/trunk>
	randomplugin/
		<files from ^/plugins/randomplugin/trunk>
	...

Notes:

  • OpenKore only looks for plugins down to 2 levels of the specified plugins folder. (ex. /plugins/<pluginname>/<pluginname.pl>)
  • Additional configuration may be required to get the plugins to work. (in: sys.txt, config.txt, ...)
  • Which plugins folder to use can be configured. (this is unnecessary in most cases)

Downloading, Installing and Updating with SVN

Installing plugin "example":

svn co https://openkore.svn.sourceforge.net/svnroot/openkore/plugins/example/trunk plugins/example

Updating plugin "example":

svn up plugins/example

Updating all installed plugins:

svn up plugins/*

Configuring

How to configure a specific plugin to your needs can be found on the forum and in some cases in <pluginname>/trunk/doc or directly in the plugin file. The goal is to port this information to the wiki (ex. macro plugin, wx captcha).

Pages in category "Plugins"

The following 6 pages are in this category, out of 6 total.