Hercules Wiki - User contributions [en]

Main Page

2014-01-09T20:38:14Z

Milamber:

{| style="width: 100%;" cellspacing="5" cellpadding="0"
| colspan="3" |
|-
| style="background: #FCFCFC; border: 1px solid #AAA; vertical-align: top;" |
<div style="background: #ACD; border: 1px solid #7BC; padding: 5px; margin: 3px; font-weight: bold; text-align: center; font-size: 120%;">About Hercules</div>
<div style="padding-left: 1em;">
[[Hercules]] is an [[wikipedia:Open_source|open-source]] project, revolving around the creation of a robust massively multiplayer online role playing game (MMORPG) server package, emulating a [[wikipedia:Ragnarok_Online|Ragnarok Online]] [[wikipedia:Server|Server]]. Written in [[wikipedia:C_(programming_language)|C]] the program is very versatile and provides NPCs, warps and modifications. and is currently version controlled via [[wikipedia:Git_(software)|Git]]. The project is jointly managed by a group of volunteers located around the world as well as a tremendous community providing QA and support. Hercules is a continuation of the original Athena project.

Hercules currently runs on most common [[wikipedia:Operating_system|Operating Systems]] currently available today. For a full list, please see the [[System Requirements]].

</div>

<div style="background: #ACD; border: 1px solid #7BC; padding: 5px; margin: 3px; font-weight: bold; text-align: center; font-size: 120%;">Editing the Wiki</div>
<div style="padding-left: 1em;">
All users must login to the wiki using their forum account. Any member 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 [[Editing the wiki]] 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!

</div>

<div style="background: #ACD; border: 1px solid #7BC; padding: 5px; margin: 3px; font-weight: bold; text-align: center; font-size: 120%;">Quick Tips</div>
<div style="padding-left: 1em;">
*Spell check your work and make sure the grammar is correct.
*Use English.
*Do not vandalize the wiki. Vandalization will come with harsh punishment.
*Please see [[mw:Help:Formatting|Formatting a wiki]] for tips on wiki formats and syntaxes.
</div>

| style="background: #FCFCFC; border: 1px solid #AAA; vertical-align: top;" |
<div style="width: 260px; background: #ACD; border: 1px solid #7BC; padding: 5px; margin: 3px; font-weight: bold; text-align: center; font-size: 120%;"><div style="float: right; padding: 0 20px;">[[Image:poring1.gif]]</div>Installation</div>
<div style="padding-left: 1em;">
; [[Getting Started]]
: [[System Requirements]]
; [[:Category:Installation|Installation]]
: [[Installation_(CentOS)|CentOS]]
: [[Installation_(Debian)|Debian Linux]]
: [[Installation_(FreeBSD)|FreeBSD]]
; [[Compiling]]
; [[Connecting|Connecting and Starting]]
; [[:Category:Configuration|Configuration]]
</div>
<div style="background: #ACD; border: 1px solid #7BC; padding: 5px; margin: 3px; font-weight: bold; text-align: center; font-size: 120%;"><div style="float: right;">[[Image:develing1.gif]]</div>Server Side</div>
<div style="padding-left: 1em;">
; [[Scripting]]
: [[Basic Scripting]]
: [[:Category:Script_Command|Script Commands]]
: [[Permanent Monster Spawn]]
: [[Instancing]]
:
; [[Server Modification]]
: [[:Category:Source_Functions|Source Functions]]
: [[:Category:Source Snippets|Source Snippets]]
: [[Hercules Plugin Manager]]
: [[Packets]]
:
; [[:Category:Database|Database]]
: [[Custom Items]]
: [[Custom Mobs]]
: [[Custom weapons]]
</div>
<div style="background: #ACD; border: 1px solid #7BC; padding: 5px; margin: 3px; font-weight: bold; text-align: center; font-size: 120%;"><div style="float: right;">[[Image:angeling1.gif]]</div>Client Side</div>
<div style="padding-left: 1em;">
; [[:Category:Data|Data]]
; [[Spriting]]
: [[Palettes]]
: [[Acts]]
:
; [[:Category:Mapping|Mapping]]
: [[Modeling]]
: [[Texture]]
:
; [[:Category:Client_Configuration|Client Stuff]]
;
; [[:Category:Patchers|Patchers]]
</div>
|}

Installation (FreeBSD)

2014-01-09T20:17:36Z

Milamber:

