______ __ __
/\ _ \/\ \__/\ \
__\ \ \L\ \ \ ,_\ \ \___ __ ___ __
/'__`\ \ __ \ \ \/\ \ _ `\ /'__`\/' _ `\ /'__`\
/\ __/\ \ \/\ \ \ \_\ \ \ \ \/\ __//\ \/\ \/\ \L\.\_
\ \____\\ \_\ \_\ \__\\ \_\ \_\ \____\ \_\ \_\ \__/.\_\
\/____/ \/_/\/_/\/__/ \/_/\/_/\/____/\/_/\/_/\/__/\/_/
_ _ _ _ _ _ _ _ _ _ _ _ _
/ \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \
( e | n | g | l | i | s | h ) ( A | t | h | e | n | a )
\_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/
--------------------------------------------------------------
eAthena VERSION
--------------------------------------------------------------
Version 1.0.0 Release Candidate 3
--------------------------------------------------------------
This is a release candidate to iron out any bugs before
official release.
--------------------------------------------------------------
Caution : Make sure you are giving your users account id's
greater than 2000000, failure to do so can cause a number of
problems.
--------------------------------------------------------------
eATHENA README
--------------------------------------------------------------
Thank you for downloading eAthena.
We hope that you'll enjoy using this software.
--------------------------------------------------------------
--------------------------------------------------------------
eAthena Features
--------------------------------------------------------------
> eAthena Completed Features
--------------------------------------------------------------
- PvP (Player VS Player)
- GvG (Guild VS Guild)
- qPets (Cute Pets)
- Monster skills
- 2-2 Jobs (Alternate 2nd Jobs)
- SuperNovice (Alternate 1st Job)
- WoE (War of Emperium)
- Remote administration of accounts (ladmin softwares)
- Pet-Equipped Mobs
- Management of day/night
--------------------------------------------------------------
> eAthena Incompleted Features (List)
--------------------------------------------------------------
- Advanced Classes (Upper Jobs)
- Baby Classes (Baby Jobs)
- Pet Skills
- Equipment Breaking System
- PK Server Mode
--------------------------------------------------------------
> eAthena Features - Estimated completion rate (Detailed)
--------------------------------------------------------------
- Guild Wars (War of Emperium) - 100% Complete (4/4)
- Novice Skills - 100% Complete:(3/3)
- 1st Job Skills - 100%
* Swordsman - 100% Complete:(10/10)
* Acolyte - 100% Complete:(16/16)
* Archer - 100% Complete:(7/7)
* Magician - 100% Complete:(14/14)
* Merchant - 100% Complete:(10/10)
* Thief - 100% Complete:(10/10)
- 2-1 Skills (2nd Job Skills) - 100%
* Knight - 100% Complete:(10/10)
* Priest - 100% Complete:(18/18)
* BlackSmith - 100% Complete:(21/21)
* Wizard - 100% Complete:(13/13)
* Assassin - 100% Complete:(10/10)
* Hunter - 100% Complete:(17/17)
- 2-2 Skills (Alternate 2nd Job Skills) - 90.5%
* Crusader - 100% Complete:(18/18)
* Monk - 100% Complete:(15/15)
* Alchemist - 54% Complete:(12/22) Complete:(10/22) (Blame Gravity For The Missing Skills)
* Sage - 100% Complete:(20/20)
* Rogue - 80% Complete:(12/15) Incomplete:(3/15)
* Bard - 100% Complete:(16/16)
* Dancer - 100% Complete:(16/16)
- 2-1-1 Skills (Advanced 2-1 Job Skills) - 80.5%
* Lord Knight - 94% - Complete:(7/8) Incomplete:(1/8)
* High Priest - 66% - Complete:(1/3) Incomplete:(2/3)
* High Wizard - 100% Complete:(4/4)
* Whitesmith - 75% Complete:(3/4) Incomplete:(1/4)
* Sniper - 88% - Complete:(3/4) Incomplete:(1/4)
* Assassin Cross - 60% Complete:(3/5) Incomplete:(2/5)
- 2-2-1 Skills (Advanced 2-2 Job Skills) - 47%
* Paladin - 65%
* Champion - 100%
* Professor - 100%
* Stalker - 65%
* Creator - 0%
* Clown - 0%
* Gypsy - 0%
- Pet Skills - 95%
* Loot Skills - 100%
* Buff Skills - 100%
* Attack Skills - 90%
* Assist Skills - 100%
- Equipment Breaking System - 50%
* Weapon Breaking - 85%
* Armor Breaking - 80%
* Equipment Repair - 80%
- PK Server Mode - ??%
* Need more info on this mode to be called complete.
--------------------------------------------------------------
> eAthena - What we currently do not have
--------------------------------------------------------------
- Wedding System (In Progress!)
--------------------------------------------------------------
--------------------------------------------------------------
--------------------------------------------------------------
--------------------------------------------------------------
System Requirements
--------------------------------------------------------------
> Minimum System Requirements
--------------------------------------------------------------
800Mhz Processor
256MB RAM
NOTE: For this setup, it's recommended to not load as many maps
and spawn as many monsters as it comes default with eAthena.
To do this, comment off unused maps and control monster spawn
rate using mob_count in battle_athena.conf.
--------------------------------------------------------------
> Recommended System Requirements
--------------------------------------------------------------
1+Ghz Processor
512+MB RAM
NOTE: For this setup, generally, running the eAthena default
should be fine. If you have alot of extra RAM, you might even
consider raising the mob_count in battle_athena.conf so that
there will be more than normal monsters in your server
--------------------------------------------------------------
--------------------------------------------------------------
--------------------------------------------------------------
--------------------------------------------------------------
Setting up eAthena
--------------------------------------------------------------
> Setting up a new eAthena
--------------------------------------------------------------
1. Run the setupwizard program. This will assist you in
configuring Athena for the first time. Just follow the
instructions in the program.
2. Edit motd.txt, grf-files.txt & .conf files as neccessary
3. If you want to add a user, go to tools and use the AddUser
tool
4. Run the login-server, char-server and map-server in the
main Athena directory
5. You're done!
--------------------------------------------------------------
> Upgrading from older eAthena:
--------------------------------------------------------------
- From a release newer than 953 or 817:
1. Transfer your old /save/ folder contents (Athena.txt,
Account.txt, Storage.txt, etc.) to the new /safe/ folder
2. Transfer/Edit grf-files.txt, gm-account.txt and motd.txt as
neccessary
3. Transfer any extra custom NPCs to the /npc/ folder and
edit if neccessary
4. Edit .conf files to setup your server
5. You're done!
NOTE: It is not recommended to transfer your DB files
as the DB files are constantly updated by the eAthena/jAthena
team. Just read your changes to the new DB files instead of
replacing the new DB file with your old one.
--------------------------------------------------------------
- From a release older than 670:
1. Transfer your old data files (Athena.txt, Account.txt,
Storage.txt, Pet.txt, etc) into the /save/ folder
2. Transfer/Edit grf-files.txt, gm-account.txt as neccessary
3. Transfer any extra custom NPCs/DBs to the new /npc/ folder
and edit if neccessary
4. Edit .conf files to setup your server
5. You're done!
NOTE: It is not recommended to transfer your .conf files from
your old eAthena setup to this new one because there are always
changes and new additions to these .conf files all the time
NOTE 2: It is also not recommended to transfer your DB files
as the DB files are constantly updated by the eAthena/jAthena
team. Just readd your changes to the new DB files instead of
replacing the new DB file with your old one.
--------------------------------------------------------------
--------------------------------------------------------------
--------------------------------------------------------------
--------------------------------------------------------------
Playing eAthena
--------------------------------------------------------------
1. Make sure all the files are setup properly (conf files)
2. Load eAthena
2a. Run login-server
2b. Run char-server
2c. Run map-server
3. Wait for map-server to finish loading.
4. Play using a custom XML.
--------------------------------------------------------------
--------------------------------------------------------------
--------------------------------------------------------------
--------------------------------------------------------------
Frequently Asked Questions
--------------------------------------------------------------
A: You're missing the cygwin dlls. Please get the latest dll at:
http://www.cygwin.com/snapshot. If you're unsure, asking
around in our IRC chatroom will get you around too, but
always remember - use common sense and search before asking.
Q: My map-server won't load! It appears to be loading things
before it dissapeared suddenly! HELP!
A: Use command line to load map-server. It should tell you the
error. If you're missing a map, update your kRO Sakray or
uncomment the map from map_athena.conf. If you have an
errornous NPC, fix it or comment it off. Anything other than
that, feel free to ask around.
Q: My map-server failed to load 'adata.grf'! Where do I find
this adata.grf? My map-server won't load without it!
A: The error that caused the map-server to not load is not the
adata.grf. You do NOT need to have adata.grf so that the map
server can load. The error is probably something else.
Q: All 3 of the servers are loaded, but I am still having
problems accessing it! What do I do?
A: First, check the IPs in map_athena.conf and char_athena.conf.
If that's correct, check the ports to make sure they match.
If that's correct too, you probably cannot handle the server
load. Lower the monster spawning rate using mob_count in
battle_athena.conf and it should be fine.
Q: You said eAthena has 2-2 skills. Well, I tried it and there
are no 2-2 skills when I use 2-2 characters! You lie!
A: No, I did not. You have an outdated Ragexe/Sakexe that does
not support 2-2 skills. Update it to a later one which does.
Q: How do I start Guild Wars/War of Emperium??? HELP!!!
A: Read the help.txt for full list of commands that GMs can use.
@agitstart and @agitend is also listed there as commands to
start and end Guild Wars.
Q: My Ragnarok Online crashed while playing with eAthena! What
do I do now?
A: Well, if your Ragnarok crashes, it's most probably not
anything to do with eAthena. Something is wrong with your
Ragnarok installation. Try reinstalling or updating.
Q: Is eAthena compatible with mySQL? Can I use mySQL as the DB
instead of using text files?
A: Yes, eAthena is compatible with mySQL. A tutorial on how to
setup this is coming soon.
Q: Is eAthena compatible with msSQL? Can I use msSQL as the DB
instead of using text files?
A: No, eAthena is not compatible with msSQL. You cannot use
msSQL with eAthena.
Q: I found a bug! Where do I report it?
A: Drop the developers a line at the IRC chatroom. Or just post
it in the bug report forum. We check them out too. :)
Q: I know alot of C and I'm able to help improve eAthena and
add new features. How can I join your development team?
A: Try talking to one of the current developers in the eAthena
channel.
Q: What is this AthenaAdvanced/omniAthena that I keep hearing of?
A: Huh? What's that?
Q: Why does eAthena crash, and how come you can't prevent this?
A: eAthena is a working in progress we never stated eAthena is
bug free, most likely no software is bugfree, if they state
this they are lying sons of beeps and you should sue them
for false advertisement.
--------------------------------------------------------------
--------------------------------------------------------------
--------------------------------------------------------------
--------------------------------------------------------------
Support
--------------------------------------------------------------
For support, first check the Frequent Asked Questions.
If the question doesn't exist, check the forums. Search before
posting to see if the question had been asked and answered.
If not, post and we'll try and help you.
Our forums is located at: http://eathena.deltaanime.net
You can also visit our IRC chatroom and ask your questions
there.
Our IRC chatroom is located at: irc.deltaanime.net #athena
--------------------------------------------------------------
--------------------------------------------------------------
--------------------------------------------------------------
--------------------------------------------------------------
Development
--------------------------------------------------------------
eAthena is based on the original Athena, by the Japanese
Development Team. A big thanks to them for working hard on
Athena.
The eAthena Development Team:
AppleGirl
Akaru
Evera/Lorri
Wizputer
Valaris
Yor
Kalaspuff
Syrus22
Darkchild
CLOWNISIUS
RichG
Kashy
Lupus
NOTE: Sorry if I missed anyone while writing this. If you are
in the team but not included in this list, PM me.
--------------------------------------------------------------
--------------------------------------------------------------
--------------------------------------------------------------
--------------------------------------------------------------
Special Thanks and Shoutouts!
--------------------------------------------------------------
The eAthena development team would like to specially thank:
- the Japanese Development Team. A big thanks to them for
working hard on Athena which eAthena is based on.
- RoVeRT, our ex-developer. eAthena wouldn't have this many
features without him!
- sara-chan, who had also contributed alot to the development
of eAthena! Thanks!
- Gravity, for making Ragnarok Online. eAthena wouldn't even
exist if it wasn't for them!
- ASB for hosting our forum section :)
- Deltaanime for hosting our new official forums :)
- And others who gave continuously endless support to eAthena!
- fov and Kinko for their bugfixes.
NOTE: Sorry if I missed anyone while writing this. If you are
in the team but not included in this list, PM me.
--------------------------------------------------------------
--------------------------------------------------------------
--------------------------------------------------------------
--------------------------------------------------------------
License:
--------------------------------------------------------------
eAthena is licensed under the GPL. Please refer to LICENSE in
your Athena folder for the full GPL License statement.
--------------------------------------------------------------
--------------------------------------------------------------
