==Developing for new Hercules server (TMW-Evol merge)==

=== Quick Start for local server ===

==== Create ssh key and upload it ====

create ssh key and upload it to gitlab.com

https://about.gitlab.com/2014/03/04/add-ssh-key-screencast/

Note: Even if discouraged, you can skip this section by replacing every instance of <code>git@gitlab.com:</code> with <code><nowiki>https://gitlab.com/</nowiki></code> 

==== Install Dependencies ====

Depending on what sql and OS your using install Maria or Mysql packages:
* Maria packages: mariadb-server, mariadb-client, mariadbclient-dev, libmariadbclient-dev
* Mysql packages: mysqldb-server, mysqldb-client, mysqlclient-dev, libmysqlclient-dev

All these other dependencies need to be installed regardless of sql used:
* zlib-dev or zlib1g-dev package, libpcre-dev, gcc, make, automake, autoconf, libtool

Some distributions also require manual installation of ssl and crypto packages:
* libssl-dev, libcrypto++-dev

Note: Some packages may named differently depending on your distro. 
You may use <code>apt-cache search libpcre</code> to check all packages which contain 'libpcre' on the name, and hopefully find the right one.
It may be named <code>libpcre0v5-dev</code> for example.

apt-cache is not available on non-Debian or non-Debian-based distros.

==== Open command line/terminal ====

<code> ~$</code>

==== Clone repository ====

run command:

<code>git clone git@gitlab.com:evol/evol-all.git</code>

You will see something like this:

<code><pre>$ git clone git@gitlab.com:evol/evol-all.git
Cloning into 'evol-all'...
remote: Counting objects: 69, done.
remote: Compressing objects: 100% (67/67), done.
remote: Total 69 (delta 36), reused 0 (delta 0)
Receiving objects: 100% (69/69), 7.05 KiB | 0 bytes/s, done.
Resolving deltas: 100% (36/36), done.
Checking connectivity... done.</pre></code>

==== Init repos ====

In evol-all directory run command
: <code>./init.sh all</code>

==== Build and set-up local server ====

In directory server-data in evol-all run the following command:

: <code>make new</code>