This article is aimed at installing and getting [[Hercules]] to run successfully on a machine running [[wikipedia:FreeBSD|FreeBSD]] 9.1-RELEASE. It is assumed that FreeBSD was installed with the ports collection and enabled Linux Threading on install. This guide will NOT teach you how to network FreeBSD, install FreeBSD or configure any additional system settings (besides the ones needed to run Hercules and its dependencies).

=Before we Start=
We will primarily working from the /home/user directory. Your primary user will need to be in the 'wheel' group and be able to su into root. Remember that I will include either $ or #, depending on who you should be. $ indicates you should be your primary user, and # indicates you should be root.

=Required software=
We are going to use FreeBSD's ports collection to download, install and use most of these programs. It is assumed you already installed the ports collection, if you have not, I suggest you do that now.

==Ports Collection==
The Ports Collection is a set of files used to compile and install applications on FreeBSD. While this is not a guide for FreeBSD, its recommended to obtain the same as given below:
<code><pre>
# portsnap fetch
Download a compressed snapshot of the Ports Collection into /var/db/portsnap.

# portsnap extract
When running Portsnap for the first time, extract the snapshot into /usr/ports
</pre></code>

==wget==
wget is a download manager available on FreeBSD and can be your bread and butter while working on FreeBSD.
<code><pre># whereis wget
wget: /usr/ports/www/wget
# cd /usr/ports/www/wget && make && make install
# make clean
# rehash</pre></code>

==gmake==
gmake, or GNUMake, is the GCC compiler used for FreeBSD.
<code><pre>
# whereis gmake
gmake: /usr/ports/devel/gmake
# cd /usr/ports/devel/gmake && make && make install
# make clean
# rehash
</pre></code>

==unrar==
unrar is a tool to unrar .rar's in BSD.
<code><pre>
# whereis unrar
unrar: /usr/ports/archivers/unrar
$ cd /usr/ports/archivers/unrar
$ make clean
$ make install
$ rehash
</pre></code>

==GCC==
GCC is the GNU Compiler Collection and front ends for C, C++ and other languages.
This may not be available on the system but it can be obtained as below:
<code><pre># wget http://www.netgull.com/gnu/gcc/gcc-###.tar.gz (Where ## is the version number. visit the mirror to find out)
# tar -xvf gcc-###.tar.gz
# cd gcc*
# make && make install
# make clean
# rehash</pre></code>

==gdb==
GDB is handy tool to have on a development machine, as it can take backtraces of crashes and help you find what went wrong.
It is probable that this is already available on your FreeBSD, but if it's not, here's how you can install it:
<code><pre># wget http://ftp.gnu.org/gnu/gdb/gdb-###.tar.gz (again, where ### is the version number, check out the mirror)
# tar -xvf gdb-###.tar.gz
# cd gdb*
# make && make install
# make clean
# rehash</pre></code>

==git==
[[Git]] is the versioning system used for Hercules and how we will get our copy of Hercules.
<code><pre># whereis git
git: /usr/ports/devel/git
# cd /usr/ports/devel/git && make && make install
# make clean
# rehash
</pre></code>

Now, let's go ahead and download Hercules. We'll use git for this.

<pre>
$ su root
# adduser //create a Hercules user
# exit
$ su hercules
$ cd /home/hercules
$ git clone https://github.com/HerculesWS/Hercules.git Hercules
$</pre>

Now, we can populate the tables with the .sql files in Hercules. Navigate to your /sql-files/ folder in the Hercules files you just checked out.

<pre>
$ cd /home/hercules/trunk/sql-files
$ mysql -uuser -ppassword myr-odb < main.sql
$ mysql -uuser -ppassword myro-db < logs.sql
</pre>

Now, you'll want to follow the steps in the [[:Category:Configuration]] and [[Connecting]] pages to get your Hercules configured. Once you've made all your source changes, you can compile Hercules. While you're in the root of your Hercules folder, issue the following commands to compile your server:

<pre>
$ ./configure
$ gmake clean
$ gmake sql
$ rehash
</pre>

'''Important Note:''' If you are using a 32 bit FreeBSD you have to use
<pre>
chmod 777 configure
$ ./configure --disable-64bit
</pre>
instead

''NOTE:'' You should '''NEVER''' run Hercules as the root user!. Always setup a new user and this cannot be stressed enough on!
This will also prevent your from having difficulties with file permissions.

And to start your servers, you can simply use the following command:

<pre>
$ ./athena-start <command> (start | stop | restart | status)
</pre>

And that's it! You now have Hercules running on your FreeBSD machine!

