summaryrefslogblamecommitdiff
path: root/doc/Readme2.txt
blob: 0f938fa0a44e0a49f5c384f87bab94aa20113461 (plain) (tree)















































































































































































































































































































































































                                                                                            
      ______  __    __                                 
     /\  _  \/\ \__/\ \                                
   __\ \ \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.
--------------------------------------------------------------
--------------------------------------------------------------