How to play around with TMW resource files

Content and general development discussion, including maps, quests, and server code from the development team.
User avatar
Crush
TMW Adviser
TMW Adviser
Posts: 8046
Joined: Thu Aug 25, 2005 5:08 pm
Location: Germany

How to play around with TMW resource files

Post by Crush » Wed Jun 06, 2007 5:56 pm

When you downloaded TMW as a prepacked install packet for your operating system it comes without most of the graphics, maps and so on. These are downloaded at the first start by the updater. Here I will explain you how to get these files so you can play around with them, customize TMW and maybe contribute to the development.

Method A: Unpack the updates
To use this method you just need a program that can unpack zip archives and no other tools. But you won't get the most recent development versions of the resource files but only those that have been released to the general public.

1. Update the mana world
Start tmw and let an updater run to ensure that you got the newest updates.

2. Locate the updates
The updates are stored in your user directory. For users of UNIX-like operating systems this should be usr/home/*your_username*/.mana/updates/updates.themanaworld.org. Windows users find their user directory in C:\Documents and Settings\*your_username*\AppData\Local\mana\updates\updates.themanaworld.org
("Documents and Settings" is called different on different language versions of windows and the appdata directory is hidden by default)

There you find all the updates you downloaded since you first installed tmw. When you are a long-time player, most of them will be obsolete. You can find a list of the updates that are actually used in the file resources.xml.

