/rathena

rAthena is an open-source cross-platform MMORPG server.

Primary LanguageC++GNU General Public License v3.0GPL-3.0

rAthena

clang cmake gcc ms GitHub commit activity GitHub repo size

rAthena is a collaborative software development project revolving around the creation of a robust massively multiplayer online role playing game (MMORPG) server package. Written in C, the program is very versatile and provides NPCs, warps and modifications. The project is jointly managed by a group of volunteers located around the world as well as a tremendous community providing QA and support. rAthena is a continuation of the eAthena project.

Forum Discord Wiki FluxCP Crowdfunding Fork and Pull Request Q&A

Table of Contents

  1. Prerequisites
  2. Installation
  3. Troubleshooting
  4. More Documentation
  5. How to Contribute
  6. License

1. Prerequisites

Before installing rAthena there are certain tools and applications you will need which differs between the varying operating systems available.

Hardware

Hardware Type Minimum Recommended
CPU 1 Core 2 Cores
RAM 1 GB 2 GB
Disk Space 300 MB 500 MB

Operating System & Preferred Compiler

Operating System Compiler
Linux gcc-5 or newer / Make
Windows MS Visual Studio 2017 or newer

Required Applications

Application Name
Database MySQL 5 or newer / MariaDB 5 or newer
Git Windows / Linux

Optional Applications

Application Name
Database MySQL Workbench 5 or newer

2. Installation

Full Installation Instructions

3. Troubleshooting

If you're having problems with starting your server, the first thing you should do is check what's happening on your consoles. More often that not, all support issues can be solved simply by looking at the error messages given. Check out the wiki or forums if you need more support on troubleshooting.

4. More Documentation

rAthena has a large collection of help files and sample NPC scripts located in the /doc/ directory. These include detailed explanations of NPC script commands, atcommands (@), group permissions, item bonuses, and packet structures, among many other topics. We recommend that all users take the time to look over this directory before asking for assistance elsewhere.

5. How to Contribute

Details on how to contribute to rAthena can be found in CONTRIBUTING.md!

6. License

Copyright (c) rAthena Development Team - Licensed under GNU General Public License v3.0

7. Compile

Windows

cmd.exe -/c ".\compile.bat"

Linux/MacOS

./configure && make clean && make server

You might need

chmod a+x login-server && chmod a+x char-server && chmod a+x map-server && chmod a+x web-server

8. Run

Windows

docker-compuse up cmd.exe -/c ".\runserver.bat"

Linux/MacOS

./athena-start start ./athena-start stop ./athena-start restart