User:Wombat/How To Develop

Set Up

This is a how to help content development for official TMW-eA using Ubuntu 10.04 on amd64 and the Mana client. Other OS and clients may differ. Following this guide, you should be able to get development testing versions of the client data (tmwdata), server-data (eathena-data) and participate in development by using a localhost server. After getting these, you can both test current development and begin development in the direction you find most fitting.

1. open a command line terminal. Optional: cd to where you want your directory to be located (or don't, if you prefer adding a directory to your #HOME directory).

2. mkdir tmw-ea (or other name you prefer your directory to be called). If you don't cd to a new location, this will default to #HOME/tmw-ea, which I recommend and use for the remainder of this tutorial.

3. cd tmw-ea

4. git clone git://gitorious.org/tmw-eathena/mainline.git eathena

5. git clone git://gitorious.org/~wombat/tmw-eathena-data/cache-serverdata.git eathena-data

6. git clone git://gitorious.org/~wombat/tmwdata/cache-clientdata.git tmwdata

7. cd eathena

8. make

9. make tools

10. cd ..

11. cd eathena-data

12. cp -iv ../eathena/char-server char-server

13. cp -iv ../eathena/login-server login-server

14. cp -iv ../eathena/map-server map-server

15. Close command line terminal and open text editor (I use Gedit or Kate, though I've also used others).

16. Open eathena-data/conf/char_local.conf.example and change login_ip and char_ip to 127.0.0.1 Save as char_local.conf (remove .example).

17. Open eathena-data/conf/login_local.conf.example and save as login_local.conf (remove .example).

18. Open eathena-data/conf/map_local.conf.example and change char_ip and map_ip to 127.0.0.1 Save as map_local.conf (remove .example).

19. Open eathena-data/conf/magic.conf.template Save as magic.conf (remove .template).

20. Open save/account.txt.example and Save as account.txt (remove example).

You are ready to begin testing! To begin testing here are some more steps:

21. Open a command line terminal.

22. cd $HOME/tmw-ea/eathena-data

23. $HOME/tmw-ea/eathena-data/char-server

24. Repeat steps 21 and 22

25. $HOME/tmw-ea/eathena-data/login-server

26. Repeat steps 21 and 22.

27. $HOME/tmw-ea/eathena-data/map-server

This should run all three of your servers.

28. Open a command line terminal.

29. cd to your client's location. I use "Mana" in my $HOME directory: cd mana/src

30. Run your client pointing to your client data. Using Mana I type: mana -u -d $HOME/tmw-ea/tmwdata

31. Select "Custom Server". Server: 127.0.0.1 Port: 6901 Server type: tmwAthena If you already have a localhost server on your list, select it and click "Connect".

32. Register your account and create a character.

33. Using your text editor and if not already opened, open eathena-data/save/account.txt

34. Once your first account is registered, it will listed as 2000000. Copy 2000000

35. Open conf/gm_account.txt.example. Go to the first available line (line 2) paste 2000000 (account number) hit space and then type 99 (GM Level with administrative privileges). Save as gm_account.txt (remove .example).

If all goes well, you are now ready to test new content and participate with development.