3. Unpack the updates
Unpack the zip archives listed in resources.xml into the subfolder "data" of your tmw installation (When there are any zip archives not listed in resources.xml in your update folder don't unpack those. They contain outdated files that have been replaced by later updates).

4. Tell TMW to ignore the updates and use the files in the data directory
To do so you have to start tmw with the additional command line parameter -u

Windows users can right-click on the tmw shortcut on their desktop and select Properties. In the field Target you find the path to your tmw executable in quotation marks. Add -u behind the quotation marks. It should now read something like that:
"D:\Programs\The Mana World\tmw.exe" -u

Method B: Use Git to get the latest developer versions of all files
This method should be prefered over the other because you will receive the most recent development versions of the files. But it requires you to install a new program.

1. Install Git
Git is a distributed, commandline-based sourcecode management tool which makes it easy to work with many people on a software project.
Most linux distributions should have Git in their packet management systems.
A windows version can be found here: http://code.google.com/p/msysgit/downloads/list

2. "clone" the git repository.
Open your command shell, browse to the directory where you would like to have the files and enter:
git clone git://gitorious.org/tmw/tmwa-client-data.git tmwdata
This will create a new folder "tmwdata" and download all the files here.

3. Tell TMW to ignore the updates and use the files in your new directory
To do so you have to start tmw with the additional command line parameters -u -d path/to/your/data/folder

Windows users can right-click on the tmw shortcut on their desktop and select Properties. In the field Target you find the path to your tmw executable in quotation marks. Add -u -d behind the quotation marks followed the folder where you cloned the git repository. It should now read something like that:
"D:\programs\The Mana World\tmw.exe" -u -d D:\tmw\data

4. Update the repository from time to time
To synchronize your local repository with the newest develpmont changes open your command shell, navigate to your tmw data folder and type:
git stash
git pull
git stash apply
You can skip stash and stash apply when you didn't change any files.



Now you can edit or replace all resource files of TMW like maps, graphics, sounds and the changes will be visible in the game. You can also change what file is used for what to some extend by editing the xml files in the data directory.

Happy Hacking



Too lazy to do all this just to get one file?
You can also browse the content repository online:
http://gitorious.org/tmw/tmwa-client-data/trees/master
  • former Manasource Programmer
  • former TMW Pixel artist
  • NOT a game master

Please do not send me any inquiries regarding player accounts on TMW.


You might have heard a certain rumor about me. This rumor is completely false. You might also have heard the other rumor about me. This rumor is 100% accurate.
User avatar
Tenche
Novice
Novice
Posts: 421
Joined: Tue Jun 14, 2005 9:21 pm
Location: Reston
Contact:

Post by Tenche » Tue Nov 20, 2007 2:23 pm

Their is no folder in my users/*name*/ directory...
and nothing comes up when I search for stuff.


I am using leopard but their should be no problem apple did not change directory paths.
Status_Lock
Peon
Peon
Posts: 2
Joined: Mon Dec 03, 2007 6:49 pm

Post by Status_Lock » Mon Dec 03, 2007 7:14 pm

Well i don't expect you to know what to do, unless you have a Mac yourself (ugh, damn computer) I guess the question i'm asking is, how do i unpack the files? I'm sure this would've been easier if there was a "resources2.txt" file, but i happen to not be able to find it.
User avatar
Cosmostrator
Novice
Novice
Posts: 132
Joined: Wed Aug 23, 2006 7:13 am
Location: USA - So. Cal

Post by Cosmostrator » Wed Dec 05, 2007 8:42 am

The user folder for TMW is hidden in OSX. To see it you have to make hidden files visible.
Open the application Terminal and enter the following code

Code: Select all

defaults write com.apple.finder AppleShowAllFiles TRUE

killall Finder 
The open your home folder and look for the folder called .TMW

When you are done you can re-hide hidden files by putting the following code into Terminal

Code: Select all

defaults write com.apple.finder AppleShowAllFiles FALSE

killall Finder
Hope this helps-
-Cosmostrator
User avatar
Saphy
Novice
Novice
Posts: 371
Joined: Thu Nov 09, 2006 7:32 pm

Post by Saphy » Thu Dec 06, 2007 3:24 am

Or you can just use xterm and command line on OSX :p
User avatar
Tenche
Novice
Novice
Posts: 421
Joined: Tue Jun 14, 2005 9:21 pm
Location: Reston
Contact:

Post by Tenche » Mon Dec 24, 2007 4:42 pm

I have a mac....
Vink
Novice
Novice
Posts: 365
Joined: Wed Mar 05, 2008 11:21 am
Location: Sweden

Re: How to play around with TMW resource files

Post by Vink » Fri May 16, 2008 8:33 pm

I think I found another way to do it, and then you don't need to run tmw with -u, I believe:

1. Find the zipfile with the file you wish to edit.
2. Unpack it to somewhere convenient..
3. Edit the file according to your wishes.
4. Make a new zipfile and give it the same name as the original zipfile.
5. Replace the original zipfile with the one with your edited file.

Since I'm not used to these things, I assume there must be some problem with this method? Please tell me. :)
User avatar
Crush
TMW Adviser
TMW Adviser
Posts: 8046
Joined: Thu Aug 25, 2005 5:08 pm
Location: Germany

Re: How to play around with TMW resource files

Post by Crush » Fri May 16, 2008 8:37 pm

The problem with this is that the updater will realize that the checksum of the update is wrong, assume that it is corrupted and redownload it.
  • former Manasource Programmer
  • former TMW Pixel artist
  • NOT a game master

Please do not send me any inquiries regarding player accounts on TMW.


You might have heard a certain rumor about me. This rumor is completely false. You might also have heard the other rumor about me. This rumor is 100% accurate.
Vink
Novice
Novice
Posts: 365
Joined: Wed Mar 05, 2008 11:21 am
Location: Sweden

Re: How to play around with TMW resource files

Post by Vink » Fri May 16, 2008 8:38 pm

Hm... Then why did it work when I tried it? :?
User avatar
Crush
TMW Adviser
TMW Adviser
Posts: 8046
Joined: Thu Aug 25, 2005 5:08 pm
Location: Germany

Re: How to play around with TMW resource files

Post by Crush » Fri May 16, 2008 8:50 pm

Did you cancle the updater before it finished?
  • former Manasource Programmer
  • former TMW Pixel artist
  • NOT a game master

Please do not send me any inquiries regarding player accounts on TMW.


You might have heard a certain rumor about me. This rumor is completely false. You might also have heard the other rumor about me. This rumor is 100% accurate.
User avatar
Jaxad0127
TMW Adviser
TMW Adviser
Posts: 4209
Joined: Thu Nov 01, 2007 6:35 pm
Location: Internet

Re: How to play around with TMW resource files

Post by Jaxad0127 » Fri May 16, 2008 9:03 pm

He used the "-u" option which bypasses the updater.
Image
Hexico
Peon
Peon
Posts: 27
Joined: Wed May 14, 2008 4:12 am

Re: How to play around with TMW resource files

Post by Hexico » Sat May 17, 2008 1:05 am

So.. hm. If I wanted to play around with this, would I just download another client? And try to keep this one seperate from the one I currently use?

I'm interested in just changing the graphics around a little bit so I can wear custom hats and such.. Even if no one else can see it..
Vink
Novice
Novice
Posts: 365
Joined: Wed Mar 05, 2008 11:21 am
Location: Sweden

Re: How to play around with TMW resource files

Post by Vink » Sat May 17, 2008 1:17 am

No, I don't think I cancelled, and I don't think I used -u.
User avatar
Jaxad0127
TMW Adviser
TMW Adviser
Posts: 4209
Joined: Thu Nov 01, 2007 6:35 pm
Location: Internet

Re: How to play around with TMW resource files

Post by Jaxad0127 » Sat May 17, 2008 4:28 am

The preferred way is to use the customData directory.
Image
passipoliisi
Peon
Peon
Posts: 7
Joined: Sun Aug 10, 2008 4:38 pm

Re: How to play around with TMW resource files

Post by passipoliisi » Tue Aug 12, 2008 1:54 pm

How can i put the updates to a localhost server??
Post Reply