[[Category:Installation Guides]]

Installation (FreeBSD)

2014-01-09T20:13:15Z

Milamber: /* unrar */

This article is aimed at installing and getting [[Hercules]] to run successfully on a machine running [[wikipedia:FreeBSD|FreeBSD]] 9.1-RELEASE. It is assumed that FreeBSD was installed with the ports collection and enabled Linux Threading on install. This guide will NOT teach you how to network FreeBSD, install FreeBSD or configure any additional system settings (besides the ones needed to run Hercules and its dependencies).

=Before we Start=
We will primarily working from the /home/user directory. Your primary user will need to be in the 'wheel' group and be able to su into root. Remember that I will include either $ or #, depending on who you should be. $ indicates you should be your primary user, and # indicates you should be root.

=Required software=
We are going to use FreeBSD's ports collection to download, install and use most of these programs. It is assumed you already installed the ports collection, if you have not, I suggest you do that now.

==Ports Collection==
The Ports Collection is a set of files used to compile and install applications on FreeBSD. While this is not a guide for FreeBSD, its recommended to obtain the same as given below:
<code><pre>
# portsnap fetch
Download a compressed snapshot of the Ports Collection into /var/db/portsnap.

# portsnap extract
When running Portsnap for the first time, extract the snapshot into /usr/ports
</pre></code>

==wget==
wget is a download manager available on FreeBSD and can be your bread and butter while working on FreeBSD.
<code><pre># whereis wget
wget: /usr/ports/www/wget
# cd /usr/ports/www/wget && make && make install
# make clean
# rehash</pre></code>

==gmake==
gmake, or GNUMake, is the GCC compiler used for FreeBSD.
<code><pre>
# whereis gmake
gmake: /usr/ports/devel/gmake
# cd /usr/ports/devel/gmake && make && make install
# make clean
# rehash
</pre></code>

==unrar==
unrar is a tool to unrar .rar's in BSD.
<code><pre>
# whereis unrar
unrar: /usr/ports/archivers/unrar
$ cd /usr/ports/archivers/unrar
$ make clean
$ make install
$ rehash
</pre></code>

==GCC==
GCC is the GNU Compiler Collection and front ends for C, C++ and other languages.
This may not be available on the system but it can be obtained as below:
<code><pre># wget http://www.netgull.com/gnu/gcc/gcc-###.tar.gz (Where ## is the version number. visit the mirror to find out)
# tar -xvf gcc-###.tar.gz
# cd gcc*
# make && make install
# make clean
# rehash</pre></code>

==gdb==
GDB is handy tool to have on a development machine, as it can take backtraces of crashes and help you find what went wrong.
It is probable that this is already available on your FreeBSD, but if it's not, here's how you can install it:
<code><pre># wget http://ftp.gnu.org/gnu/gdb/gdb-###.tar.gz (again, where ### is the version number, check out the mirror)
# tar -xvf gdb-###.tar.gz
# cd gdb*
# make && make install
# make clean
# rehash</pre></code>

==git==
[[Git]] is the versioning system used for Hercules and how we will get our copy of Hercules.
<code><pre># whereis git
git: /usr/ports/devel/git
# cd /usr/ports/devel/git && make && make install
# make clean
# rehash
</pre></code>

Now, let's go ahead and download Hercules. We'll use git for this.

<pre>
$ su root
# adduser //create a Hercules user
# exit
$ su hercules
$ cd /home/hercules
$ git clone https://github.com/HerculesWS/Hercules.git Hercules
$</pre>

Now, we can populate the tables with the .sql files in Hercules. Navigate to your /sql-files/ folder in the Hercules files you just checked out.

<pre>
$ cd /home/hercules/trunk/sql-files
$ mysql -uuser -ppassword myr-odb < main.sql
$ mysql -uuser -ppassword myro-db < logs.sql
</pre>

Now, you'll want to follow the steps in the [[:Category:Configuration]] and [[Connecting]] pages to get your Hercules configured. Once you've made all your source changes, you can compile Hercules. While you're in the root of your Hercules folder, issue the following commands to compile your server:

<pre>
$ ./configure
$ gmake clean
$ gmake sql
$ rehash
</pre>

'''Important Note:''' If you are using a 32 bit FreeBSD you have to use
<pre>
chmod 777 configure
$ ./configure --disable-64bit
</pre>
instead

''NOTE:'' You should '''NEVER''' run Hercules as the root user!. Always setup a new user and this cannot be stressed enough on!
NB : Always compile as the Hercules user instead of root as that will avoid giving your difficulties with file permissions.