(Note: Mariadb/MySQL needs to be up and running for this command to execute correctly, Debian/Ubuntu may automatically do this setup on installation. Read your distro's manuals for SQL setup and configuration.)

==== Running server ====

You need to repeat this step every time your computer shuts down,
or every time you close your terminal.

First, you should be in server-data folder.

In three separate console windows, run the following commands:

: <code>./login-server</code>
: <code>./char-server</code>
: <code>./map-server</code>

Pay attention to any bug reported in any of them, as they often mean
something went wrong in the previous steps.

Keep in mind that if you close the terminal windows, you'll need to
run these commands again. You should preferably run them in this order.

Note: You may also use <code>screen</code> (a linux program) to make
your life easier, by keeping the servers running in background.
Instructions on how to use the <code>screen</code> program are not
provided here; Please read the screen manpage instead.

Note: MySQL/Mariadb must be running for these commands to work.

==== Register an Account via M+ on localserver & GM account ====

If everything went well, you should have your servers up and running.
To login on your localhost, you can do it two ways: By our provided tool file,
or by manually adding a new entry to ManaPlus.

To use the provided tool file:

<code><pre>cd tools/manaplus
./connect_local_server.sh</pre></code>

To set-up M+ (ManaPlus) to log into localserver:

Name: My Dev

Address: 127.0.0.1

Port: 6901

Server type: Evol2

Once connected select the register button & sign up for an account

Once registered, test by logging into the server.

Note: If you have not yet installed client-data you may not see any artwork after logging in.
Note: If you log in to your local server without using the script, Manaplus may use the wrong client-data.

Now you should be able to give that account GM by running
<code>make givegm</code>

You should now have a working Local server with GM 99 on your account.

=== Additional steps you may need for development (Advanced) ===

Before next steps you should open terminal in evol-all direcory.

You should something like this:

<code>$~/evol-all</code>

Depend what kind of development you will do, you need run of any additional steps.

Also you can mix any of 4.x. steps in one directory.

====Server code development ====

If you want run or develop server code or server content, you must install "server" task.

run command:

<code>./init.sh server</code>

and you will see repository cloning progress.

After will be created new directories: '''server-code''', '''server-data''', '''server-plugin'''

==== Run manaplus or client data / art / maps etc. development ====

If you want develop client side content, you must install "client" task.

run command:

<code>./init.sh client</code>

and you will see repository cloning progress.

After will be created new directories: '''client-data''', '''tools'''

If you want latest ManaPlus version, you also should install task "manaplus" and build it. See [[#ManaPlus|1.3.5]].

==== Music ====

If you want develop music, you must install "music" task.

run command:

<code>./init.sh music</code>

and you will see repository cloning progress.

After will be created new directories: '''music'''

==== Local server ====

run command:

<code>./init.sh local</code>

and you will see repository cloning progress.

After will be created new directories: '''server-local''', '''server-code''', '''server-data''', '''server-plugin'''

Probably you also should add task "client" for running ManaPlus. See [[#Run manaplus or client data / art / maps etc. development|1.3.2]].

See also [[localserver|local server]]

====ManaPlus ====

If you want develop ManaPlus or want run ManaPlus from git, you should install "manaplus" task.

run command:

<code>./init.sh manaplus</code>

and you will see repository cloning progress.

After will be created new directories: '''manaplus'''

====All====

If you want all tasks at same time, you must install task "all".

run command:

<code>./init.sh all</code>

and you will see repository cloning progress.

After will be created new directories for all possible work.

==== Install and configure mariadb server ====

For run server you need install and configure mysql or mariadb.

[[guidelines/installmariadb|See here]]

====Run client and connect to server ====

Before running client you must install atleast '''server''' and '''client''' task or '''all''' task.

If you want run ManaPlus and connect to local server, run this:

<code><pre>cd tools/manaplus
./connect_local_server.sh</pre></code>

Client will start and connect to server.

====Upgrade repository urls ====

If you cloned repository long ago, you need update repository urls.

If you not cloned repository, follow step 1.

Also you should register on https://gitlab.com/ and add own ssh key here.

Before next steps you should open terminal in evol-all directory.

You should have something like this:

<code>$~/evol-all</code>

For update this repository url run this:

<code>git config remote.origin.url git@gitlab.com:evol/evol-all.git</code>

And now pull from this updated url:

<code>git pull</code>

Update all repositories urls:

<code>./upgrade.sh gitlab</code>

You will see something like this:

<code>evol-all:
set origin to git@gitlab.com:evol/evol-all.git
client-data:
set origin to git@gitlab.com:evol/clientdata.git
...</code>

And final step, you can pull from new repositories by run:

<code>./pull.sh</code>

----

==Making Content==
===Making Map Content===
See [[Mapping Tutorial]].
====Adding Map Content to Local Server====
The server have its own version of the collision data of a map.
To update it, on server-data folder, simply run:

: <code>make maps</code>
====Python Converter Tool (obsolete)====
After editing maps for the client, you need to generate the walkmaps and imports for the server. yhis can be done either by the '''[[Tiled]]''' application or by running the python script '''tmx_converter.py''' which is located in the '''tools''' folder of the '''Server Data''' folder.
(see [[Mapping Tutorial#Creating the WLK files]])
After that, commit and push the files that the converter edited. Note that, if you do not have push access to the main repository, you should let someone else update the submodule itself.

===Getting Art Content Into The Game (obsolete)===
* Post [CPT] or [WIP] art on the [http://forums.themanaworld.org/viewforum.php?f=8 graphics development forum].
* Work with the Art Director and collaborators on getting the art consistent.
* When finished, edit topic as [FND].
* Art Director approves [FND] art and marks it [RC]. Should the art need animation or special effect, the Art Director requests xml for it. If not, the Art Director commits it and marks as [GIT].
* XML Team reviews or drafts xml related to the art, then commits the .png and .xml. Topic can be marked as [GIT].
::* Art content affected: client-data/graphics/sprites then related directory for .png and .xml animation addition.
* Project developer requests database entry reservations from a General Content Team developer.
::* Map entry server data affected: resnametable.txt and .wlk files in the data directory, map content files in the npc directory.
::* Map entry client data affected: .tmx files in the maps directory.
::* Map entry requires the running of the .tmx converter (aka java converter) before commits can be made.
::* Art content server data affected: entry made in the item_db.txt, mob_db.txt or mob_skills_db.txt in the db directory.
::* Art content client data affected: entry added in items.xml, monsters.xml or other identification file.

====Handling General Content Team [REQ]s (obsolete)====
* General Content Team member adds a [REQ] topic to the graphics development forum.
* General Content Team member adds the [REQ] topic as a hyperlink under "Required Art" on the [[Art in Development]] page.
* Art Director attempts to network with other artists to assign the art to an artist.

===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.

[[Dev:Bit_mask_tutorial]]

===Generating client updates===
* Shutdown all your servers.

* First we are going to check the config files to be sure the paths are correct.
cd /evol-all/tools/update/
ls

Output:
addmods.sh adler32.c commit.txt createnew.sh musiccommit.txt update_music.sh
adler32 commit_old.txt create_music.sh files news.txt update.sh End of output

* The easiest solution is to create a symbolic link to that directory
ln -s <Path to Public Webserver Dir> /evol-all/tools/update/upload/

example: ln -s /var/www/updates /evol-all/tools/update/upload/

*Save the file and get back in the terminal.
edit /evol-all/server-data/conf/import/login-server.conf

Change update_server to reflect the hostname & location of the server updates.

TMW's test-server example:
<code>update_server: "http://updates.themanaworld.org/test-updates/"</code>

* Now we can make us a update.
cd /evol-all/server-data/
make updates

* Each time you want to make new updates
make sure you have a new commit then
cd /evol-all/server-data/
make updates

==Instructions for old EAthena server (obsolete)==
'''For Windows 7, Windows 8, Windows 8.1 or Windows 10, [[Dev:Windows10|click here]].'''

We're using Git as version control system for our source files and content. Have a look at our [[Working With Git|Tutorial]] about how to use Git.

===Set Up===
This is a how to help content development for official server (tmwAthena) using Ubuntu 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 (tmwa-client-data), server-data (tmwa-server-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.

====Install Dependencies====
''' [https://www.debian.org/ Debian] derivates (including [http://www.ubuntu.com/ Ubuntu])'''
* Open a terminal.
sudo apt-get install g++ python make realpath git zlib1g-dev

''' [https://fedoraproject.org/ Fedora] derivates'''
* Open a terminal.
sudo yum install gcc-c++ make git zlib1g-dev

Note that you must have gcc 4.6 or later. Any modern distro will have this version, but "stable" distros with very long release cycles, such as Red Hat Enterprise Linux, might not.

====Set Up Own Server====
'''Here are the steps to use when creating a new local testing server.'''
* Open a terminal.
mkdir ~/tmwAthena
cd ~/tmwAthena/
git clone --recursive git://github.com/themanaworld/tmwa.git
git clone --recursive git://github.com/themanaworld/tmwa-server-data.git
cd tmwa/
echo "export PATH=$PATH:~/bin" >> ~/.bashrc
source ~/.bashrc
./configure --user
make
make install
git config --global url.git@github.com:.pushInsteadOf git://github.com ''{{ref|push}} {{ref|once}}''
cd ../tmwa-server-data
make conf
* Preferably, add the update hooks.
ln -s ../../git/hooks/post-merge .git/hooks/
ln -s ../../../../git/hooks/post-merge .git/modules/client-data/hooks/ # ''(git 1.7.8 or newer)''
ln -s ../../../git/hooks/post-merge client-data/.git/hooks/ # ''(git 1.7.7 or older)''
cd client-data
git checkout master
cd music
git checkout master

====Hosting Updates====
TMW makes it easy to generate delta zips out of a repository, once it is initially set up.

It will put them in ~/www/updates/, which may be a symlink to wherever your web server is really serving. Setting up a webserver is not covered here.

Once everything is set up, just run 'make updates' from the server-data dir every time client-data changes. It will do nothing if appropriate, generate complete zips the first time, and incremental zips afterwards.

Some notes:
* You must put news.txt and skeleton resources.xml file (and maybe an empty resources2.txt) in ~/www/updates/ first.
* Music updates are never added; they should be in the skeleton and updated manually if needed.
* You definitely want to run one of the analyzer scripts frequently, and remove the old updates.

====Updating the Server====

==== Running and Administrating the Server ====

The TMWAthena is in fact 3 servers:
* '''tmwa-login''' which manages accounts and connection to char server.
* '''tmwa-char''' which manages characters and connects them to the map server.
* '''tmwa-map''' which manages game content (maps, monsters, items, scripts...) and their interaction with characters

* Start the servers: Open a terminal and run all the local servers. To stop them, either close the terminal or type control-C.
cd ~/tmwAthena/tmwa-server-data/
./run-all
* In a new terminal, Launch '''tmwa-admin''' the administration tool, add yourself as an user and make yourself a GM:
cd ~/tmwAthena/tmwa-server-data/login
tmwa-admin
add <username> M <password>
gm <username> 99

'''Note''' : Be sure that you are running tmwa-admin from within the "login/" directory. Check that the config files are correct: the connection port should be 6901 for tmwa's configuration, not 6900, which is the hard-coded default.

'''See also:''' [[GM Commands]]

==== Connecting ====
# Open a command line terminal and run your client pointing to your client data and your local server :
manaplus --server localhost --port 6901 -u -d ~/tmwAthena/tmwa-server-data/client-data

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

==== develop new content====
'''You are now free to do some changes, first close the client and your servers.'''

'''''Notes for client data changes: 1) commit and push them in the client-data repo 2) commit and push "client-data" when it shows "(new commits)" in your server-data 3) commit and push other server data changes.'''''
* Make your modifications (e.g. Change a map) and save them.
* Open a terminal.
cd ~/tmwAthena/tmwa-server-data/client-data''
git status''
git add [modified files]''
git commit''
git push'' {{note|push}}
cd ..
make maps ''(if you changed a map)''
git status
git add [modified files]
git add client-data (if ''git status'' shows ''(new commits)''. '''Don't do this if you don't have push access to client-data!''')
git commit
git push {{note|push}}
* Close the terminal.

{{note|push}} : a step for those with commit access to the remote repositories. For others, you don't need to reconfigure your clone and please make a patch on steps where ''git push'' is suggested.

{{note|once}} : you only need to do this once, no matter how many times you independently clone the repositories.

git format-patch -M -C origin/master
* pastebin the patch(es) and post for review at irc.freenode.net channel: #evol-dev or on our [http://forums.themanaworld.org/viewforum.php?f=18 development forums]. '''Extensive patches must be posted on the forum as a series of well-formed patches with descriptive commit messages.''' In particular, later patches should not fix errors introduced in earlier patches, and each patch should form a logically independent part.

 '''Note :''' This is kind of outdated; with github it's often easier to do patches on branches there. see: '''[[Working With Git]]''' page

'''You can also pull the data which has been modified.'''
* Open a terminal.
cd ~/tmwAthena/tmwa-server-data
git pull
* If you haven't installed the hook,
git submodule update --merge ''at toplevel (for client-data) and in client-data (for music)''
* Close the terminal.

'''See Also:''' [http://wiki.themanaworld.org/images/3/33/README.mv.txt README.mv.txt] - Documentation on using git submodules, like client-data and tmw-music.

[[Category:Development]]

2020-06-24T19:17:26Z

Aeuda:

Classic:Alacrius' Riddle

2020-06-24T19:14:38Z

Aeuda:

Classic:Milly's Hero

2020-06-24T19:03:32Z

Aeuda: looked at this for reference and decided to fix some links to point to Legacy

{{Meta}}{{I18n}}
{{Category Legacyplayerinfo}}
{{Status green}}

{{Quest
| Image = [[Image:NPCMilly.png]]
| Start = 009-1, 81, 44.
| Level = 60 (recommended)
| Prerequisites = Various quests 5,000 [[Legacy:Boss Points|Boss Points]]
| Redoable = No, only once
| Reward = Beanie Copter Hat
| Cost = None
}}

== Background Story ==
Milly is a young girl who lives in [[Legacy:Hurnscald|Hurnscald]]. She has been listening to [[Legacy:Kfahr|Kfahr]]'s Stories again and again. She is fascinated by his amazing stories and by his toughness. She has made [[Legacy:Kfahr|Kfahr]] her hero, but then she meets you...

== Walkthrough ==

Milly doesn't ask you anything special, she just suggests that you complete the quests that can show her that you are a generous person and better skilled than [[Legacy:Kfahr|Kfahr]].

=== What To Do: ===

* Milly tells you what to do, just visit her while you progress to know how highly she considers you. However if you are really stuck, or really want to cheat, you will find the quest list below.

{| class="wikitable mw-collapsible mw-collapsed"
|-
!Spoiler
|-
|'''Prerequisites:'''
* [[Legacy:Bone Knife Quest|Bone Knife Quest]], you must have bone knife with you and show it to Milly.
* [[Legacy:Setzer Quest|Setzer Quest]], you must have a [[Legacy:Setzer|Setzer]] with you and show it to Milly.
* [[Legacy:Rossy Quest|Rossy Quest]]
* [[Legacy:Angela's Daughter|Angela's Daughter]]
* You also must get 5,000 [[Legacy:Boss Points|Boss Points]], which you can mostly get at [[Legacy:Candor Island|Candor]] - they are not taken away from you when doing this quest, but are needed to show your hero qualities.
|}

=== Hints===

* Milly is a just a child. Maybe you could find some children to help ;)
* Considering she is a child, there is nothing to gain by being nasty to her.
* Milly appreciates modesty, so consider this in how you answer her.
* Show her that you are a real Hero!

'''Reward:'''

* 1 [[Legacy:Beanie Copter]]; Defense +4, Magic Attack +2, Weight 20 g.

{| cellpadding="20"
|-
| [[File:Armor-head-beaniecopter.png]]
|-
|}

'''Total Cost:'''

None (the 5,000 [[Legacy:Boss Points|Boss Points]] are not taken away from you, they are just a requirement).
[[Category:Legacy]]
[[Category:Legacy]]

Classic:Alacrius' Riddle

2020-06-24T18:57:06Z

Aeuda:

Classic:Alacrius' Riddle

2020-06-24T18:53:13Z

Aeuda: Created page with "{{Meta}}{{I18n}} {{Status Under Construction|Some of the links may not work. These will be fixed shortly.}} {{Category Legacyplayerinfo}} {{Quest |Image = Image:Tre..."