Dev:How to Develop

Revision as of 19:50, 10 June 2011 by Wombat (talk | contribs) (added how to develop info from Wombat user page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

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.

Dependencies: Throughout this tutorial, I do not address dependencies. Bison and Flex are needed, as are other dependencies. This will be inserted with time.

  1. Open a command line terminal (e.g. xterm or konsole).
  2. mkdir ~/tmw-ea (or other name you prefer your directory to be called).
  3. cd ~/tmw-ea
  4. git clone git:// eathena
  5. git clone git:// eathena-data
  6. git clone git:// tmwdata
  7. cd eathena
  8. make
  9. cd ../eathena-data
  10. ln -s ../eathena/{char-server,login-server,map-server,ladmin} .
  11. for F in *.example; do cp $F ${F/.example/}; done
  12. cp save/account.txt.example save/account.txt
  13. Edit conf/char_local.conf and change login_ip and char_ip to
  14. Edit conf/map_local.conf and change char_ip and map_ip to
  15. Edit conf/ladmin_local.conf and change login_ip to, login_port to 6901, and admin_pass to p1
  16. TODO give instructions about lan_support.conf and opening your server to access from other computers.
  17. cd conf
  18. ./build-magic
  19. Edit the second column of conf/spells-build to give usable names to spells.
  20. ./build-magic (again)

Start the servers

  1. Open a command line terminal.
  2. cd ~/tmw-ea/eathena-data
  3. ./char-server
  4. Repeat steps 1 and 2
  5. ./login-server
  6. Repeat steps 1 and 2.
  7. ./map-server

This should run all three of your servers.


  1. Start the servers.
  2. Open a command line terminal.
  3. cd ~/tmw-ea/eathena-data
  4. ./ladmin
  5. add username M password
  6. gm username 99


  1. Open a command line terminal.
  2. Run your client pointing to your client data and your local server. E.g. mana -u -d ~/tmw-ea/tmwdata --server localhost --port 6901

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

Making Content

Making Map Content

Java Converter Tool

This has been my experience on running the java Converter tools, which takes map data from client-data and applies it to the server-data. The README addresses dependencies for using this tool. It suggests there are other ways it can work in the README, if this method does work for you.

  1. cd ~/tmw-ea/eathena-data/tools/tmwcon
  2. ant
  3. ln -s ../.. server-data
  4. ln -s ../../../tmwdata tmwdata
  5. java Converter

Making Monster, Item and Equipment Content

Bit Masking

Bit Masking helps us reduce our variable count while offering a dynamic method of script writing that is versatile and flexible to both linear and non-linear script writing.

Bit Masking Test Script

Using the Git Repositories

Making Git Patches and Submitting them For Review

Reviewing Git Patches and Pushing

Git Branches, Git Merging

Using the Test Server