And to start your servers, you can simply use the following command:

<pre>
$ ./athena-start <command> (start | stop | restart | status)
</pre>

And that's it! You now have Hercules running on your FreeBSD machine!

[[Category:Installation Guides]]

Installation (FreeBSD)

2014-01-09T20:12:40Z

Milamber: /* gmake */

This article is aimed at installing and getting [[Hercules]] to run successfully on a machine running [[wikipedia:FreeBSD|FreeBSD]] 9.1-RELEASE. It is assumed that FreeBSD was installed with the ports collection and enabled Linux Threading on install. This guide will NOT teach you how to network FreeBSD, install FreeBSD or configure any additional system settings (besides the ones needed to run Hercules and its dependencies).

=Before we Start=
We will primarily working from the /home/user directory. Your primary user will need to be in the 'wheel' group and be able to su into root. Remember that I will include either $ or #, depending on who you should be. $ indicates you should be your primary user, and # indicates you should be root.

=Required software=
We are going to use FreeBSD's ports collection to download, install and use most of these programs. It is assumed you already installed the ports collection, if you have not, I suggest you do that now.

==Ports Collection==
The Ports Collection is a set of files used to compile and install applications on FreeBSD. While this is not a guide for FreeBSD, its recommended to obtain the same as given below:
<code><pre>
# portsnap fetch
Download a compressed snapshot of the Ports Collection into /var/db/portsnap.

# portsnap extract
When running Portsnap for the first time, extract the snapshot into /usr/ports
</pre></code>

==wget==
wget is a download manager available on FreeBSD and can be your bread and butter while working on FreeBSD.
<code><pre># whereis wget
wget: /usr/ports/www/wget
# cd /usr/ports/www/wget && make && make install
# make clean
# rehash</pre></code>

==gmake==
gmake, or GNUMake, is the GCC compiler used for FreeBSD.
<code><pre>
# whereis gmake
gmake: /usr/ports/devel/gmake
# cd /usr/ports/devel/gmake && make && make install
# make clean
# rehash
</pre></code>

==unrar==
unrar is a tool to unrar .rar's in BSD.
<code><pre> # whereis unrar
unrar: /usr/ports/archivers/unrar
$ cd /usr/ports/archivers/unrar
$ make clean
$ make install
$ rehash
</pre></code>

==GCC==
GCC is the GNU Compiler Collection and front ends for C, C++ and other languages.
This may not be available on the system but it can be obtained as below:
<code><pre># wget http://www.netgull.com/gnu/gcc/gcc-###.tar.gz (Where ## is the version number. visit the mirror to find out)
# tar -xvf gcc-###.tar.gz
# cd gcc*
# make && make install
# make clean
# rehash</pre></code>

==gdb==
GDB is handy tool to have on a development machine, as it can take backtraces of crashes and help you find what went wrong.
It is probable that this is already available on your FreeBSD, but if it's not, here's how you can install it:
<code><pre># wget http://ftp.gnu.org/gnu/gdb/gdb-###.tar.gz (again, where ### is the version number, check out the mirror)
# tar -xvf gdb-###.tar.gz
# cd gdb*
# make && make install
# make clean
# rehash</pre></code>

==git==
[[Git]] is the versioning system used for Hercules and how we will get our copy of Hercules.
<code><pre># whereis git
git: /usr/ports/devel/git
# cd /usr/ports/devel/git && make && make install
# make clean
# rehash
</pre></code>

Now, let's go ahead and download Hercules. We'll use git for this.

<pre>
$ su root
# adduser //create a Hercules user
# exit
$ su hercules
$ cd /home/hercules
$ git clone https://github.com/HerculesWS/Hercules.git Hercules
$</pre>

Now, we can populate the tables with the .sql files in Hercules. Navigate to your /sql-files/ folder in the Hercules files you just checked out.

<pre>
$ cd /home/hercules/trunk/sql-files
$ mysql -uuser -ppassword myr-odb < main.sql
$ mysql -uuser -ppassword myro-db < logs.sql
</pre>

Now, you'll want to follow the steps in the [[:Category:Configuration]] and [[Connecting]] pages to get your Hercules configured. Once you've made all your source changes, you can compile Hercules. While you're in the root of your Hercules folder, issue the following commands to compile your server:

<pre>
$ ./configure
$ gmake clean
$ gmake sql
$ rehash
</pre>

