Hercules Wiki - User contributions [en]

Startnpctimer

2015-01-17T14:15:00Z

Ind: nevermind me [7] (testing stuff)

==Syntax==
* [[startnpctimer]] {<attach flag>};
* [[startnpctimer]] {"<NPC name>"};
* [[startnpctimer]] {"<NPC name>"{, <attach flag>}};

==Description==
This script command works almost exactly like [[initnpctimer]], however calling this method does not reset the timer for the NPC. When called, it will resume the timer if it has been stopped using [[stopnpctimer]], and it will not reset the NPC timer tick to 0.

==Parameters==
See [[initnpctimer#Parameters|initnpctimer]].

==Examples==
* Start or stop an NPC timer using menus.
[[switch]]( select("Resume timer", "Stop timer") )
{
[[case]] 1:
startnpctimer;
[[end]];

case 2:
stopnpctimer;
end;
}

[[OnTimer]]60000:
[[announce]] "This will only ever be called once.", bc_all|bc_npc;
end;

[[Category:Script Command]]

Isloggedin

2015-01-17T14:11:11Z

Ind: nevermind me [6] (testing stuff)

==Syntax==
*'''isloggedin'''(<account id>[, <char id>]);

==Description==
This function checks, whether an character with given [[AID|account id]] is currently online (1) or not (0). Additionally a [[CID|char id]] can be specified, for exact character matching.

==Examples==
[[input]] .@aid;
if(isloggedin(.@aid))
{
[[mes]] "A character with account id "+.@aid+" is currently around.";
}
else
{
mes "Sorry, there is no character online with account id "+.@aid+",";
mes "or the account does not exist.";
}

==See Also==
* [[attachrid]]

[[Category:Script Command]]

Initnpctimer

2015-01-17T14:05:13Z

Ind: nevermind me [5] (testing stuff)

==Syntax==
* [[initnpctimer]] {<attach flag>};
* [[initnpctimer]] {"<NPC name>"};
* [[initnpctimer]] {"<NPC name>"{, <attach flag>}};

==Description==

This script command will begin an NPC-attached timer on the running or specified NPC. The timer will run internally in the NPC and is not attached to any player, so will continue to run even when there are no players logged on. It is important to note that an NPC can only run a single timer on itself at any given time. In order to process multiple timers, the script would have to use player based timers such as [[addtimer]].

The timer runs in milliseconds (1/1000th of a second) from 0, and calling this script command will begin a new timer (if a timer is not already running on the NPC) or reset the current timer on the NPC. To completely stop the NPC timer, the script command [[stopnpctimer]] must be called, and to resume the timer (without resetting the current tick) the script command [[startnpctimer]] must be called.

The script can access a timer event by creating a label matching the format "OnTimer<tick>:" where the <tick> is replaced with a millisecond value to occur on. The NPC timer does not reset automatically once reaching one of these labels, therefore it is possible to multiple labels with incremented <tick> values to handle the same NPC timer (see [[#Examples|Examples]]).

==Parameters==
===Attach Flag===

The flag value determines whether a player should be directly associated with this NPC timer. When flag is specified (a value of 1) the script will attach the player who is currently attached to the script, to the timer. If no player is attached to the script when this flag is specified, then the [[initnpctimer]] call will fail.

If a player is successfully attached to the NPC timer, and logs out of the game, then the event label "OnTimerQuit:" will run on the NPC (the player will still be logged in at this point) to allow cleaning up and handling of the timer.

===NPC Name===

If specified, the call to [[initnpctimer]] will not apply to the current running script but will take effect on the NPC which exists with the passed NPC name. If an NPC could not be found with this name then the [[initnpctimer]] call will fail.

==Examples==
* Announce every 1 second (resetting the timer after every 1000 milliseconds)
initnpctimer;
end;

[[OnTimer]]1000:
[[announce]] "1 second has passed!", bc_all|bc_npc;
initnpctimer;
[[end]];
* Announce at 5 and 10 seconds (stopping the timer once 10000 milliseconds is reached)
initnpctimer;
end;

[[OnTimer]]5000:
[[announce]] "5 seconds have passed!", bc_all|bc_npc;
[[end]];

OnTimer10000:
announce "10 seconds have passed!!", bc_all|bc_npc;
[[stopnpctimer]];
end;

* Perform an event on a player every 60 seconds (resetting the timer after every 60000 milliseconds)
initnpctimer 1;
end;

[[OnTimer]]60000:
[[percentheal]] 10, 0;
[[message]] [[strcharinfo]](0), "You were healed 10% HP!";
initnpctimer 1;
[[end]];

OnTimerQuit:
[[stopnpctimer]];
[[end]];

[[Category:Script Command]]

Min

2015-01-17T14:04:37Z

Ind: nevermind me [4] (testing stuff)

== Syntax ==
*[[min]](<number>{,<number>...<number>})
*[[max]](<number>{,<number>...<number>})

== Description ==
Returns the smallest (or biggest) from the set of given numbers.

== Example ==
<pre> .@minimum = min(1, -6, -2, 8, 2); // .@minimum will be equal to -6
.@maximum = max(0, 5, 10, 4); // .@maximum will be equal to 10
.@level = min(BaseLevel, 70); // .@level will be the character's base level, capped to 70
</pre>

[[Category:Script Command]]

Do

2015-01-17T13:53:25Z

Ind: nevermind me [2]

== Syntax ==
* [[do]] { <statement>; } [[while]] (<condition>);

== Description ==
The '[[do]]...[[while]]' is the only post-test loop structure available in this
script language. With a post-test, the statements are executed once before
the condition is tested. When the condition is true, the statement(s) are
repeated. When the condition is false, control is transferred to the
statement following the '[[do]]...[[while]]' loop expression.

<pre>do {
Code to execute(1)
} while (expression(2));</pre>

<pre>Example 1: sentinel-controlled loop
mes "This menu will keep appearing until you pick Cancel";
do {
set .@menu, select("One:Two:Three:Cancel");
} while (.@menu != 4);
</pre>

<pre>Example 2: counter-controlled loop
mes "This will countdown from 10 to 1.";
set .@i, 10;
do {
mes .@i;
set .@i, .@i - 1;
} while (.@i > 0);
</pre>

[[Category:Script Command]]

Do

2015-01-17T13:52:28Z

Ind: nevermind this

System Requirements

2014-02-24T21:40:45Z

Ind: Updated memory usage with latest tests

== Basic Requirements ==

[[Hercules]] works off of the [[wikipedia:Client–server_model|client-server model]]. The player, usually using a [[Hexing|hexed]] kRO [[Renewal|RE]] client, first connects to the [[Login Server]]. When the client enters their login information, it is given the list of available char-servers, which the player chooses from. After the server has been chosen, the client connects to the selected [[Character Server]], which displays the characters on that player's account. After selecting a character, the client is directed to the [[Map Server]], which maintains maps and the character positions on the server and relays this information to the client.

Hercules is designed to run on a machine that is designated as a Server, either Dedicated or VPS. It can run on a workstation, but using that workstation for other tasks (including playing on the same machine that is running the server) will reduce performance.

== Hardware Requirements ==
Hercules requires the following resources from the machine in order to function without problems or the common "Lag":

* 1.5 GHz or faster CPU, either Intel or AMD is acceptable. Some members have reported that they have gotten Hercules to run on other processors.
* 128 MB of RAM, MINIMUM. The map server in an idle state consumes about 76MB of RAM, depending on how many maps and [[NPC|NPCs]] are loaded (41mb when no NPCs are in use).
* A video card powerful enough to run the Operating System of your choice. Hercules is a console based software, which means that all that is required to run it is a console or command access.
* Fast internet or network connection. This is very hard to predict. A lot of questions arise that ask 'how much bandwidth does Hercules need?'. There is no answer to that. It is all depending on how many characters are connected, from where, and what they do while connected to the server.
* 250MB of Hard Drive space or better, up-to 1GB depending on how big the database may get.

== Software Requirements ==
Hercules, depending on what you plan to do with it and what platform you run it on, will require, at a minimum, the following:

* GCC compatible compiler
* zlib
* MySQL server and libraries
* Git (if using self-compiled packages)

== Supported Operating Systems ==
The following operating systems have been tested and are known to work:
=== [[wikipedia:Linux|Linux]] ===
* Debian Based: [http://www.debian.org/ Debian], [http://www.knoppix.net/ Knoppix], [http://www.ubuntu.com/ Ubuntu Server & Desktop]
* RPM Based: [http://www.centos.org/ CentOS], [http://fedoraproject.org/ Fedora Core], [http://www2.mandriva.com/ Mandriva], [http://www.redhat.com/rhel/ Red Hat Linux], [http://www.novell.com/linux/ SUSE Linux]
* Slackware Based: [http://www.slackware.com/ Slackware]
=== [[wikipedia:Unix|Unix]] ===
* BSD Based: [http://www.freebsd.org/ FreeBSD], [http://www.openbsd.org/ OpenBSD]
=== [[wikipedia:Microsoft_Windows|Windows]] ===
* [[wikipedia:Windows_Server|Server Versions]]: Windows Server 2000, Windows Server 2003, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012
* Home Versions: Windows 98, Windows ME, Windows 2000, Windows XP, Windows Vista, Windows 7

64-bit operating systems of all those listed will take some time and effort to get working.

[[Category:Basics]]

Clientinfo.xml

2013-11-16T23:34:46Z

Ind:

''sclientinfo.xml'' is a file that configures your modified Sakray client so that it may connect to Hercules Servers, for non-Sakray and Renewal clients this file is usually called ''clientinfo.xml''.

== Template ==
<pre><?xml version="1.0" encoding="euc-kr" ?>
<clientinfo>
<desc>Ragnarok Client Information</desc>
<servicetype>korea</servicetype>
<servertype>sakray</servertype>
<hideaccountlist />
<passwordencrypt />
<passwordencrypt2 />
<extendedslot />
<readfolder />
<connection>
<display>SERVER NAME HERE</display>
<desc>Ragnarok Online</desc>
<balloon>this is a tool tip</balloon>
<address>SERVER IP HERE</address>
<port>6900</port>
<version>20</version>
<langtype>1</langtype>
<registrationweb>REGISTRATION URL HERE</registrationweb>
<yellow>
<admin>2000001</admin>
<admin>2000002</admin>
<admin>2000003</admin>
</yellow>
<loading>
<image>loading00.jpg</image>
<image>loading01.jpg</image>
<image>loading02.jpg</image>
<image>loading03.jpg</image>
<image>loading04.jpg</image>
<image>loading05.jpg</image>
<image>loading06.jpg</image>
<image>loading07.jpg</image>
<image>loading08.jpg</image>
<image>loading09.jpg</image>
<image>loading10.jpg</image>
</loading>
</connection>
</clientinfo></pre>

== Explanation ==
{| class="wikitable" border="1"
|-
!Tag
!Description
|-
|<servicetype>||Specifies the client service type (country). Affects client behavior for some features. See below for valid values. Should be set to '''korea''', unless you know, what you want to achieve by using another value.
|-
|<servertype>||Specifies the server type this client is intended for. Affects client behavior for some features. See below for valid values. Should be set to '''sakray''', unless you know, what you want to achieve by using another value.
|-
|<hideaccountlist />||When present, disallows the client from showing Service Select screen and uses the first <connection> entry automatically.
|-
|<passwordencrypt />||When present, passwords are encrypted (method 1) before being sent to the server. Incompatible with '''use_MD5_passwords''' defined in .../conf/login_athena.conf.
|-
|<passwordencrypt2 />||When present, passwords are encrypted (method 2) before being sent to the server. When you use this with <passwordencrypt />, method 2 will be used. Incompatible with '''use_MD5_passwords''' defined in .../conf/login_athena.conf.
|-
|<extendedslot />||When present, all character slots (usually 9) are available. Otherwise only 2-4 are enabled for use, others are displayed as 'Not available'.
|-
|<readfolder />||When present, all files are first searched inside the /data/ folder, then inside the [[GRF]] archives. Otherwise files inside the /data/ folder are only accessed, when they were not found inside the GRF archives.
|-
|<display>||Displays the name of the server at the Service Select screen.
|-
|<desc>||Server description.
|-
|<balloon>||This tag tells the game to display a tooltip when the cursor is over the server name on the server select screen.
|-
|<address>||IP or DNS address of the server (for DNS, client needs the DNS hex).
|-
|<port>||Connection server port (default 6900).
|-
|<version>||Must be equal to '''client_version_to_connect''' defined in .../conf/login_athena.conf.
|-
|<langtype>||See table below.
|-
|<registrationweb>||Web address to open when you click the Register button.
|-
|<yellow>||Characters with the following Account IDs will be seen in GM sprites and have Yellow name/chat (add the Account IDs of all your GMs here).
|-
|<aid>||Use instead of <yellow> to also allow the right-click menu for your GMs.
|-
|<loading>||Define each loading screen in the path .../data/texture/À¯ÀúÀÎÅÍÆäÀÌ½º/ (to use more than 10, client also needs Unlimited Loading Screens hex).
|}

'''Note:''' All [[wikipedia:XML|XML]] rules apply, so <tag /> options can also be written as <tag></tag>.

+-----+------------------------+-------------------+
| int | enum SERVICETYPE | "servicetype" tag |
+-----+------------------------+-------------------+
| 0 | SERVICETYPE_KOREA | korea |
| 1 | SERVICETYPE_AMERICA | america |
| 2 | SERVICETYPE_JAPAN | japan |
| 3 | SERVICETYPE_CHINA | china |
| 4 | SERVICETYPE_TAIWAN | taiwan |
| 5 | SERVICETYPE_THAI | thai |
| 6 | SERVICETYPE_INDONESIA | indonesia |
| 7 | SERVICETYPE_PHILIPPINE | philippine |
| 8 | SERVICETYPE_MALAYSIA | malaysia |
| 9 | SERVICETYPE_SINGAPORE | singapore |
| 10 | SERVICETYPE_GERMANY | germany |
| 11 | SERVICETYPE_INDIA | india |
| 12 | SERVICETYPE_BRAZIL | brazil |
| 13 | SERVICETYPE_AUSTRALIA | australia |
| 14 | SERVICETYPE_RUSSIA | russia |
| 15 | SERVICETYPE_VIETNAM | vietnam |
| 17 | SERVICETYPE_CHILE | chile |
| 18 | SERVICETYPE_FRANCE | france |
| 19 | SERVICETYPE_UAE | uae |
+-----+------------------------+-------------------+

+-----+------------------------+-------------------+
| int | enum ServerType | "servertype" tag |
+-----+------------------------+-------------------+
| 0 | ServerPrimary | primary |
| 1 | ServerSakray | sakray |
| 2 | ServerLocal | local |
| 5 | ServerPK | pk |
+-----+------------------------+-------------------+

[[Category:Client Configuration]]

System Requirements

2013-11-08T22:52:52Z

Ind:

== Basic Requirements ==

[[Hercules]] works off of the [[wikipedia:Client–server_model|client-server model]]. The player, usually using a [[Hexing|hexed]] kRO [[Renewal|RE]] client, first connects to the [[Login Server]]. When the client enters their login information, it is given the list of available char-servers, which the player chooses from. After the server has been chosen, the client connects to the selected [[Character Server]], which displays the characters on that player's account. After selecting a character, the client is directed to the [[Map Server]], which maintains maps and the character positions on the server and relays this information to the client.

Hercules is designed to run on a machine that is designated as a Server, either Dedicated or VPS. It can run on a workstation, but using that workstation for other tasks (including playing on the same machine that is running the server) will reduce performance.

== Hardware Requirements ==
Hercules requires the following resources from the machine in order to function without problems or the common "Lag":

* 1.5 GHz or faster CPU, either Intel or AMD is acceptable. Some members have reported that they have gotten Hercules to run on other processors.
* 128 MB of RAM, MINIMUM. The map server in an idle state consumes about 87MB of RAM, depending on how many maps and [[NPC|NPCs]] are loaded.
* A video card powerful enough to run the Operating System of your choice. Hercules is a console based software, which means that all that is required to run it is a console or command access.
* Fast internet or network connection. This is very hard to predict. A lot of questions arise that ask 'how much bandwidth does Hercules need?'. There is no answer to that. It is all depending on how many characters are connected, from where, and what they do while connected to the server.
* 250MB of Hard Drive space or better, up-to 1GB depending on how big the database may get.

== Software Requirements ==
Hercules, depending on what you plan to do with it and what platform you run it on, will require, at a minimum, the following:

* GCC compatible compiler
* zlib
* MySQL server and libraries
* Git (if using self-compiled packages)

== Supported Operating Systems ==
The following operating systems have been tested and are known to work:
=== [[wikipedia:Linux|Linux]] ===
* Debian Based: [http://www.debian.org/ Debian], [http://www.knoppix.net/ Knoppix], [http://www.ubuntu.com/ Ubuntu Server & Desktop]
* RPM Based: [http://www.centos.org/ CentOS], [http://fedoraproject.org/ Fedora Core], [http://www2.mandriva.com/ Mandriva], [http://www.redhat.com/rhel/ Red Hat Linux], [http://www.novell.com/linux/ SUSE Linux]
* Slackware Based: [http://www.slackware.com/ Slackware]
=== [[wikipedia:Unix|Unix]] ===
* BSD Based: [http://www.freebsd.org/ FreeBSD], [http://www.openbsd.org/ OpenBSD]
=== [[wikipedia:Microsoft_Windows|Windows]] ===
* [[wikipedia:Windows_Server|Server Versions]]: Windows Server 2000, Windows Server 2003, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012
* Home Versions: Windows 98, Windows ME, Windows 2000, Windows XP, Windows Vista, Windows 7

64-bit operating systems of all those listed will take some time and effort to get working.

[[Category:Basics]]

Editing the wiki

2013-10-31T16:48:32Z

Ind:

==Welcome to the Hercules wiki!==
The Hercules wiki could always use some help. It is an ever changing repository of information related to Hercules, such as installation, configuration, scripting and even some client support. The wiki thanks you for stopping by and showing some interest in helping get the wiki full of the most useful information for Hercules.

===Where to Begin?===
All users must login to the wiki using their forum account. Any member with more than 1 post on the forums can edit the wiki, but please keep in mind that the Hercules wiki is released under the [[wikipedia:GNU_Free_Documentation_License|GNU Free Documentation License]] Version 1.2. This means that the wiki and any works put on it can be edited at will. They may also be distributed, provided all history and copylefts remain intact. Please see read this page for more information.

Don't know where to start? Check the [[Special:WantedPages]] page and create a page that is listed there!

Please do not create pages for custom content, such as custom projects not relating to Hercules in any way. A full list of content that should not be on the wiki is listed at [[Editing the wiki]].

Please see [[:Category:Wiki_Projects|Wiki Projects]] for any ongoing projects that you might be able to help with!

===License Requirements===
The Hercules wiki is to be released under the [[wikipedia:GNU_Free_Documentation_License|GNU Free Documentation License]]. For those that do not know, this license allows anyone to edit your work on the wiki at will, provided that all pertinent history is remained intact and all copylefts are abided by. This work can also be redistributed, again, provided that all copylefts remain intact.

===Editing Requirements===
You might be eager to start editing. The first question is....how do I start?

With the Hercules wiki, you can use IPB BBCodes to format your work, but there is a helpful toolbar at the top of the edit box to help you as well.

You can create a new page, but make sure that the page you are creating [[Special:AllPages|doesn't exist yet]] and preferably is already [[Special:WantedPages|being linked to]]. If it already exists, maybe you can head over and help edit in something that might be missing that someone forgot.

===General Rules for the Hercules wiki===
{{outdated|type=section}}
These guidelines/rules should be followed on the Hercules wiki. If not followed, your account is at risk for being banned from the wiki '''as well as''' from the forums. You have been warned.
* Deleting a page must come from a Community Administrator or a Documentation Manager. If you have a page that you request for deletion, please add the <code><nowiki>{{deletion suggested}}</nowiki></code> template. See [[Template:Delete]] for details.
* Editing wars are not to be tolerated. It creates unwanted and unneeded long history.
* Pornography is a not to appear on the Hercules wiki.
* Text must be appropriate in nature and not contain foul language.

===General tips for editing a wiki===
These tips should be referenced when you need to edit/write an article.
* As mentioned before, make sure that if a new page is being created, it [[Special:AllPages|doesn't exist yet]].
* Use proper English with proper spelling and grammar. The Hercules wiki is in English and English only at this point.
* Links should not appear in topic titles, such as the title of a section.
* There should be no reason to link to a page more than once if it appears in the article multiple times. The first mention of a topic that has a page should be linked to.
* Name your page appropriately and avoid special symbols. Don't make your page too long, but think of a name that will relate to the article (i.e: Don't name your article related to XRay 'client').
* Use images when Windows is involved. It is too hard and sometimes troublesome to read an article with the text: Go here, click OK, go here, hover your mouse here, click here, type this, click here, drag it to here, etc.
* Any section or article that relates to changing code should be in DIFF or PATCH format. This includes all of the proper syntax. If you do not know what a diff or patch file is, please refer to it's Wikipedia article [[wikipedia:Diff#Unified_format|here]]. 'find and replace' text is not acceptable.
* Make use of Wikipedia's help articles, if you are unsure about [[wikipedia:Wikipedia:How_to_edit_a_page|editing articles]] or [[wikipedia:Help:Wiki_markup|the use of some wiki-code]]. Note, that most of the templates used on Wikipedia cannot be applied to the Hercules wiki, except [[:Category:Templates|few ones]].
* Use the ''Show preview'' button before saving the page, especially when you are unsure, how your edit turns out. This helps avoiding follow-up "ooops"-edits.
* Before you save an article, add reason for your edit or summary of your edit in the ''Summary'' line. You help others to recognize, what was changed and why in the [[Special:RecentChanges|list of recent changes]] and it distinguishes you from spam-bots, which do not add a reason. You do not need to add a summary for your user-page or on article's talk pages. If you cannot remember what you changed, use the ''Show changes'' button to review all changes done to the page as a diff.
* Avoid excessive amount of formatting. Use either '''bold''' or ''italics'' but not '''''both'''''. Refrain from using underlining as this usually gives the impression of a link. <s>Strike-through</s> should be used on talk pages only, if there is something in an article to invalidate, simply delete it.

===Script Command Pages===
As a general rule of thumb, the following format should be used in order to keep the articles in a uniform fashion.

<nowiki>==Syntax==
*'''scriptcommand'''(<argument1>, <"argument2">);

==Description==
This command does this and that, and arguments mean that and this.

==Examples==
[[mes]] "...";
[[if]](scriptcommand(1, "abc"))
{
mes "...";
}
[[close]];

==See Also==
* [[related script command 1]]
* [[related script command 2]]

[[Category:Script Command]]</nowiki>

Building HPM Plugin for gcc

2013-10-27T17:17:27Z

Ind: thanks to haruna make will know the file was changed and reload confiugre on its own.

This is a guide on how to prepare your gcc environment for a new [[HPM]] plugin.
= Guide =
In your '''src/plugins/Makefile.in''' file you should find something like:
################ PLUGIN CONFIGURATION ##############################
# #
# When you add a plugin, add its name here: #
# Example: if you have a plugin named my_cool_plugin.c and another #
# one named my_second_plugin.c, add them to the list like this: #
# #
# MYPLUGINS = my_cool_plugin my_second_plugin #
# #
# Note: DO NOT include the .c extension!!! #

MYPLUGINS =
add your plugin name (without the .c extension), after '''MYPLUGINS =''' save and close. 
Lastly, run '''make plugins''' command at the root folder of Hercules, and you're good to go.
[[HPM]]
[[Category:Installation]]

Hercules Plugin Manager

2013-10-04T19:55:51Z

Ind:

Often referred to as the [[HPM]], the '''Hercules Plugin Manager''' is yet another [[Hercules Original]]
= Building a plugin =
While the [[C]] code for the plugin normally won't have discrepancies, in order to [[compile]] the plugin certain criteria must be met depending on your Operating System, there are 2 guides below, one for windows and other for everything else (which should work on any *nix distro, as well as on OSX).
;Windows
: [[Building HPM Plugin for MSVC]]
;All Others
: [[Building HPM Plugin for gcc]]

= Creating a plugin =
After following the [[#Building_a_plugin|building a plugin]] guide, all thats left is for your plugin's code to be made, the following will guide you through the basics of how a [[HPM]] plugin works.
== HPM Events ==
Events are functions in a plugin that are triggered by the '''Hercules Plugin Mananger''' when they meet certain criteria. 
* <code>void plugin_init (void)</code>
** Triggered when the server starts
* <code>void plugin_final (void)</code>
** Triggered when the server starts to shut itself down
* <code>void server_ready (void)</code>
** Triggered after the server is done starting, and is online.
* <code>void server_post_final (void)</code>
** Triggered after the server's main shutdown procedures are complete, core functionality such as memory manager, timer, and sockets are still available at this point.
With the [[HPM]] you only need to code the events your plugin will use.
== HPM Hooks ==
In Hercules, hooking is a simple operation, it is possible to hook an infinite number of times to the over 2k hookable functions (all the interfaced ones, accounting for over 99% of map server) 
HPExport void plugin_init (void) {
addHookPre("pc->dropitem",my_pc_dropitem_preHook); /* int my_pc_dropitem_preHook(struct map_session_data *sd,int *n,int *amount) */
addHookPost("pc->dropitem",my_pc_dropitem_postHook);/* int my_pc_dropitem_postHook(int retVal, struct map_session_data *sd,int *n,int *amount) */
}
Hooks receive all function params as pointers, whereas the original may be
int pc_dropitem(struct map_session_data *sd,int n,int amount)
the one for the hook shall be
(struct map_session_data *sd,int *n,int *amount)
which allows for hooks to modify any and all data as it pleases. 
postHooks receive one additional param, which accounts for the result of the original function,
int <name>(int retVal, struct map_session_data *sd,int *n,int *amount)
In this case it'd allow for the postHook to react properly to what the original returned, in this case (for pc_dropitem) 0 (failure) or 1 (success) 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM @commands ==
The [[HPM]] makes it very simple to provide [[@commands]] through plugins. 
You define a new atcommand exactly as it'd normally be done in {{git|src/map/atcommand.c}} 
'''Example:'''
ACMD(sample) {//@sample command - 5 params: const int fd, struct map_session_data* sd, const char* command, const char* message, struct AtCommandInfo *info
clif->message(fd,"You used the @sample command!");
ShowDebug("I'm being run! message -> '%s' by '%s'\n",message,sd->status.name);
return true;
}
After that you just have to link your new command, to do that you use the <code>void plugin_init (void)</code> event.
HPMi->addCommand("sample",ACMD_A(sample));
and voila, your plugin now adds the '''@sample''' command. 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM Script Commands ==
The [[HPM]] makes it very simple to provide [[Category:Script_Command|script commands]] through plugins. 
You define a new script command exactly as it'd normally be done in {{git|src/map/script.c}} 
'''Example:'''
BUILDIN(sample) {//script command 'sample(num);' - 1 param: struct script_state* st
int arg = script_getnum(st,2);
ShowInfo("I'm being run! arg -> '%d'\n",arg);
return true;
}
After that you just have to link your new script command, to do that you use the <code>void plugin_init (void)</code> event.
HPMi->addScript("sample","i",BUILDIN_A(sample)); //note the 2nd param is this commands' arg-types (in this case, a number)
and voila, your plugin now adds the '''sample''' script command. 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM Console Commands ==
The [[HPM]] makes it very simple to provide [[Category:Console_Command|console commands]] through plugins. 
You define a new console command exactly as it'd normally be done in {{git|src/common/console.c}} 
'''Example:'''
CPCMD(sample) {//console command 'sample' - 1 param: char *line
ShowInfo("I'm being run! arg -> '%s'\n",line?line:"NONE");
}
After that you just have to link your new script command, to do that you use the <code>void plugin_init (void)</code> event.
addCPCommand("this:is:a:sample",CPCMD_A(sample)); // note the first param is the path to this command, in this case it translates to 'this is a sample' and everything afterwards is the commands' params
and voila, your plugin now adds the '''sample''' console command. 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM Custom Packets ==
The HPM makes it possible for a plugin to add or override packets within all 3 servers 
'''Example:'''
/* sample packet implementation */
/* cmd 0xf3 - it is a client-server existent id, for clif_parse_GlobalMessage */
/* in this sample we do nothing and simply redirect */
void sample_packet0f3(int fd) {
struct map_session_data *sd = session[fd]->session_data;

if( !sd ) return;/* socket didn't fully log-in? this packet shouldn't do anything then! */

ShowInfo("sample_packet0f3: Hello World! received 0xf3 for '%s', redirecting!\n",sd->status.name);

clif->pGlobalMessage(fd,sd);
}
void plugin_init(void) {
HPMi->addPacket(0xf3,-1,sample_packet0f3,hpClif_Parse,HPMi->pid);
}
and voila, your plugin just changed the map server's '''0xf3''' packet to pass by '''sample_packet0f3''' prior to being sent to '''clif_parse_GlobalMessage''' 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM Custom Data Structs ==
The HPM makes it possible for a plugin to create and append structs to existent data, this feature is currently supported on player units (map_session_data) and network pipes (socket_data) 
'''Example:'''
/* can be of any size, using any data types */
struct sample_data_struct {
struct point lastMSGPosition;
unsigned int someNumber;
};
/* appends/reads sample_data_struct in a network session data entry (socket_data) */
void some_function_receiving_a_socket_fd(int fd) {
struct sample_data_struct *data;

if( !(data = HPMi->getFromSession(session[fd],HPMi->pid,0)) ) {
CREATE(data,struct sample_data_struct,1);

data->lastMSGPosition.map = 1;
data->lastMSGPosition.x = 150;
data->lastMSGPosition.y = 150;
data->someNumber = rand()%777;

ShowInfo("Created Appended session[] data, %d %d %d %d\n",data->lastMSGPosition.map,data->lastMSGPosition.x,data->lastMSGPosition.y,data->someNumber);
HPMi->addToSession(session[fd],data,HPMi->pid,0,true);
} else {
ShowInfo("Existent Appended session[] data, %d %d %d %d\n",data->lastMSGPosition.map,data->lastMSGPosition.x,data->lastMSGPosition.y,data->someNumber);
if( rand()%4 == 2 ) {
ShowInfo("Removing Appended session[] data\n");
HPMi->removeFromSession(session[fd],HPMi->pid,0);
}
}
}
and voila, your plugin becomes capable of appending and handling your custom struct data 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM Function Overloading ==
Thanks to [[Hercules Renewal Phase One]], you're capable of overloading all functions covered by the [[Hercules Renewal Phase One]] interfaces, with your plugin. 
'''Example:'''
int my_custom_check_target_function( struct block_list *src, struct block_list *target,int flag) {
//<...> code
}
void server_ready(void) {
battle = GET_SYMBOL("battle");
battle->check_target = &my_custom_check_target_function;
}
and voila, your plugin just overloaded the game server's '''battle_check_target''' function with your plugin's own, this is greatly handy to ensure your customs do not create conflicts when updating your [[Hercules|Hercules Repository]]
= Other Features =
Is there something you'd like to do with your plugin that requires modifications to [[HPM]]'s core? [http://hercules.ws/board/forum/55-suggestions/ let we know], and we'll do our best to make it happen. 
[http://hercules.ws/board/forum/55-suggestions/ Post your suggestions here]
= Support =
Need help writing your plugin? [http://hercules.ws/board/forum/26-source-support/ post your question on our support forum]

Hercules Plugin Manager

2013-10-04T19:53:24Z

Ind:

Often referred to as the [[HPM]], the '''Hercules Plugin Manager''' is yet another [[Hercules Original]]
= Building a plugin =
While the [[C]] code for the plugin normally won't have discrepancies, in order to [[compile]] the plugin certain criteria must be met depending on your Operating System, there are 2 guides below, one for windows and other for everything else (which should work on any *nix distro, as well as on OSX).
;Windows
: [[Building HPM Plugin for MSVC]]
;All Others
: [[Building HPM Plugin for gcc]]

= Creating a plugin =
After following the [[#Building_a_plugin|building a plugin]] guide, all thats left is for your plugin's code to be made, the following will guide you through the basics of how a [[HPM]] plugin works.
== HPM Events ==
Events are functions in a plugin that are triggered by the '''Hercules Plugin Mananger''' when they meet certain criteria. 
* <code>void plugin_init (void)</code>
** Triggered when the server starts
* <code>void plugin_final (void)</code>
** Triggered when the server starts to shut itself down
* <code>void server_ready (void)</code>
** Triggered after the server is done starting, and is online.
With the [[HPM]] you only need to code the events your plugin will use.
== HPM Hooks ==
In Hercules, hooking is a simple operation, it is possible to hook an infinite number of times to the over 2k hookable functions (all the interfaced ones, accounting for over 99% of map server) 
HPExport void plugin_init (void) {
addHookPre("pc->dropitem",my_pc_dropitem_preHook); /* int my_pc_dropitem_preHook(struct map_session_data *sd,int *n,int *amount) */
addHookPost("pc->dropitem",my_pc_dropitem_postHook);/* int my_pc_dropitem_postHook(int retVal, struct map_session_data *sd,int *n,int *amount) */
}
Hooks receive all function params as pointers, whereas the original may be
int pc_dropitem(struct map_session_data *sd,int n,int amount)
the one for the hook shall be
(struct map_session_data *sd,int *n,int *amount)
which allows for hooks to modify any and all data as it pleases. 
postHooks receive one additional param, which accounts for the result of the original function,
int <name>(int retVal, struct map_session_data *sd,int *n,int *amount)
In this case it'd allow for the postHook to react properly to what the original returned, in this case (for pc_dropitem) 0 (failure) or 1 (success) 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM @commands ==
The [[HPM]] makes it very simple to provide [[@commands]] through plugins. 
You define a new atcommand exactly as it'd normally be done in {{git|src/map/atcommand.c}} 
'''Example:'''
ACMD(sample) {//@sample command - 5 params: const int fd, struct map_session_data* sd, const char* command, const char* message, struct AtCommandInfo *info
clif->message(fd,"You used the @sample command!");
ShowDebug("I'm being run! message -> '%s' by '%s'\n",message,sd->status.name);
return true;
}
After that you just have to link your new command, to do that you use the <code>void plugin_init (void)</code> event.
HPMi->addCommand("sample",ACMD_A(sample));
and voila, your plugin now adds the '''@sample''' command. 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM Script Commands ==
The [[HPM]] makes it very simple to provide [[Category:Script_Command|script commands]] through plugins. 
You define a new script command exactly as it'd normally be done in {{git|src/map/script.c}} 
'''Example:'''
BUILDIN(sample) {//script command 'sample(num);' - 1 param: struct script_state* st
int arg = script_getnum(st,2);
ShowInfo("I'm being run! arg -> '%d'\n",arg);
return true;
}
After that you just have to link your new script command, to do that you use the <code>void plugin_init (void)</code> event.
HPMi->addScript("sample","i",BUILDIN_A(sample)); //note the 2nd param is this commands' arg-types (in this case, a number)
and voila, your plugin now adds the '''sample''' script command. 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM Console Commands ==
The [[HPM]] makes it very simple to provide [[Category:Console_Command|console commands]] through plugins. 
You define a new console command exactly as it'd normally be done in {{git|src/common/console.c}} 
'''Example:'''
CPCMD(sample) {//console command 'sample' - 1 param: char *line
ShowInfo("I'm being run! arg -> '%s'\n",line?line:"NONE");
}
After that you just have to link your new script command, to do that you use the <code>void plugin_init (void)</code> event.
addCPCommand("this:is:a:sample",CPCMD_A(sample)); // note the first param is the path to this command, in this case it translates to 'this is a sample' and everything afterwards is the commands' params
and voila, your plugin now adds the '''sample''' console command. 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM Custom Packets ==
The HPM makes it possible for a plugin to add or override packets within all 3 servers 
'''Example:'''
/* sample packet implementation */
/* cmd 0xf3 - it is a client-server existent id, for clif_parse_GlobalMessage */
/* in this sample we do nothing and simply redirect */
void sample_packet0f3(int fd) {
struct map_session_data *sd = session[fd]->session_data;

if( !sd ) return;/* socket didn't fully log-in? this packet shouldn't do anything then! */

ShowInfo("sample_packet0f3: Hello World! received 0xf3 for '%s', redirecting!\n",sd->status.name);

clif->pGlobalMessage(fd,sd);
}
void plugin_init(void) {
HPMi->addPacket(0xf3,-1,sample_packet0f3,hpClif_Parse,HPMi->pid);
}
and voila, your plugin just changed the map server's '''0xf3''' packet to pass by '''sample_packet0f3''' prior to being sent to '''clif_parse_GlobalMessage''' 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM Custom Data Structs ==
The HPM makes it possible for a plugin to create and append structs to existent data, this feature is currently supported on player units (map_session_data) and network pipes (socket_data) 
'''Example:'''
/* can be of any size, using any data types */
struct sample_data_struct {
struct point lastMSGPosition;
unsigned int someNumber;
};
/* appends/reads sample_data_struct in a network session data entry (socket_data) */
void some_function_receiving_a_socket_fd(int fd) {
struct sample_data_struct *data;

if( !(data = HPMi->getFromSession(session[fd],HPMi->pid,0)) ) {
CREATE(data,struct sample_data_struct,1);

data->lastMSGPosition.map = 1;
data->lastMSGPosition.x = 150;
data->lastMSGPosition.y = 150;
data->someNumber = rand()%777;

ShowInfo("Created Appended session[] data, %d %d %d %d\n",data->lastMSGPosition.map,data->lastMSGPosition.x,data->lastMSGPosition.y,data->someNumber);
HPMi->addToSession(session[fd],data,HPMi->pid,0,true);
} else {
ShowInfo("Existent Appended session[] data, %d %d %d %d\n",data->lastMSGPosition.map,data->lastMSGPosition.x,data->lastMSGPosition.y,data->someNumber);
if( rand()%4 == 2 ) {
ShowInfo("Removing Appended session[] data\n");
HPMi->removeFromSession(session[fd],HPMi->pid,0);
}
}
}
and voila, your plugin becomes capable of appending and handling your custom struct data 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM Function Overloading ==
Thanks to [[Hercules Renewal Phase One]], you're capable of overloading all functions covered by the [[Hercules Renewal Phase One]] interfaces, with your plugin. 
'''Example:'''
int my_custom_check_target_function( struct block_list *src, struct block_list *target,int flag) {
//<...> code
}
void server_ready(void) {
battle = GET_SYMBOL("battle");
battle->check_target = &my_custom_check_target_function;
}
and voila, your plugin just overloaded the game server's '''battle_check_target''' function with your plugin's own, this is greatly handy to ensure your customs do not create conflicts when updating your [[Hercules|Hercules Repository]]
= Other Features =
Is there something you'd like to do with your plugin that requires modifications to [[HPM]]'s core? [http://hercules.ws/board/forum/55-suggestions/ let we know], and we'll do our best to make it happen. 
[http://hercules.ws/board/forum/55-suggestions/ Post your suggestions here]
= Support =
Need help writing your plugin? [http://hercules.ws/board/forum/26-source-support/ post your question on our support forum]

Building HPM Plugin for gcc

2013-10-04T19:49:56Z

Ind:

This is a guide on how to prepare your gcc environment for a new [[HPM]] plugin.
= Guide =
In your '''src/plugins/Makefile.in''' file you should find something like:
################ PLUGIN CONFIGURATION ##############################
# #
# When you add a plugin, add its name here: #
# Example: if you have a plugin named my_cool_plugin.c and another #
# one named my_second_plugin.c, add them to the list like this: #
# #
# MYPLUGINS = my_cool_plugin my_second_plugin #
# #
# Note: DO NOT include the .c extension!!! #

MYPLUGINS =
add your plugin name (without the .c extension), after '''MYPLUGINS =''' save and close. 
Lastly, re-run your '''./configure''' command at the root folder of Hercules, and you're good to go.
[[HPM]]
[[Category:Installation]]

MSVC Crash Debugging

2013-08-23T15:15:05Z

Ind:

1. In the '''Solution Explorer''' sidebar, right click '''map-server''' 
2. Hit '''Set as StartUp Project''' 
3. right click '''map-server''' again, hit '''Properties''' 
4. In the '''Properties''' window, within '''Configuration Properties''' -> '''Debugging''', change '''Working Directory''' to '''$(SolutionDir)''', then save & close the '''Properties''' window. 
5. Hit '''F5''' key it will launch map server under debug mode, once it crashes a '''Call Stack''' window will be populated with useful debug information. 

== Footnote ==
Written by a non-MSVC user, please improve at will, and feel free to dump this footnote when you do so.

MSVC Crash Debugging

2013-08-23T15:12:47Z

Ind: Created page with "1. In the 'Solution Explorer' sidebar, right click map-server 2. Hit 'Set as StartUp Project' 3. right click map-server again, hit 'Properties' 4. In the Proper..."

1. In the 'Solution Explorer' sidebar, right click map-server 
2. Hit 'Set as StartUp Project' 
3. right click map-server again, hit 'Properties' 
4. In the Properties window, within 'Configuration Properties' -> 'Debugging', change 'Working Directory' to '$(SolutionDir)', then save & close the Properties window. 
5. Hit 'F5' it will launch map server under debug mode, once it crashes a 'Call Stack' window will be populated with useful debug information. 

== Footnote ==
Written by a non-MSVC user, please improve at will, and feel free to dump this footnote when you do so.

Hercules Plugin Manager

2013-08-08T18:45:40Z

Ind:

Often referred to as the [[HPM]], the '''Hercules Plugin Manager''' is yet another [[Hercules Original]]
= Building a plugin =
While the [[C]] code for the plugin normally won't have discrepancies, in order to [[compile]] the plugin certain criteria must be met depending on your [[Operating System]], there are 2 guides below, one for windows and other for everything else (which should work on any *nix distro, as well as on OSX).
;Windows
: [[Building HPM Plugin for MSVC]]
;All Others
: [[Building HPM Plugin for gcc]]
= Creating a plugin =
After following the [[#Building_a_plugin|building a plugin]] guide, all thats left is for your plugin's code to be made, the following will guide you through the basics of how a [[HPM]] plugin works.
== HPM Events ==
Events are functions in a plugin that are triggered by the '''Hercules Plugin Mananger''' when they meet certain criteria. 
* <code>void plugin_init (void)</code>
** Triggered when the server starts
* <code>void plugin_final (void)</code>
** Triggered when the server starts to shut itself down
* <code>void server_ready (void)</code>
** Triggered after the server is done starting, and is online.
With the [[HPM]] you only need to code the events your plugin will use.
== HPM Hooks ==
Support for Hooks will be enabled within the next [[HPM]] release.
== HPM @commands ==
The [[HPM]] makes it very simple to provide [[@commands]] through plugins. 
You define a new atcommand exactly as it'd normally be done in {{git|src/map/atcommand.c}} 
'''Example:'''
ACMD(sample) {//@sample command - 5 params: const int fd, struct map_session_data* sd, const char* command, const char* message, struct AtCommandInfo *info
clif->message(fd,"You used the @sample command!");
ShowDebug("I'm being run! message -> '%s' by '%s'\n",message,sd->status.name);
return true;
}
After that you just have to link your new command, to do that you use the <code>void plugin_init (void)</code> event.
HPMi->addCommand("sample",ACMD_A(sample));
and voila, your plugin now adds the '''@sample''' command. 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM Script Commands ==
The [[HPM]] makes it very simple to provide [[Category:Script_Command|script commands]] through plugins. 
You define a new script command exactly as it'd normally be done in {{git|src/map/script.c}} 
'''Example:'''
BUILDIN(sample) {//script command 'sample(num);' - 1 param: struct script_state* st
int arg = script_getnum(st,2);
ShowInfo("I'm being run! arg -> '%d'\n",arg);
return true;
}
After that you just have to link your new script command, to do that you use the <code>void plugin_init (void)</code> event.
HPMi->addScript("sample","i",BUILDIN_A(sample)); //note the 2nd param is this commands' arg-types (in this case, a number)
and voila, your plugin now adds the '''sample''' script command. 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM Console Commands ==
The [[HPM]] makes it very simple to provide [[Category:Console_Command|console commands]] through plugins. 
You define a new console command exactly as it'd normally be done in {{git|src/common/console.c}} 
'''Example:'''
CPCMD(sample) {//console command 'sample' - 1 param: char *line
ShowInfo("I'm being run! arg -> '%s'\n",line?line:"NONE");
}
After that you just have to link your new script command, to do that you use the <code>void plugin_init (void)</code> event.
addCPCommand("this:is:a:sample",CPCMD_A(sample)); // note the first param is the path to this command, in this case it translates to 'this is a sample' and everything afterwards is the commands' params
and voila, your plugin now adds the '''sample''' console command. 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM Custom Packets ==
The HPM makes it possible for a plugin to add or override packets within all 3 servers 
'''Example:'''
/* sample packet implementation */
/* cmd 0xf3 - it is a client-server existent id, for clif_parse_GlobalMessage */
/* in this sample we do nothing and simply redirect */
void sample_packet0f3(int fd) {
struct map_session_data *sd = session[fd]->session_data;

if( !sd ) return;/* socket didn't fully log-in? this packet shouldn't do anything then! */

ShowInfo("sample_packet0f3: Hello World! received 0xf3 for '%s', redirecting!\n",sd->status.name);

clif->pGlobalMessage(fd,sd);
}
void plugin_init(void) {
HPMi->addPacket(0xf3,-1,sample_packet0f3,hpClif_Parse,HPMi->pid);
}
and voila, your plugin just changed the map server's '''0xf3''' packet to pass by '''sample_packet0f3''' prior to being sent to '''clif_parse_GlobalMessage''' 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM Custom Data Structs ==
The HPM makes it possible for a plugin to create and append structs to existent data, this feature is currently supported on player units (map_session_data) and network pipes (socket_data) 
'''Example:'''
/* can be of any size, using any data types */
struct sample_data_struct {
struct point lastMSGPosition;
unsigned int someNumber;
};
/* appends/reads sample_data_struct in a network session data entry (socket_data) */
void some_function_receiving_a_socket_fd(int fd) {
struct sample_data_struct *data;

if( !(data = HPMi->getFromSession(session[fd],HPMi->pid,0)) ) {
CREATE(data,struct sample_data_struct,1);

data->lastMSGPosition.map = 1;
data->lastMSGPosition.x = 150;
data->lastMSGPosition.y = 150;
data->someNumber = rand()%777;

ShowInfo("Created Appended session[] data, %d %d %d %d\n",data->lastMSGPosition.map,data->lastMSGPosition.x,data->lastMSGPosition.y,data->someNumber);
HPMi->addToSession(session[fd],data,HPMi->pid,0,true);
} else {
ShowInfo("Existent Appended session[] data, %d %d %d %d\n",data->lastMSGPosition.map,data->lastMSGPosition.x,data->lastMSGPosition.y,data->someNumber);
if( rand()%4 == 2 ) {
ShowInfo("Removing Appended session[] data\n");
HPMi->removeFromSession(session[fd],HPMi->pid,0);
}
}
}
and voila, your plugin becomes capable of appending and handling your custom struct data 
A full usage of this is demonstrated in the [[HPM]]'s sample {{git|src/plugins/sample.c}}
== HPM Function Overloading ==
Thanks to [[Hercules Renewal Phase One]], you're capable of overloading all functions covered by the [[Hercules Renewal Phase One]] interfaces, with your plugin. 
'''Example:'''
int my_custom_check_target_function( struct block_list *src, struct block_list *target,int flag) {
//<...> code
}
void server_ready(void) {
battle = GET_SYMBOL("battle");
battle->check_target = &my_custom_check_target_function;
}
and voila, your plugin just overloaded the game server's '''battle_check_target''' function with your plugin's own, this is greatly handy to ensure your customs do not create conflicts when updating your [[Hercules|Hercules Repository]]
= Other Features =
Is there something you'd like to do with your plugin that requires modifications to [[HPM]]'s core? [http://hercules.ws/board/forum/55-suggestions/ let we know], and we'll do our best to make it happen. 
[http://hercules.ws/board/forum/55-suggestions/ Post your suggestions here]
= Support =
Need help writing your plugin? [http://hercules.ws/board/forum/26-source-support/ post your question on our support forum]

Hercules Hierarchy

2013-07-11T17:48:13Z

Ind:

{{yellbox|This page is '''incomplete''', you can help us improve this page by editing it}}
= Staff Titles =
Ordered alphabetically. All staff titles, regardless of their description, possesses full moderation powers.

== Administrators ==
They administrate.
* [http://hercules.ws/board/user/1-ind/ Ind] (Community Administrator)
* [http://hercules.ws/board/user/2-jman/ Jman] (Community Administrator)

== Core Developers ==
The kings of the code hill.
* [http://hercules.ws/board/user/28-greenbox/ GreenBox]
* [http://hercules.ws/board/user/20-malufett/ malufett]
* [http://hercules.ws/board/user/49-mkbu95/ mkbu95]
* [http://hercules.ws/board/user/307-haru/ Haru]
* [http://hercules.ws/board/user/725-susu/ Susu]

== Forum Managers ==
They oversee everything forum-related
* [http://hercules.ws/board/user/10-judas/ Judas] ([http://hercules.ws/board/index.php?app=members&filter=17 Forum Manager])
* [http://hercules.ws/board/user/43-mysterious/ Mysterious] ([http://hercules.ws/board/index.php?app=members&filter=17 Forum Manager])

== Global Moderators ==
Global Moderators are individuals who moderate all of the forums excluding International Communities, however, may still moderate. 
Global Moderator ensure that all of the forums are cleaned by removing duplicate topics, ensuring posts/topics don't have spam, moving topics where need be, and locking topics. 
Global Moderators also provide support to support topics, however, not to an extent as Support Leaders.
Global Moderator is not a position one can apply to, but be promoted to from other moderation position thanks to one's efforts and commitment to moderation.
* [http://hercules.ws/board/user/387-jabote/ jaBote]

== Graphics Moderators ==
In charge of all the main graphics areas.
* [http://hercules.ws/board/user/129-adel/ Adel]

== High Council ==
They're an sort of upgrade from the [[#Community_Contributor]] title.
* [http://hercules.ws/board/user/8-eurydice/ Eurydice]
* [http://hercules.ws/board/user/6-jtynne/ jTynne]
* [http://hercules.ws/board/user/99-muad_dib/ Muad_Dib]
* [http://hercules.ws/board/user/456-rytech/ Rytech]
* [http://hercules.ws/board/user/409-yommy/ Yommy]
* [http://hercules.ws/board/user/67-xgear/ Xgear]

== Int'l Moderators ==
International Moderators are individuals who moderate their respective International Community. 
They are solely responsible in making sure their respective community is cleaned by moving, locking, removing, and cleaning topics of spams. 
International Moderators don't have sole responsibility of other forums outside their community and they must provide support to individuals in their community.

====Filipino====
* [http://hercules.ws/board/user/25-jaypee/ JayPee]

====Portuguese====
* [http://hercules.ws/board/user/63-juliocf/ JulioCF]
* [http://hercules.ws/board/user/192-wolf/ Wolf]

====Spanish====
* [http://hercules.ws/board/user/125-m45t3r/ M45T3R]

====German====
* [http://hercules.ws/board/user/1071-shikazu/ Shikazu]

== Script Developers ==
Usually the members with the fastest key/second typing ratio.
* [http://hercules.ws/board/user/23-martin/ Martin]
* [http://hercules.ws/board/user/5-kenpachi/ Kenpachi]
* [http://hercules.ws/board/user/7-nameless2you/ Nameless2you]
* [http://hercules.ws/board/user/757-masao/ Masao]
* [http://hercules.ws/board/user/756-joseph/ Joseph]

== Support Leaders ==
In charge of all the main supporting areas.
* [http://hercules.ws/board/user/4-emistry/ Emistry]

= Other Titles =
Non-staff Titles

== Community Contributor ==
This title is awarded to community members for their outstanding support of Hercules, for [http://hercules.ws/board/topic/376-hercules-cc-program/ more information check this thread]
* [http://hercules.ws/board/user/59-beret/ Beret]
* [http://hercules.ws/board/user/88-kyeme/ kyeme]
* [http://hercules.ws/board/user/315-mstream/ MStream]
* [http://hercules.ws/board/user/303-ryuuzaki/ Ryuuzaki]
* [http://hercules.ws/board/user/297-shakto/ Shakto]
* [http://hercules.ws/board/user/315-neomind/ Neomind]
* [http://hercules.ws/board/user/83-via/ Via]

Hercules Changes

2013-07-06T20:00:42Z

Ind:

A Compilation of noteworthy changes done by Hercules throughout its existence, noteworthy being considered new features, modifications to existent features (e.g. script command) among other things.
= 2013 =
{{yellbox|This page is '''incomplete''', you can help us improve this page by editing it}}
== January ==
== February ==
== March ==
== April ==
== May ==
=== Instances / Instancing ===
Since May 30th on the [http://hercules.ws/board/topic/928-memory-slasher-may-30-patch/|Memory Slasher Patch]
==== Functionality/Feature ====
* map server was made capable of creating instances of any maps regardless of client-side edits, e.g. one can clone prontera and call it "mymapname"
* instances were modified to be employed in 4 distinct ways:
** by nobody (server type instance, to be used with special map names)
** by a sole character
** by a party
** by by a guild
==== Script Command Changes ====
* [[instance_create]] 2nd param was renamed to owner_id, (was party_id) , and it got a 3rd optional param that defines what kind of owner id it is (when not provided, assumes party_id, for backwards compatibility), available options are (IOT_ stands for INSTANCE OWNER TYPE) IOT_NONE (0), IOT_CHAR (1), IOT_PARTY (2) and IOT_GUILD (3).
* [[instance_destroy]] no longer autodetects instance id from party id
* [[instance_attachmap]] was given a 4th, optional, param, "<new map name>", it allows a entirely new map name to be specified for the instance (without the need of client-side edits). this option can be best employed when used on a instance of <owner_type> IOT_NONE
* [[instance_detachmap]] no longer autodetects instance id from party id
* [[instance_id]] no longer supports any param
* [[instance_set_timeout]] no longer autodetects instance id from party id
* [[instance_announce]] no longer autodetects instance id from party id, and to tell it to autodetect from the attached script you must set instance_id param as -1 as opposed to 0
* [[instance_npcname]] no longer autodetects instance id from party id
* [[has_instance]] no longer autodetects instance from party, however it now checks if attached player possesses a instance with same map as [[has_instance]](<param>) checks for
* [[instance_warpall]] no longer autodetects instance from party
==== Other Changes ====
* instance IDs (valid ones) are now always >= 0 as opposed to > 0
== June ==
== July ==

Hercules Changes

2013-07-06T19:58:14Z

Ind: Created page with "A Compilation of noteworthy changes done by Hercules throughout its existence, noteworthy being considered new features, modifications to existent features (e.g. script comman..."

A Compilation of noteworthy changes done by Hercules throughout its existence, noteworthy being considered new features, modifications to existent features (e.g. script command) among other things.
= 2013 =
{{yellbox|This page is '''incomplete''', you can help us improve this page by editing it}}
== January ==
== February ==
== March ==
== April ==
== May ==
=== Instances / Instancing ===
Since May 30th on the [http://hercules.ws/board/topic/928-memory-slasher-may-30-patch/|Memory Slasher Patch]
==== Functionality/Feature ====
* map server was made capable of creating instances of any maps regardless of client-side edits, e.g. one can clone prontera and call it "mymapname"
* instances were modified to be employed in 4 distinct ways:
** by nobody (server type instance, to be used with special map names)
** by a sole character
** by a party
** by by a guild
==== Script Command Changes ====
* instance_create 2nd param was renamed to owner_id, (was party_id) , and it got a 3rd optional param that defines what kind of owner id it is (when not provided, assumes party_id, for backwards compatibility), available options are (IOT_ stands for INSTANCE OWNER TYPE) IOT_NONE (0), IOT_CHAR (1), IOT_PARTY (2) and IOT_GUILD (3).
* instance_destroy no longer autodetects instance id from party id
* instance_attachmap was given a 4th, optional, param, "<new map name>", it allows a entirely new map name to be specified for the instance (without the need of client-side edits). this option can be best employed when used on a instance of <owner_type> IOT_NONE
* instance_detachmap no longer autodetects instance id from party id
* instance_id no longer supports any param
* instance_set_timeout no longer autodetects instance id from party id
* instance_announce no longer autodetects instance id from party id, and to tell it to autodetect from the attached script you must set instance_id param as -1 as opposed to 0
* instance_npcname no longer autodetects instance id from party id
* has_instance no longer autodetects instance from party, however it now checks if attached player possesses a instance with same map as has_instance(<param>) checks for
* instance_warpall no longer autodetects instance from party
==== Other Changes ====
* instance IDs (valid ones) are now always >= 0 as opposed to > 0
== June ==
== July ==

Hercules Renewal Phase One

2013-06-09T23:26:44Z

Ind: /* Available Interfaces */

The [[Hercules Renewal Phase One]] started March 01, 2013, as [http://hercules.ws/board/topic/237-hercules-renewal/ announced over the forum by Ind] 
The primary goal of the [[Hercules Renewal Phase One]] was to prepare the core for the [[Hercules Plugin Manager]] 
The [[Hercules Renewal Phase One]] is still ongoing.
= Available Interfaces =
* '''Common'''
** console (console.c)
** DB (db.c)
** iTimer (timer.c)
** iMalloc (mallo.c)
** SQL (sql.c)
** strlib (strlib.c)
** sv (strlib.c)
** StrBuf (StringBuf) (strlib.c)
* '''Map Server'''
** atcommand (atcommand.c)
** battle (battle.c)
** bg (battlegrounds.c)
** buyingstore (buyingstore.c)
** clif (clif.c)
** guild (guild.c)
** homun (homunculus.c)
** ircbot (irc-bot.c)
** iMap (map.c)
** logs (log.c)
** mapit (map.c)
** party (party.c)
** pc (pc.c)
** script (script.c)
** searchstore (searchstore.c)
** skill (skill.c)
** vending (vending.c)
* '''Char Server'''
** pincode (pincode.c)

Building HPM Plugin for MSVC

2013-06-09T04:15:32Z

Ind: Thank you Thanna for updating this, its much appreciated :D

This is a guide on how to prepare your MSVC environment for a new [[HPM]] plugin.
= Guide =
1. Go to '''src/plugins/''' folder, create a new '''.c''' file, e.g. '''dance.c''' (this name will be used throughout this guide)
[[File:step1.JPG|center|750px]]
2. Open dance.c and paste this code

<pre>
#include <stdio.h>
#include <string.h>
#include "../common/HPMi.h"
#include "../map/script.h"
#include "../map/pc.h"

HPExport struct hplugin_info pinfo =
{
"@dance", // Plugin name
SERVER_TYPE_MAP,// Which server types this plugin works with?
"0.1a", // Plugin version
HPM_VERSION, // HPM Version (don't change, macro is automatically updated)
};

ACMD(dance)
{

if (!message || !*message) {
clif->message(fd, "usage: @dance 1-9");
return -1;
}
if ( atoi(message) == 1 ) {
clif->specialeffect(&sd->bl, 413, ALL_CLIENT);
} else if ( atoi(message) == 2 ) {
clif->specialeffect(&sd->bl, 414, ALL_CLIENT);
} else if ( atoi(message) == 3 ) {
clif->specialeffect(&sd->bl, 415, ALL_CLIENT);
} else if ( atoi(message) == 4 ) {
clif->specialeffect(&sd->bl, 426, ALL_CLIENT);
} else if ( atoi(message) == 5 ) {
clif->specialeffect(&sd->bl, 458, ALL_CLIENT);
} else if ( atoi(message) == 6 ) {
clif->specialeffect(&sd->bl, 466, ALL_CLIENT);
} else if ( atoi(message) == 7 ) {
clif->specialeffect(&sd->bl, 501, ALL_CLIENT);
} else if ( atoi(message) == 8 ) {
clif->specialeffect(&sd->bl, 540, ALL_CLIENT);
} else if ( atoi(message) == 9 ) {
clif->specialeffect(&sd->bl, 550, ALL_CLIENT);
}
else
{
clif->message(fd, "usage: @dance 1-9");
}
return true;
}

/* Server Startup */
HPExport void plugin_init (void)
{
clif = GET_SYMBOL("clif");
script = GET_SYMBOL("script");
skill = GET_SYMBOL("skill");

HPMi->addCommand("dance",ACMD_A(dance));
}
</pre>
3. Open your MSVC project (e.g. '''Hercules-10.sln'')
[[File:step2.JPG|center|750px]]
4. Go to the '''Solution Explorer'''
[[File:step3.JPG|center|750px]]
5. Right click the Hercules project (first item in '''Solution Explorer'''), and click '''Add->New Project'''
[[File:step4.JPG|center|750px]]
6. Select '''General''', and pick '''Empty Project'''.
[[File:step5.JPG|center|750px]]
7. Enter the name of your plugin in the '''Name''' field, and click OK. 

8. In the solution explorer it'll display the new project.
[[File:step6.JPG|center|750px]]
9. Right click the new project, and open '''Add->Existing Item'''
[[File:step7.JPG|center|750px]]
10. Browse to '''src/plugins/''' and select the '''dance.c''' file, and hit OK.
[[File:step8.JPG|center|750px]]
11. It will place the '''dance.c''' file under the '''Source Files''' folder, drag it to the project you created and drop it (in a manner it be placed out of the source files folder.)
[[File:step9.JPG|center|750px]]
(It should look like the image below)
[[File:step10.JPG|center|750px]]
12. With the '''dance.c''' out of the folders, delete the 3 of them (select the 3, hit delete, hit ok)
[[File:step11.JPG|center|750px]]
(It should look like the image below)
[[File:step12.JPG|center|750px]]
13. Right click the project you created, open '''Properties'''
[[File:step13.JPG|center|750px]]
14. Under '''Configuration Properties''' click '''General''', change '''Output Directory''' to '''..\plugins''', '''Intermediate Directory''' to '''$(ProjectName)\$(ConfigurationName)''' and '''Configuration Type''' to '''Dynamic Library (.dll)'''
[[File:step14.JPG|center|750px]]
15. Under '''Configuration Properties''' click '''C/C++''' and open '''General''', change '''Additional Include Directories''' to '''..\src\common;..\3rdparty\msinttypes\include'''
[[File:step15.JPG|center|750px]]
16. Under '''Configuration Properties''' click '''Linker''' and open '''General''', change '''Output File''' to '''$(OutDir)\dance.dll''' (change dance.dll with your actual name, if you used a different one)
[[File:step16.JPG|center|750px]]
17. Done, just add your code to the '''dance.c''' file, and then right-click the project you created, and select '''Build'''

= Notes =
* I added step by step images for other people to follow so they can easily follow one of the best feature Hercules have, the HPM. - Thanna
* The tutorial is tested on MSVC 2010.

Hercules Hierarchy

2013-05-26T14:09:53Z

Ind:

{{yellbox|This page is '''incomplete''', you can help us improve this page by editing it}}
= Staff Titles =
Ordered alphabetically. All staff titles, regardless of their description, possesses full moderation powers.

== Administrators ==
They administrate.
* [http://hercules.ws/board/user/1-ind/ Ind] (Community Administrator)
* [http://hercules.ws/board/user/2-jman/ Jman] (Community Administrator)

== Core Developers ==
The kings of the code hill.
* [http://hercules.ws/board/user/18-trojal/ Trojal]
* [http://hercules.ws/board/user/28-greenbox/ GreenBox]
* [http://hercules.ws/board/user/20-malufett/ malufett]
* [http://hercules.ws/board/user/49-mkbu95/ mkbu95]

== Forum Managers ==
They oversee everything forum-related
* [http://hercules.ws/board/user/10-judas/ Judas] ([http://hercules.ws/board/index.php?app=members&filter=17 Forum Manager])
* [http://hercules.ws/board/user/43-mysterious/ Mysterious] ([http://hercules.ws/board/index.php?app=members&filter=17 Forum Manager])

== Global Moderators ==
Global Moderators are individuals who moderate all of the forums excluding International Communities, however, may still moderate. 
Global Moderator ensure that all of the forums are cleaned by removing duplicate topics, ensuring posts/topics don't have spam, moving topics where need be, and locking topics. 
Global Moderators also provide support to support topics, however, not to an extent as Support Leaders.
Global Moderator is not a position one can apply to, but be promoted to from other moderation position thanks to one's efforts and commitment to moderation.
* [http://hercules.ws/board/user/387-jabote/ jaBote]

== Graphics Moderators ==
In charge of all the main graphics areas.
* [http://hercules.ws/board/user/129-adel/ Adel]

== High Council ==
They're an sort of upgrade from the [[#Community_Contributor]] title.
* [http://hercules.ws/board/user/8-eurydice/ Eurydice]
* [http://hercules.ws/board/user/6-jtynne/ jTynne]
* [http://hercules.ws/board/user/99-muad_dib/ Muad_Dib]
* [http://hercules.ws/board/user/456-rytech/ Rytech]
* [http://hercules.ws/board/user/409-yommy/ Yommy]

== Int'l Moderators ==
International Moderators are individuals who moderate their respective International Community. 
They are solely responsible in making sure their respective community is cleaned by moving, locking, removing, and cleaning topics of spams. 
International Moderators don't have sole responsibility of other forums outside their community and they must provide support to individuals in their community.

====Filipino====
* [http://hercules.ws/board/user/25-jaypee/ JayPee]

====Portuguese====
* [http://hercules.ws/board/user/63-juliocf/ JulioCF]
* [http://hercules.ws/board/user/192-wolf/ Wolf]

== Script Developers ==
Usually the members with the fastest key/second typing ratio.
* [http://hercules.ws/board/user/23-martin/ Martin]
* [http://hercules.ws/board/user/5-kenpachi/ Kenpachi]
* [http://hercules.ws/board/user/7-nameless2you/ Nameless2you]

== Support Leaders ==
In charge of all the main supporting areas.
* [http://hercules.ws/board/user/4-emistry/ Emistry]

= Other Titles =
Non-staff Titles

== Community Contributor ==
This title is awarded to community members for their outstanding support of Hercules, for [http://hercules.ws/board/topic/376-hercules-cc-program/ more information check this thread]
* [http://hercules.ws/board/user/59-beret/ Beret]
* [http://hercules.ws/board/user/88-kyeme/ kyeme]
* [http://hercules.ws/board/user/315-mstream/ MStream]
* [http://hercules.ws/board/user/303-ryuuzaki/ Ryuuzaki]
* [http://hercules.ws/board/user/297-shakto/ Shakto]

Hercules Hierarchy

2013-05-16T23:49:47Z

Ind:

= Staff Titles =
Ordered alphabetically. All staff titles, regardless of their description, possesses full moderation powers.

== Administrators ==
They administrate.
* [http://hercules.ws/board/user/1-ind/ Ind] (Community Administrator)
* [http://hercules.ws/board/user/2-jman/ Jman] (Community Administrator)

== Core Developers ==
The kings of the code hill.
* [http://hercules.ws/board/user/18-trojal/ Trojal]
* [http://hercules.ws/board/user/28-greenbox/ GreenBox]
* [http://hercules.ws/board/user/20-malufett/ malufett]
* [http://hercules.ws/board/user/49-mkbu95/ mkbu95]

== Forum Managers ==
They oversee everything forum-related
* [http://hercules.ws/board/user/10-judas/ Judas] ([http://hercules.ws/board/index.php?app=members&filter=17 Forum Manager])
* [http://hercules.ws/board/user/43-mysterious/ Mysterious] ([http://hercules.ws/board/index.php?app=members&filter=17 Forum Manager])

== Global Moderators ==
Global Moderators are individuals who moderate all of the forums excluding International Communities, however, may still moderate. 
Global Moderator ensure that all of the forums are cleaned by removing duplicate topics, ensuring posts/topics don't have spam, moving topics where need be, and locking topics. 
Global Moderators also provide support to support topics, however, not to an extent as Support Leaders.
Global Moderator is not a position one can apply to, but be promoted to from other moderation position thanks to one's efforts and commitment to moderation.
* [http://hercules.ws/board/user/387-jabote/ jaBote]

== Graphics Moderators ==
In charge of all the main graphics areas.
* [http://hercules.ws/board/user/129-adel/ Adel]

== High Council ==
They're an sort of upgrade from the [[#Community_Contributor]] title.
* [http://hercules.ws/board/user/8-eurydice/ Eurydice]
* [http://hercules.ws/board/user/6-jtynne/ jTynne]
* [http://hercules.ws/board/user/99-muad_dib/ Muad_Dib]
* [http://hercules.ws/board/user/456-rytech/ Rytech]
* [http://hercules.ws/board/user/409-yommy/ Yommy]

== Int'l Moderators ==
International Moderators are individuals who moderate their respective International Community. 
They are solely responsible in making sure their respective community is cleaned by moving, locking, removing, and cleaning topics of spams. 
International Moderators don't have sole responsibility of other forums outside their community and they must provide support to individuals in their community.

====Filipino====
* [http://hercules.ws/board/user/25-jaypee/ JayPee]

====Portuguese====
* [http://hercules.ws/board/user/63-juliocf/ JulioCF]
* [http://hercules.ws/board/user/192-wolf/ Wolf]

== Script Developers ==
Usually the members with the fastest key/second typing ratio.
* [http://hercules.ws/board/user/23-martin/ Martin]
* [http://hercules.ws/board/user/5-kenpachi/ Kenpachi]
* [http://hercules.ws/board/user/7-nameless2you/ Nameless2you]

== Support Leaders ==
In charge of all the main supporting areas.
* [http://hercules.ws/board/user/4-emistry/ Emistry]

= Other Titles =
Non-staff Titles

== Community Contributor ==
This title is awarded to community members for their outstanding support of Hercules, for [http://hercules.ws/board/topic/376-hercules-cc-program/ more information check this thread]
* [http://hercules.ws/board/user/59-beret/ Beret]
* [http://hercules.ws/board/user/88-kyeme/ kyeme]
* [http://hercules.ws/board/user/315-mstream/ MStream]
* [http://hercules.ws/board/user/303-ryuuzaki/ Ryuuzaki]
* [http://hercules.ws/board/user/297-shakto/ Shakto]

Hercules Renewal Phase One

2013-05-16T23:19:15Z

Ind: Created page with "The Hercules Renewal Phase One started March 01, 2013, as [http://hercules.ws/board/topic/237-hercules-renewal/ announced over the forum by Ind] The primary goal of t..."

Hercules Hierarchy

2013-05-16T23:07:30Z

Ind:

= Staff Titles =
Ordered alphabetically. All staff titles, regardless of their description, possess full moderation powers.
== Administrators ==
They administrate.
== Core Developers ==
The kings of the code hill.
== Forum Managers ==
They oversee everything forum-related
== Global Moderators ==
Global Moderators are individuals who moderate all of the forums excluding International Communities, however, may still moderate. 
Global Moderator ensure that all of the forums are cleaned by removing duplicate topics, ensuring posts/topics don't have spam, moving topics where need be, and locking topics. 
Global Moderators also provide support to support topics, however, not to an extent as Support Leaders.
== Graphics Moderators ==
In charge of all the main graphics areas.
== High Council ==
They're an sort of upgrade from the [[#Community_Contributor]] title.
== Int'l Moderators ==
International Moderators are individuals who moderate their respective International Community. 
They are solely responsible in making sure their respective community is cleaned by moving, locking, removing, and cleaning topics of spams. 
International Moderators don't have sole responsibility of other forums outside their community and they must provide support to individuals in their community.
== Script Developers ==
Usually the members with the fastest key/second typing ratio.
== Support Leaders ==
In charge of all the main supporting areas.
= Other Titles =
Non-staff Titles
== Community Contributor ==
This title is awarded to community members for their outstanding support of Hercules, for [http://hercules.ws/board/topic/376-hercules-cc-program/ more information check this thread]

Staff

2013-05-16T23:07:14Z

Ind: Redirected page to Hercules Hierarchy

#REDIRECT [[Hercules_Hierarchy]]

Hercules Hierarchy

2013-05-16T23:06:49Z

Ind: Created page with "= Staff Titles = Ordered alphabetically. All staff titles, regardless of their description, possesses full moderation powers. == Administrators == They administrate. == Co..."

= Staff Titles =
Ordered alphabetically. All staff titles, regardless of their description, possesses full moderation powers.
== Administrators ==
They administrate.
== Core Developers ==
The kings of the code hill.
== Forum Managers ==
They oversee everything forum-related
== Global Moderators ==
Global Moderators are individuals who moderate all of the forums excluding International Communities, however, may still moderate. 
Global Moderator ensure that all of the forums are cleaned by removing duplicate topics, ensuring posts/topics don't have spam, moving topics where need be, and locking topics. 
Global Moderators also provide support to support topics, however, not to an extent as Support Leaders.
== Graphics Moderators ==
In charge of all the main graphics areas.
== High Council ==
They're an sort of upgrade from the [[#Community_Contributor]] title.
== Int'l Moderators ==
International Moderators are individuals who moderate their respective International Community. 
They are solely responsible in making sure their respective community is cleaned by moving, locking, removing, and cleaning topics of spams. 
International Moderators don't have sole responsibility of other forums outside their community and they must provide support to individuals in their community.
== Script Developers ==
Usually the members with the fastest key/second typing ratio.
== Support Leaders ==
In charge of all the main supporting areas.
= Other Titles =
Non-staff Titles
== Community Contributor ==
This title is awarded to community members for their outstanding support of Hercules, for [http://hercules.ws/board/topic/376-hercules-cc-program/ more information check this thread]

Player Parameters (Scripting)

2013-05-09T16:44:23Z

Ind: Created page with "'''Player Parameters''', in scripting, are a set of params that look-like character-variables, they exist during runtime only and make certain information regarding the charac..."

'''Player Parameters''', in scripting, are a set of params that look-like character-variables, they exist during runtime only and make certain information regarding the character available to scripts for read (and write depending on the variable), they're the following:
* StatusPoint
* BaseLevel
* SkillPoint
* Class
* Upper
* Zeny
* Sex
** Whether the character is male (1) or female (0)
* Weight
* MaxWeight
* JobLevel
* BaseExp
* JobExp
* Karma
* Manner
* NextBaseExp
* NextJobExp
* Hp
* MaxHp
* Sp
* MaxSp
* BaseJob
* BaseClass
* killerrid
* killedrid
* SlotChange
** Stores the number of times this character may use the 'slot change' function in char select
** Can be modified
* CharRename
** Stores the number of times this character may use the 'char name change' function in char select
** Can be modified

[[Category:Scripting]]

Wiki Basics

2013-05-05T23:28:51Z

Ind: Created page with "= Editing = == Formatting == Check [http://www.mediawiki.org/wiki/Help:Formatting Formatting] == Editing a Page == Anyone logged in with a [http://hercules.ws/board/ Hercules ..."

= Editing =
== Formatting ==
Check [http://www.mediawiki.org/wiki/Help:Formatting Formatting]
== Editing a Page ==
Anyone logged in with a [http://hercules.ws/board/ Hercules Board] account is capable of editing all articles on this wiki, to edit a page hit the 'Edit' button on the top right (near the search bar)
== Creating a Page ==
You can use the wiki's URL for creating a new page. The URL to an article of the wiki is usually something like this:
*<code><nowiki>http://www.example.net/index.php/</nowiki>'''ARTICLE'''</code>    or
*<code><nowiki>http://www.example.net/wiki/</nowiki>'''ARTICLE'''</code>

If you replace <code>'''ARTICLE'''</code> with the name of the page you wish to create, you will be taken to a blank page which indicates that no article of that name exists yet. Clicking the "{{int:edit}}" button at the top of the page will take you to the edit page for that article, where you can create the new page by typing your text, and clicking submit.
== Redirects to a Page ==
If you think another person may search for the page you've created by using a different name or spelling, please create the proper redirect(s). 
You first create a new page, as you normally would, and in the content you place the following
<nowiki>#REDIRECT [[</nowiki>''pagename''<nowiki>]]</nowiki>
where ''pagename'' is the name of the destination page. The word "redirect" is not case-sensitive, but there must be no space before the "#" symbol. Any text before the code will disable the code and prevent a redirect. Any text or regular content code after the redirect code will be ignored (and should be deleted from an existing page). However, to put or keep the current page name listed in a Category, the usual tag for that category is entered or kept on a line after the redirect code entry.
=== Viewing a Redirect ===
After making a redirect at a page, you can no longer get to that page by using its name or by any link using that name; and they do not show up in wiki search results, either. However, near the top of the destination page, a notice that you have been forwarded appears, with the source pagename as an active link to it. Click this to get back to the redirected page, showing the large bent arrow symbol and the destination for the redirect.

MediaWiki:Sidebar

2013-05-05T22:57:17Z

Ind:

MediaWiki:Sidebar

2013-05-05T22:55:34Z

Ind:

MediaWiki:Aboutsite

2013-05-05T22:50:02Z

Ind: Created page with "-"

MediaWiki:Disclaimers

2013-05-05T22:48:44Z

Ind: Created page with "-"

MediaWiki:Disclaimerpage

2013-05-05T22:48:11Z

Ind:

Project:-

MediaWiki:Disclaimerpage

2013-05-05T22:46:43Z

Ind: Created page with "-"

Hercules:Privacy policy

2013-05-05T22:41:46Z

Ind: Created page with "#REDIRECT [http://hercules.ws/board/privacypolicy/]"

#REDIRECT [http://hercules.ws/board/privacypolicy/]

Hercules Original

2013-05-02T20:25:24Z

Ind: Created page with "List of Original Hercules Features * [http://hercules.ws/board/topic/302-introducing-hercules-map-zone-database/ Hercules Map Zone DB] * [[HPM|Hercules P..."

List of [[Hercules Original|Original Hercules Features]]
* [http://hercules.ws/board/topic/302-introducing-hercules-map-zone-database/ Hercules Map Zone DB]
* [[HPM|Hercules Plugin Mananger]]
* [http://hercules.ws/board/topic/316-introducing-hercules-channel-system/ Hercules Channel System]
* [http://hercules.ws/board/topic/353-packetdb-overhaul/ Packet DB Overhaul]
* [http://hercules.ws/board/topic/548-hercules-console-input-update/ Console Input Redesign]

Building HPM Plugin for MSVC

2013-05-02T20:19:01Z

Ind: Created page with "This is a guide on how to prepare your MSVC environment for a new HPM plugin. = Guide = # Go to '''src/plugins/''' folder, create a new '''.c''' file, e.g. '''sample2.c'''..."

This is a guide on how to prepare your MSVC environment for a new [[HPM]] plugin.
= Guide =
# Go to '''src/plugins/''' folder, create a new '''.c''' file, e.g. '''sample2.c''' (this name will be used throughout this guide)
# Open your MSVC project (e.g. '''Hercules-9.sln'')
# Go to the '''Solution Explorer'''
# Right click the Hercules project (first item in '''Solution Explorer'''), and click '''Add->New Project'''
# Select '''General''', and pick '''Empty Project'''.
# Enter the name of your plugin in the '''Name''' field, and click OK.
# In the solution explorer it'll display the new project (probably at the bottom).
# Right click the new project, and open '''Add->Existing Item'''
# Browse to '''src/plugins/''' and select the '''sample2.c''' file, and hit OK.
# It will place the '''sample2.c''' file under the '''Source Files''' folder, drag it to the project you created and drop it (in a manner it be placed out of the source files folder)
# With the '''sample2.c''' out of the folders, delete the 3 of them (select the 3, hit delete, hit ok)
# Right click the project you created, open '''Properties'''
# Under '''Configuration Properties''' click '''General''', change '''Output Directory''' to '''..\plugins''', '''Intermediate Directory''' to '''$(ProjectName)\$(ConfigurationName)''' and '''Configuration Type''' to '''Dynamic Library (.dll)'''
# Under '''Configuration Properties''' click '''C/C++''' and open '''General''', change '''Additional Include Directories''' to '''..\src\common;..\3rdparty\msinttypes\include'''
# Under '''Configuration Properties''' click '''Linker''' and open '''General''', change '''Output File''' to '''$(OutDir)\sample2.dll''' (change sample2.dll with your actual name, if you used a different one)
# Done, just add your code to the '''sample2.c''' file, and then right-click the project you created, and select '''Build'''
= Notes =
* This guide is probably the worst I've ever written, if you can do better please hit the 'Edit' button, will be most welcome. - Ind
* I used MSVC 2008 when testing this guide.

Building HPM Plugin for gcc

2013-05-02T20:18:45Z

Ind: Created page with "This is a guide on how to prepare your gcc environment for a new HPM plugin. = Guide = Lets say your '''src/plugins/Makefile.in''' file looks like the following (it probab..."

This is a guide on how to prepare your gcc environment for a new [[HPM]] plugin.
= Guide =
Lets say your '''src/plugins/Makefile.in''' file looks like the following (it probably will be similar):
COMMON_H = ../common/HPMi.h ../common/cbasetypes.h

PLUGINS = sample

@SET_MAKE@

#####################################################################
.PHONY : all $(PLUGINS) sample clean help

all: $(PLUGINS)

sample: sample@DLLEXT@

clean:
@echo " CLEAN plugins"
@rm -rf *.o

help:
@echo "possible targets are $(PLUGINS:%='%') 'all' 'clean' 'help'"
@echo "'sample' - sample plugin"
@echo "'help' - outputs this message"

#####################################################################

%@DLLEXT@: %.c $(COMMON_H)
@echo " CC $<"
@@CC@ @DEFS@ @CFLAGS@ @CPPFLAGS@ @LDFLAGS@ @SOFLAGS@ -o ../../plugins/$@ $<
and the plugin you want to add is called '''sample2''', it will end up like the following:
COMMON_H = ../common/HPMi.h ../common/cbasetypes.h

PLUGINS = sample sample2

@SET_MAKE@

#####################################################################
.PHONY : all $(PLUGINS) sample sample2 clean help

all: $(PLUGINS)

sample: sample@DLLEXT@

sample2: sample2@DLLEXT@

clean:
@echo " CLEAN plugins"
@rm -rf *.o

help:
@echo "possible targets are $(PLUGINS:%='%') 'all' 'clean' 'help'"
@echo "'sample' - sample plugin"
@echo "'help' - outputs this message"

#####################################################################

%@DLLEXT@: %.c $(COMMON_H)
@echo " CC $<"
@@CC@ @DEFS@ @CFLAGS@ @CPPFLAGS@ @LDFLAGS@ @SOFLAGS@ -o ../../plugins/$@ $<
Use CTRL+F to ensure you locate all the occurrences of '''sample2''', then edit the same way in your '''src/plugins/Makefile.in''', save and close. 
Lastly, re-run your '''./configure''' command at the root folder of Hercules, and you're good to go.
[[HPM]]

Hercules Plugin Manager

2013-05-02T20:18:32Z

Ind: Created page with "Often referred to as the HPM, the '''Hercules Plugin Manager''' is yet another Hercules Original = Building a plugin = While the C code for the plugin normally won..."

HPM

2013-05-01T18:04:20Z

Ind: Redirected page to Hercules Plugin Manager

#REDIRECT [[Hercules Plugin Manager]]

IndAI

2013-04-04T21:18:14Z

Ind: Created page with "IndAI is a feature employed by [http://hercules.ws/board/topic/342-introducing-hercules-stress-test-server/ Hercules Stress Test Server]. == Preamble == # '''What is this?'''..."

IndAI is a feature employed by [http://hercules.ws/board/topic/342-introducing-hercules-stress-test-server/ Hercules Stress Test Server].

== Preamble ==
# '''What is this?''' to make it short, its the ability for the game server to create and control player-looking units
# '''Why the pretentious name?''' Inds bad at naming stuff.

== Capabilities ==
* IndAI units use normal player-character data, making them fit (be compatible) perfectly into all player-character-features.
* IndAI units are capable of farming, doing pvp, doing woe, doing battlegrounds.

== Availability ==
We judged this feature to be potentially dangerous to the private server community if made public, so we'll be keeping it private to be used solely by the [http://hercules.ws/board/topic/342-introducing-hercules-stress-test-server/ Hercules Stress Test Server]

Help:Redirects

2013-03-30T06:19:38Z

Ind: Redirected page to Help:Redirect

#REDIRECT [[Help:Redirect]]

Help:Starting a new page

2013-03-30T06:18:44Z

Ind: Created page with "There are several ways to start a new page. These can vary based on the type of page started, as well as the wiki and namespace. == Using Wikilinks == MediaWiki makes it very..."

There are several ways to start a new page. These can vary based on the type of page started, as well as the wiki and namespace.

== Using Wikilinks ==
MediaWiki makes it very easy to link wiki pages using a standard syntax (see [[Help:Links|Links]]). If you (or anyone else) create a link to an article that doesn't exist yet, the link will be coloured red, like this.

Clicking a red link will take you to the edit page for the new article. Simply type your text, click save and the new page will be created.

Once the page has been created, the link will change from red to blue (purple for pages you've visited) indicating that the article now exists.

Usually this is the best way to create a new page, because it means that right from the start, the page will be linked from at least one other place on the wiki (and typically you will want to mesh it into other related pages later). If you are creating a new page without creating any link to it, you may need to ask yourself: Does this page really fit in with the topics already covered in the wiki? Also, how are you expecting visitors to find this page? Normally there is no reason to create a page without first creating a red link to it.

== From the search page ==
If you search for a page that doesn't exist (using the search box and “{{int:go}}” button on the left of the page) then you will be provided with a link to create the new page.

== Using the URL ==
You can use the wiki's URL for creating a new page. The URL to an article of the wiki is usually something like this:
*<code><nowiki>http://hercules.ws/wiki/</nowiki>'''ARTICLE'''</code>

If you replace <code>'''ARTICLE'''</code> with the name of the page you wish to create, you will be taken to a blank page which indicates that no article of that name exists yet. Clicking the "{{int:edit}}" [[Help:Navigation#Page Tabs|page tab]] at the top of the page will take you to the edit page for that article, where you can create the new page by typing your text, and clicking submit.

== Create redirects to your new page ==
Don't forget to set up redirects when you create a page. If you think another person may search for the page you've created by using a different name or spelling, please create the proper redirect(s). See [[Help:Redirects]].

Help:Redirect

2013-03-30T06:16:59Z

Ind: Created page with "Redirects are used to forward users from one page name to another. They can be useful if a particular article is referred to by multiple names, or has alternative punctuation,..."

Redirects are used to forward users from one page name to another. They can be useful if a particular article is referred to by multiple names, or has alternative punctuation, capitalization or spellings.

== Creating a redirect ==
You may start a new page with the name you want to direct from (see [[Help:Starting a new page]]). You can also use an existing page that you are making inactive as a page by going to that page and using the "edit" tab at the top. In either case, you will be inserting the following code at the very first text position of the Edit window for the page:
<nowiki>#REDIRECT [[</nowiki>''pagename''<nowiki>]]</nowiki>
where ''pagename'' is the name of the destination page. The word "redirect" is not case-sensitive, but there must be no space before the "#" symbol. Any text before the code will disable the code and prevent a redirect. Any text or regular content code after the redirect code will be ignored (and should be deleted from an existing page). However, to put or keep the current page name listed in a Category, the usual tag for that category is entered or kept on a line after the redirect code entry.

You should use the 'preview' button below the Edit window, or Alt-P, to check that you have entered the correct destination page name. The preview page will not look like the resulting redirect page, it will look like a numbered list, with the destination page in blue:
1. REDIRECT ''pagename''
If the ''pagename'' as you typed it is not a valid page, it will show in red. Until there is a valid destination page, you should not make the redirect.

== Viewing a redirect ==
After making a redirect at a page, you can no longer get to that page by using its name or by any link using that name; and they do not show up in wiki search results, either. However, near the top of the destination page, a notice that you have been forwarded appears, with the source pagename as an active link to it. Click this to get back to the redirected page, showing the large bent arrow symbol and the destination for the redirect.

By doing this, you can do all the things that any wiki page allows. You can go to the associated discussion page to discuss the redirect. You can view the history of the page, including a record of the redirect. You can edit the page if the redirect is wrong, and you can revert to an older version to remove the redirect.

== Deleting a redirect ==
There's generally no need to delete redirects. They do not occupy a significant amount of database space. If a page name is vaguely meaningful, there's no harm (and some benefit) in having it as a redirect to the more relevant or current page.

If you do need to delete a redirect, e.g. if the page name is offensive, or you wish to discourage people from referring to a concept by that name, then you simply go to the redirect page as mentioned above, and follow the procedures at [[Help:Deleting a page]].

== Double redirects ==
A double redirect is a page redirecting to a page which is itself a redirect, and it will not work. Instead, people will be presented with a view of the next redirect page. This is a deliberate restriction, partly to prevent infinite loops, and partly to keep things simple.

However, you could look out for double redirects and eliminate them by changing them to be 1-step redirects instead. You are most likely to need to do this after a significant [[Help:Moving a page|page move]]. Use the "what links here" toolbox link to find double redirects to a particular page, or use [[Special:DoubleRedirects]] to find them throughout the whole wiki.

== A redirect to a page in the category namespace ==
To redirect to a category page and prevent the redirect appearing in this category, precede the word "Category" with a colon, otherwise the redirect page will also be categorized to the category itself:
<nowiki>#REDIRECT [[:Category:Glossary]]</nowiki>

Sclientinfo.xml

2013-03-30T06:13:53Z

Ind: Redirected page to Clientinfo.xml

#REDIRECT [[Clientinfo.xml]]

SRC/config/

2013-03-29T17:35:38Z

Ind: Created page with "This page provides information on the '''/src/config/''' folder and its settings. The '''/src/config/''' folder contains special server settings that allow you to further cust..."

This page provides information on the '''/src/config/''' folder and its settings. The '''/src/config/''' folder contains special server settings that allow you to further customize your server, the most popular of them being '''RENEWAL''', a switch to enable or disable Ragnarok Renewal mechanics

=== /src/config/const.h ===
----
This file does not posses any settings, it is used to store constants used by other settings.

=== /src/config/core.h ===
----
The core configuration file (which is inherited by map.h) that inherits all other configuration files, at this point in time this file does not possess any settings

=== /src/config/renewal.h ===
----
This configuration files provides Ragnarok Renewal settings for you to further customize your server
==== RENEWAL ====
:This setting affects the following mechanics
:* Renewal MATK
:* Renewal MDEF
:* Renewal DEF
:* Renewal Status Points
:* Renewal Heal Formula
:* Renewal ASPD Shield Penalty
:* Renewal Stat Bonuses (str,agi,vit,flee,hit,etc)
:* Renewal Files
:** ''item_db_re.txt'', ''statpoint_renewal.txt'', ''job_db_re.txt'', [[DB_Folder_Inheritance|and others]] are only loaded in this mode. [[DB_Folder_Inheritance|Check the DB Inheritance page for all]]
:'''How to Disable'''
:* Commenting it's #define RENEWAL line out makes it disable (add '''//''' before #define)

==== RENEWAL_DROP ====
:This setting enables or disables Ragnarok Renewal drop rate modifier, which is based on the level difference between a character and the monster it killed
:The modifier depends on the following table
:{|border="1" style="text-align:center;"
|-
| '''Difference in Base Level''' || '''Drop Rate'''
|-
| 30 levels above monster or more || 50%
|-
| + 15 ~ 29 || 60%
|-
| + 10 ~ 14 || 75%
|-
| + 6 ~ 9 || 90%
|-
| + 1 ~ 5 || 100%
|-
| Equal || 100%
|-
| - 1 ~ 10 || 100%
|-
| - 11 ~ 13 || 75%
|-
| 15 levels below monster or more || 50%
|}
:'''For Example''', if you are level 50, and you kill a monster level 10, which normally drops a item at 50%, for you it'd drop at 25% (because you're 30 levels or higher than it)
:'''How to Disable'''
:* Commenting it's #define RENEWAL_DROP line out makes it disable (add '''//''' before #define)

==== RENEWAL_EXP ====
:This setting enables or disables Ragnarok Renewal exp rate modifier, which is based on the level difference between a character and the monster it killed
:'''How to Disable'''
:* Commenting it's #define RENEWAL_DROP line out makes it disable (add '''//''' before #define)

==== RENEWAL_CAST ====
:This setting enables or disables '''Renewal Casting''' and in it, cast time is decreased by DEX*2+INT, 20% of the cast time is not reduced by stats, for example, on a skill whose cast time is 10s, only 8s may be reduced. other 2s are part of a "fixed cast time" that is only reduced by special items and skills (such as Arch Bishop's Sacrament skill). '''When disabled''' it uses the old cast time method, influenced by dex, items and skills 
:'''How to Disable'''
:* Commenting it's #define RENEWAL_CAST line out makes it disable (add '''//''' before #define)
==== RENEWAL_CAST_VMIN ====
:* '''Note''': This setting only matters if '''RENEWAL_CAST''' is enabled
:This setting allows you to specify how many points a user is required to have to reach instant cast
:* '''VALUE''': The formula is (casterDex x 2) + (casterInt), '''default value''' is '''530'''
==== RENEWAL_EDP ====
:This setting enables or disables Ragnarok Renewal mechanics for '''Enchant Deadly Poison''' skill, 
:the changes compared to old mechanics are:
:* EDP doesn't increases final damage by 400%, instead it increases your weapon atk and your stat atk
:* EDP doesn't affect '''Grimtooth''' skill
:'''How to Disable'''
:* Commenting it's #define RENEWAL_EDP line out makes it disable (add '''//''' before #define)

=== /src/config/secure.h ===
----
This configuration files provides additional security features to your server
==== SECURE_NPCTIMEOUT ====
:When enabled all npcs dialog will 'timeout' if user is on idle for longer than the amount of seconds allowed, on 'timeout' the npc dialog window changes it's next/menu to a 'close' button
:* '''VALUE''' is the amount of '''seconds''' you want the server to wait prior to timeout an idle NPC dialog
==== SECURE_NPCTIMEOUT_INTERVAL ====
:* '''Note''': This setting only matters if '''SECURE_NPCTIMEOUT''' is enabled
:This setting is the amount of '''seconds''' you want the server to wait prior to checking if an NPC dialog is idle

=== /src/config/classes/general.h ===
This configuration files provides settings for you to further customize your server skills
==== RR_MAGIC_REFLECTION ====
:* '''Note''': This setting exists because server owners were exposed to the unofficial magical reflection for several years, and expecting many to not want to change this setting was made.
:When enabled the official magical reflection is used, official magical reflection damage is calculated against ''the caster'', while the unofficial magical reflection calculates the reflected damage against ''the target''. 
:'''How to Disable'''
:* Commenting it's #define MAGIC_REFLECTION_TYPE line out makes it disable (add '''//''' before #define)

=== /src/config/classes/swordsman.h ===
----
This configuration files provides settings for you to further customize your server's swordsman skills
==== MAX_RUNE ====
:This setting allows you to specify how many rune knight's runes of the same type an character is able to hold in his inventory 
:'''Default''' value for this setting is 20

IRC

2013-03-18T01:37:23Z

Ind: Created page with "=IRC?= IRC stands for Internet Relay Chat. Basically, it's chatroom server and client software in general. In IRC, you have servers a..."

=IRC?=
[[IRC]] stands for [[wikipedia:Internet_Relay_Chat|Internet Relay Chat]]. Basically, it's chatroom server and client software in general. In [[IRC]], you have servers and channels. Servers hold the channels, and are hosted on dedicated machines. The channels are the actual chatrooms. [[IRC]] allows you to chat with people in real-time around the world.

== Connecting to IRC ==
The official [[Hercules]] channel room can be found [irc://irc.rizon.net/Hercules here]. 
Web-based IRC chat is available too: http://hercules.ws/board/page/irc.html

To actually connect to [[IRC]], if you do not already have an [[wikipedia:Comparison_of_Internet_Relay_Chat_clients|IRC client]] and do not wish to run the java chat, you're going to need an IRC client. There are many different IRC clients, and none are really the 'best'. Opinions vary on which are better. The most commonly used IRC client on [[wikipedia:Microsoft_Windows|Microsoft Windows]] is [http://www.mirc.com mIRC]. The most commonly used client on *nix is a tossup between [http://www.bitchx.org BitchX] and [http://www.xchat.org XChat]. Note that XChat is pay-to-use on [[wikipedia:Microsoft_Windows|Windows]], but not on *nix.

For those not looking to go in-depth into manuals to figure out how to connect, you can actually be up and running by simply installing mIRC, and then typing the following two commands into the mIRC command line on the status window:
/nick NickYouWantHere
/server irc.rizon.net -j #Hercules

And you'll be connected.

= Links =
Here you will find links for IRC clients and other related things.

== Windows IRC Clients ==
* [http://www.mirc.com mIRC]
* [http://www.pidgin.im/ Pidgin]
* [http://ntalk.de/Nettalk/en/ Nettalk]
* [http://bitchx.org/files/binaries/cygwin/BitchX-1.0c19-cygwin.tar.gz BitchX for cygWIN]
* [http://invision.lebyte.com/ Invision mIRC script]
* [http://www.xchat.org/windows/ XChat]
* [http://excursion.humr.org Ecursion mIRC CLient]
* [http://nnscript.de NNSCript for mIRC]
* [http://mircscripts.org/archive/scripts Various Other mIRC Scripts.]

== *Nix Clients ==
The *NIX clients differ. you need to grab the one that best suits your *nix operating system.
* [http://bitchx.org/download.php BitchX]
* [http://www.xchat.org/download/ XChat]
* [http://ftp.ksut.edu.tw/FTP/Unix/IRC/clients/xwindows/circus/ Circus]
* [ftp://sunsite.unc.edu/pub/Linux/system/network/chat/irc/dircR15.zip dirc]
* [http://www.ircreviews.org/clients/platforms-unix-x.html Various Other Clients]

Hercules

2013-03-18T01:34:05Z

Ind: Created page with "{{infobox/software |developer=Hercules Developers |version=[https://github.com/HerculesWS/Hercules/commit/ GitHub] |os=Windows, Linux, FreeBSD, Mac OSX |lang=English..."

{{infobox/software
|developer=[[Staff|Hercules Developers]]
|version=[https://github.com/HerculesWS/Hercules/commit/ GitHub]
|os=Windows, Linux, FreeBSD, Mac OSX
|lang=English
|type=Ragnarok Online Emulator
|license=GNU General Public License 3 (open source)
|web=http://hercules.ws/}}
'''Hercules''' is a free and open source implementation of [[wikipedia:AEGIS_(Ragnarok_Online)|Aegis]], a [[wikipedia:Ragnarok Online|Ragnarok Online]] game server, and is written in [[wikipedia:C_(programming_language)|C]].

== Repository ==
Hercules is available via [http://hercules.ws/board/topic/152-obtaining-hercules/ both Git and SVN]

== Support ==
You may access our [http://hercules.ws/board/ forums] or [[IRC|IRC channel]] for support.

== External Links ==
* [http://hercules.ws/board/ Official Hercules Support Board]

User:Ind

2013-03-18T01:18:33Z

Ind:

Hi~
[http://hercules.ws/board/user/1-ind/ Ind]