'''Important Note:''' If you are using a 32 bit FreeBSD you have to use
<pre>
chmod 777 configure
$ ./configure --disable-64bit
</pre>
instead

''NOTE:'' You should '''NEVER''' run Hercules as the root user!. Always setup a new user and this cannot be stressed enough on!
NB : Always compile as the Hercules user instead of root as that will avoid giving your difficulties with file permissions.

And to start your servers, you can simply use the following command:

<pre>
$ ./athena-start <command> (start | stop | restart | status)
</pre>

And that's it! You now have Hercules running on your FreeBSD machine!

[[Category:Installation Guides]]

Installation (FreeBSD)

2014-01-09T20:07:15Z

Milamber: Created page with "This article is aimed at installing and getting Hercules to run successfully on a machine running FreeBSD 9.1-RELEASE. It is assumed that FreeBSD was..."

This article is aimed at installing and getting [[Hercules]] to run successfully on a machine running [[wikipedia:FreeBSD|FreeBSD]] 9.1-RELEASE. It is assumed that FreeBSD was installed with the ports collection and enabled Linux Threading on install. This guide will NOT teach you how to network FreeBSD, install FreeBSD or configure any additional system settings (besides the ones needed to run Hercules and its dependencies).

=Before we Start=
We will primarily working from the /home/user directory. Your primary user will need to be in the 'wheel' group and be able to su into root. Remember that I will include either $ or #, depending on who you should be. $ indicates you should be your primary user, and # indicates you should be root.

=Required software=
We are going to use FreeBSD's ports collection to download, install and use most of these programs. It is assumed you already installed the ports collection, if you have not, I suggest you do that now.

==Ports Collection==
The Ports Collection is a set of files used to compile and install applications on FreeBSD. While this is not a guide for FreeBSD, its recommended to obtain the same as given below:
<code><pre>
# portsnap fetch
Download a compressed snapshot of the Ports Collection into /var/db/portsnap.

# portsnap extract
When running Portsnap for the first time, extract the snapshot into /usr/ports
</pre></code>

==wget==
wget is a download manager available on FreeBSD and can be your bread and butter while working on FreeBSD.
<code><pre># whereis wget
wget: /usr/ports/www/wget
# cd /usr/ports/www/wget && make && make install
# make clean
# rehash</pre></code>

==gmake==
gmake, or GNUMake, is the GCC compiler used for FreeBSD. This is how we will create our binaries.
<code><pre> # whereis gmake
gmake: /usr/ports/devel/gmake
# cd /usr/ports/devel/gmake && make && make install
# make clean
# rehash</pre></code>

==unrar==
unrar is a tool to unrar .rar's in BSD.
<code><pre> # whereis unrar
unrar: /usr/ports/archivers/unrar
$ cd /usr/ports/archivers/unrar
$ make clean
$ make install
$ rehash
</pre></code>

==GCC==
GCC is the GNU Compiler Collection and front ends for C, C++ and other languages.
This may not be available on the system but it can be obtained as below:
<code><pre># wget http://www.netgull.com/gnu/gcc/gcc-###.tar.gz (Where ## is the version number. visit the mirror to find out)
# tar -xvf gcc-###.tar.gz
# cd gcc*
# make && make install
# make clean
# rehash</pre></code>

==gdb==
GDB is handy tool to have on a development machine, as it can take backtraces of crashes and help you find what went wrong.
It is probable that this is already available on your FreeBSD, but if it's not, here's how you can install it:
<code><pre># wget http://ftp.gnu.org/gnu/gdb/gdb-###.tar.gz (again, where ### is the version number, check out the mirror)
# tar -xvf gdb-###.tar.gz
# cd gdb*
# make && make install
# make clean
# rehash</pre></code>

==git==
[[Git]] is the versioning system used for Hercules and how we will get our copy of Hercules.
<code><pre># whereis git
git: /usr/ports/devel/git
# cd /usr/ports/devel/git && make && make install
# make clean
# rehash
</pre></code>

Now, let's go ahead and download Hercules. We'll use git for this.

<pre>
$ su root
# adduser //create a Hercules user
# exit
$ su hercules
$ cd /home/hercules
$ git clone https://github.com/HerculesWS/Hercules.git Hercules
$</pre>

Now, we can populate the tables with the .sql files in Hercules. Navigate to your /sql-files/ folder in the Hercules files you just checked out.

<pre>
$ cd /home/hercules/trunk/sql-files
$ mysql -uuser -ppassword myr-odb < main.sql
$ mysql -uuser -ppassword myro-db < logs.sql
</pre>

Now, you'll want to follow the steps in the [[:Category:Configuration]] and [[Connecting]] pages to get your Hercules configured. Once you've made all your source changes, you can compile Hercules. While you're in the root of your Hercules folder, issue the following commands to compile your server:

<pre>
$ ./configure
$ gmake clean
$ gmake sql
$ rehash
</pre>

'''Important Note:''' If you are using a 32 bit FreeBSD you have to use
<pre>
chmod 777 configure
$ ./configure --disable-64bit
</pre>
instead

''NOTE:'' You should '''NEVER''' run Hercules as the root user!. Always setup a new user and this cannot be stressed enough on!
NB : Always compile as the Hercules user instead of root as that will avoid giving your difficulties with file permissions.

And to start your servers, you can simply use the following command:

<pre>
$ ./athena-start <command> (start | stop | restart | status)
</pre>

And that's it! You now have Hercules running on your FreeBSD machine!

[[Category:Installation Guides]]

Compiling

2014-01-09T19:21:08Z

Milamber: /* Using cmake & make */

== Unix ==
=== Using configure & make ===
Configure and make are commands used commonly to configure, build and install Linux applications.
==== Configure ====
{{:Configure}}
==== Make ====
make sql
You should be now noticing that you have 3 new files: '''char-server_sql''', '''map-server_sql''', and '''login-server_sql'''.
Make install is not yet supported.
=== Using cmake & make ===
[http://www.vtk.org/Wiki/CMake Cmake] is a cross-platform configure.

Start creating a new sub directory and move there
mkdir build
cd build

==== Building makefiles ====
Generate the make files by cmake
cmake -G"Unix Makefiles" -DINSTALL_TO_SOURCE=ON ..

<pre>
-- The C compiler identification is GNU
-- Check for working C compiler: /usr/bin/gcc
-- Check for working C compiler: /usr/bin/gcc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Detecting system MYSQL
-- Found MYSQL: /usr/lib/libmysqlclient.so (found version "5.1.58")
-- Detecting system MYSQL - done
-- Configuring for system MYSQL
-- Configuring for system MYSQL - done
-- Detecting system PCRE
-- Found PCRE: /usr/lib/i386-linux-gnu/libpcre.so (found version "8.12")
-- Detecting system PCRE - done
-- Configuring for system PCRE
...
-- Creating target login-server_sql
-- Creating target login-server_sql - done
-- Creating target char-server_sql
-- Creating target char-server_sql - done
-- Creating target map-server_sql
-- Enabled PCRE code
-- Creating target map-server_sql - done
-- Creating target mapcache
-- Creating target mapcache - done
-- Disabled dbghelpplug plugin target (requires WIN32 and HAVE_DBGHELP_H)
-- Available targets:
-- common_base
-- common_sql
-- login-server_sql
-- map-server_sql
-- mapcache
-- Configuring done
-- Generating done
-- Build files have been written to: /home/*/Hercules/build
</pre>

==== Compilation ====
Then compile
make install
<pre>
Scanning dependencies of target common_base
[ 1%] Building C object src/common/CMakeFiles/common_base.dir/__/__/3rdparty/mt19937ar/mt19937ar.c.o
[ 1%] Building C object src/common/CMakeFiles/common_base.dir/core.c.o
[ 2%] Building C object src/common/CMakeFiles/common_base.dir/db.c.o
[ 3%] Building C object src/common/CMakeFiles/common_base.dir/des.c.o
...
[ 98%] Building C object src/tool/CMakeFiles/mapcache.dir/__/common/grfio.c.o
[ 99%] Building C object src/tool/CMakeFiles/mapcache.dir/__/common/utils.c.o
[100%] Building C object src/tool/CMakeFiles/mapcache.dir/mapcache.c.o
...
-- Installing: ~/Hercules/./login-server_sql
-- Installing: ~/Hercules/./char-server_sql
-- Installing: ~/Hercules/./map-server_sql
-- Installing: ~/Hercules/./mapcache
</pre>
You'll see nice green output progression then finally login-server_sql, map-server_sql, char-server_sql, in main folder

== Windows ==
{{:Compiling/Windows}}

[[Category:Installation]]

Category:Data

2014-01-09T19:19:16Z

Milamber: Blanked the page

Category:Data

2014-01-09T19:18:57Z

Milamber: Created page with "Data"

Data

Main Page

2014-01-09T18:53:05Z

Milamber:

{| style="width: 100%;" cellspacing="5" cellpadding="0"
| colspan="3" |
|-
| style="background: #FCFCFC; border: 1px solid #AAA; vertical-align: top;" |
<div style="background: #ACD; border: 1px solid #7BC; padding: 5px; margin: 3px; font-weight: bold; text-align: center; font-size: 120%;">About Hercules</div>
<div style="padding-left: 1em;">
[[Hercules]] is an [[wikipedia:Open_source|open-source]] project, revolving around the creation of a robust massively multiplayer online role playing game (MMORPG) server package, emulating a [[wikipedia:Ragnarok_Online|Ragnarok Online]] [[wikipedia:Server|Server]]. Written in [[wikipedia:C_(programming_language)|C]] the program is very versatile and provides NPCs, warps and modifications. and is currently version controlled via [[wikipedia:Git_(software)|Git]]. The project is jointly managed by a group of volunteers located around the world as well as a tremendous community providing QA and support. Hercules is a continuation of the original Athena project.

Hercules currently runs on most common [[wikipedia:Operating_system|Operating Systems]] currently available today. For a full list, please see the [[System Requirements]].

</div>

<div style="background: #ACD; border: 1px solid #7BC; padding: 5px; margin: 3px; font-weight: bold; text-align: center; font-size: 120%;">Editing the Wiki</div>
<div style="padding-left: 1em;">
All users must login to the wiki using their forum account. Any member 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 [[Editing the wiki]] 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!

</div>

<div style="background: #ACD; border: 1px solid #7BC; padding: 5px; margin: 3px; font-weight: bold; text-align: center; font-size: 120%;">Quick Tips</div>
<div style="padding-left: 1em;">
*Spell check your work and make sure the grammar is correct.
*Use English.
*Do not vandalize the wiki. Vandalization will come with harsh punishment.
*Please see [[mw:Help:Formatting|Formatting a wiki]] for tips on wiki formats and syntaxes.
</div>

| style="background: #FCFCFC; border: 1px solid #AAA; vertical-align: top;" |
<div style="width: 260px; background: #ACD; border: 1px solid #7BC; padding: 5px; margin: 3px; font-weight: bold; text-align: center; font-size: 120%;"><div style="float: right; padding: 0 20px;">[[Image:poring1.gif]]</div>Installation</div>
<div style="padding-left: 1em;">
; [[Getting Started]]
: [[System Requirements]]
; [[:Category:Installation|Installation]]
: [[Installation_(CentOS)|CentOS]]
: [[Installation_(Debian)|Debian Linux]]
; [[Compiling]]
; [[Connecting|Connecting and Starting]]
; [[:Category:Configuration|Configuration]]
</div>
<div style="background: #ACD; border: 1px solid #7BC; padding: 5px; margin: 3px; font-weight: bold; text-align: center; font-size: 120%;"><div style="float: right;">[[Image:develing1.gif]]</div>Server Side</div>
<div style="padding-left: 1em;">
; [[Scripting]]
: [[Basic Scripting]]
: [[:Category:Script_Command|Script Commands]]
: [[Permanent Monster Spawn]]
: [[Instancing]]
:
; [[Server Modification]]
: [[:Category:Source_Functions|Source Functions]]
: [[:Category:Source Snippets|Source Snippets]]
: [[Hercules Plugin Manager]]
: [[Packets]]
:
; [[:Category:Database|Database]]
: [[Custom Items]]
: [[Custom Mobs]]
: [[Custom weapons]]
</div>
<div style="background: #ACD; border: 1px solid #7BC; padding: 5px; margin: 3px; font-weight: bold; text-align: center; font-size: 120%;"><div style="float: right;">[[Image:angeling1.gif]]</div>Client Side</div>
<div style="padding-left: 1em;">
; [[:Category:Data|Data]]
; [[Spriting]]
: [[Palettes]]
: [[Acts]]
:
; [[:Category:Mapping|Mapping]]
: [[Modeling]]
: [[Texture]]
:
; [[:Category:Client_Configuration|Client Stuff]]
;
; [[:Category:Patchers|Patchers]]
</div>
|}

Installation (Debian)

2013-11-25T11:20:44Z

Milamber:

This guide covers how to install [[Hercules]] on [[wikipedia:Debian|Debian]] and other [[wikipedia:List_of_Linux_distributions#Debian-based|versions of Linux]] that use apt-get.

== Requirements ==
* [[wikipedia:Debian|Debian]] or an [[wikipedia:List_of_Linux_distributions##Debian-based]] that has the apt-get command
* root access or access to an account that has [[wikipedia:Sudo|sudo privileges]]
* an Internet connection to download install packages

== Prerequisites ==
All of these commands will be typed at the [[wikipedia:Command-line_interface|command-line interface]].
=== Install Prerequisites ===
# Login to your server via [[wikipedia:Secure_Shell|SSH]], or if you are already logged into a [[wikipedia:Graphical_user_interface|GUI]] press Ctrl+Alt+T to open a terminal window.
apt-get update
apt-get upgrade
apt-get dist-update // To update to the latest version of Debian
# Type the following command (this will install GCC, Make, MySQL Server, MySQL header files, PCRE header files, Subversion, and Zlib header files)
#: <pre>apt-get install subversion make gcc mysql-server libmysqlclient-dev zlib1g-dev libpcre3-dev screen</pre>

=== Create a non-root Linux user ===
By the [[wikipedia:Principle_of_least_privilege|principle of least privilege]], it is recommended you do '''NOT''' run Hercules as root.
# Type the following command to create a non-root Linux account:
#: <pre>useradd hercuser</pre>

== Install [[Hercules]] ==

=== Login as your non-root Linux user ===
The rest of the setup is done as hercuser (the Linux user you created earlier)
# Logout from root SSH (or minimize the window).
# Login to your server via SSH as the hercuser Linux user.

=== SVN Checkout ===
{{:SVN Checkout/Unix}}

=== [http://dev.mysql.com/doc/refman/5.5/en/batch-commands.html Import] MySQL Tables ===
# Change directory to the '''sql-files''' folder.
#: <pre>cd sql-files/</pre>
# Execute these commands:
#: ''When prompted, enter your MySQL root password.''
#: <pre>mysql -u root -prootpassword hercuser_rodb < main.sql</pre>
#: <pre>mysql -u root -prootpassword hercuser_rodb < item_db.sql</pre>
#: <pre>mysql -u root -prootpassword hercuser_rodb < item_db2.sql</pre>
#: <pre>mysql -u root -prootpassword hercuser_rodb < mob_db.sql</pre>
#: <pre>mysql -u root -prootpassword hercuser_rodb < mob_db2.sql</pre>
#: <pre>mysql -u root -prootpassword hercuser_rodb < mob_skill_db.sql</pre>
#: <pre>mysql -u root -prootpassword hercuser_rodb < mob_skill_db2.sql</pre>
#: <pre>mysql -u root -prootpassword hercuser_rodblog < logs.sql</pre>
# If you are using Renewal you also have to import the following
#: <pre>mysql -u root -prootpassword hercuser_rodb < item_db_re.sql</pre>
#: <pre>mysql -u root -prootpassword hercuser_rodb < item_db2_re.sql</pre>
#: <pre>mysql -u root -prootpassword hercuser_rodb < mob_db_re.sql</pre>
#: <pre>mysql -u root -prootpassword hercuser_rodb < mob_skill_db_re.sql</pre>

NOTE: if you want to use different SQL DBs for login/char/map servers this is the list of databases each server use:
#login-server: global_reg_value, ipbanlist, login, loginlog
#map-server: mapreg, item_db, item_db2, mob_db, mob_db2,mob_skill_db
#char-server: everything else + global_reg_value once again
Note that global_reg_value tables are needed by both login-server and char-server (though it may be different tables)

=== [[:Category:Configuration|Configure Hercules]]===

=== Compile Source Code ===
cd trunk
./configure
make sql

*If you have added plugins for use with Hercules please use the below syntax instead of the above:
cd trunk
./configure
make sql plugins

*If you're using Debian 32-bit please use:
cd trunk
./configure --disable-64bit
make sql plugins

===== How to Recompile =====
In the future (after you update or edit any file in /src) to recompile, add ''make clean'' before make sql:
cd trunk
./configure
'''make clean'''
make sql plugins

== Start your Hercules Server ==
//change access mode of athena-start file so that you can execute it.
//Use (dos2unix athena-start) if yo uare getting ^M errors ie. newline errors
chmod a+x athena-start

//To Start
./athena-start start
//To Stop
./athena-start stop
//To Restart
./athena-start restart

== See Also ==

[[Category:Installation Guides|Debian Linux]]

Installation (Debian)

2013-11-25T11:18:18Z

Milamber: Created page with "This guide covers how to install Hercules on Debian and other versions of Linux that use apt-ge..."