Welcome!

Join our community of MMO enthusiasts and game developers! By registering, you'll gain access to discussions on the latest developments in MMO server files and collaborate with like-minded individuals. Join us today and unlock the potential of MMO server development!

Join Today!

WZ [Tutorial] Wz Editing Concepts and Tutorial

Status
Not open for further replies.
<3
Joined
Feb 4, 2011
Messages
481
Reaction score
123
This is copy and pasted from my other post elsewhere. I thought you guys would need this, seeing how bare the wz section is. :(

Hello,

So from what I have seen in the recruitment section, a lot of you are recruiting Wz editors. I feel that is quite unnecessary, and I have said that I'd write a tutorial for those that need help. I got a PM asking to do so. Seeing as people would appreciate, and learn from this, I decided to write it. So let's get started. :D

Basic Requirements:
.NET Frameworks 3.0
.NET Frameworks 3.5
.NET Frameworks 4.0 (for HaCreator 2 and HaRepacker v4.0)
Previous version of .NET Frameworks
HEX Editor (only needed if you are importing custom songs)
Audacity (only needed if you are importing custom songs)

Note: All of the .NET Frameworks are pre-installed with Windows 7 except for .NET Frameworks 4.0. Also, without having these basic requirements, you will encounter exceptions upon saving or other basic tasks.

Part 1: Introduction to Wz Editing Concepts:

What is wz editing?

Wz editing refers to the modification of the Wizet Files, used by MapleStory. These files contain a variety of information about the game.

What are the limitations to wz editing?

Not everything is handled by the wz. Wz editing cannot be completely relied on, because a lot of things are client-based, so it would require more than wz edits. An example would be custom jobs. It is simply not possible without recreating a new client, or having the source code of the MapleStory client.

But... I saw EloquentMS, they got Demon Slayers?

They aren't exactly Demon Slayers. They are known as skill covers to wz editors, and to the community. Skill covers refer to the covering of a skill. This is done by changing each frame of a skill animation. Sometimes, a movement is added and/or replaced in Character.wz.

How do I start with wz editing?

You require a wz repacker or map editor depending on what you are doing. If you are doing general wz edits (anything but map creating or map editing), use HaRepacker. If you are doing map editing or creating maps, use HaCreator or Koolk's Map Editor. I have placed the downloads below.

HaRepacker 3.5:
HaCreator:
Koolk's Map Editor:

There are newer versions (v4.0 HaRepacker, and HaCreator 2.0), but I wouldn't recommend them since they are quite buggy.

Okay. I got HaRepacker, and/or HaCreator. What do I do with encryption?

Assuming that you are using GMS, just leave the encryption as GMS. If you are using a different version such as JMS (Japanese MapleStory), KMS (Korean MapleStory), CMS (China MapleStory), ThMS (Thailand MapleStory), TWMS (TaiwanMS), or BETA MapleStory (GMS), select EMS/MSEA.

Now, that you understand the basic concepts. Let's get started with looking at HaRepacker.

Importing & Dumping:
This is the first step into wz editing. This is a very important step, no matter where you are with wz editing. Dumping and importing are fundamental.
Everytime, you make a change in an image or add a new map or XML. You must dump and import. I am sure you are wondering what does dumping mean. Dumping refers to pretty much an extraction of a wz property out as an XML.

How to Dump XMLs:

Dynamik - [Tutorial] Wz Editing Concepts and Tutorial - RaGEZONE Forums


Dynamik - [Tutorial] Wz Editing Concepts and Tutorial - RaGEZONE Forums


How to use Multi-Dump:

Dynamik - [Tutorial] Wz Editing Concepts and Tutorial - RaGEZONE Forums


There are two forms of XMLs, compressed and non-compressed. The XMLs in your wz folder are compressed. I highly recommend dumping compressed XMLs for server directory. It will save time for dumping. When importing, you must import a non-compressed XML.

Importing is the next part that you'll need. Whenever you dump out the new content, you must drop the compressed XMLs into your server directory. And you must import the non-compressed XMLs into your wz files as shown.

How to import

Dynamik - [Tutorial] Wz Editing Concepts and Tutorial - RaGEZONE Forums


Dynamik - [Tutorial] Wz Editing Concepts and Tutorial - RaGEZONE Forums


General Guideline to Wz Files

Character.wz - contains information regarding character, such as equipment, mounts, skin tone, hair, eyes, etc (Equipment, and CASH item)

Map.wz - contains information regarding maps, contains a few parts of the login screen

Mob.wz - contains information regarding monsters

Item.wz - contains information about chairs, potions, and other items (USE or etc)

Skill.wz - contains information about skills

Effect.wz - contains effects throughout the game (map effects, item effects)

Reactor.wz - contains reactor information

Npc.wz - contains information about the NPC (their speech bubble, what they say,etc)

Quest.wz - contains informations about the quests

String.wz - contains the string (names) of everything (maps, mobs, NPC, item names)

Sound.wz - contains all sounds

Base.wz - basically a checklist for Nexon to know what they are doing (pointless to edit)

TamingMob.wz - contains some information about some of the mounts (contains only a few entries, similar to what Base.wz is for, quite pointless to edit)

UI.wz - UI stands for User Interface, it contains menus and buttons (login buttons, frame, and signboard is found in there)

Etc.wz - contains miscellaneous information, contains some information about default equipment, ForbiddenName (swear words, derogatory terms, world names, GM)

Properties

Dynamik - [Tutorial] Wz Editing Concepts and Tutorial - RaGEZONE Forums


Strings

Strings (from programming) is a sequence of characters. In this case, strings are used to identify the names of items, maps, mobs, NPCs, etc. If you are disconnecting after importing your maps, mobs, or NPCs, it could be due to the fact that it is missing strings. Not everything requires strings. These would be chairs, mounts, and hairstyles. However, I'd recommend having strings, so it'd be helpful for your players to identify the items, and you could also find the items using your search function or a WZ-based GM handbook.

Origins:

There are various ways to find origins. There are three values when it comes to origins. Usually, it only involves two, they are x and y. This is very similar to math with the x and y coordinate system. X would be horizontal, and Y would be vertical. Now, I am sure you are wondering what the heck is the third value. The third value is called z. It is used for values like weaponOverHand, or weaponBelowArm. For future references on what requires a z-value, please refer to Base.wz, under the XML, zmap.img. I am personally a bit lazy, so I guess I will show you guys the shortcuts on finding origins. These shortcuts may sometimes be inaccurate. So you'll have to learn to tweak the origins accordingly.

Hair Origin Finder:
Chair Origin Finder:

These are just some programs to assist you on finding the origins. For some situations, you will have to guess and check it. And for other situations, the origin would be the bottom middle pixel of your image.

This tutorial is incomplete, more shall be here soon, and more details will be added if needed. I will write as much as I know about wz editing. :)
 
Last edited:
Newbie Spellweaver
Joined
May 1, 2008
Messages
55
Reaction score
1
Can you explain the values in Map.wz?
<imgdir name="back">
<imgdir name="0">
<string name="bS" value="" />
<int name="front" value="0" />
<int name="ani" value="0" />
<int name="no" value="0" />
<int name="x" value="0" />
<int name="y" value="0" />
<int name="rx" value="0" />
<int name="ry" value="0" />
<int name="type" value="0" />
<int name="cx" value="0" />
<int name="cy" value="0" />
<int name="a" value="255" />
<int name="f" value="0" />

especially the rx, ry, cx ,cy
 

Rey

The Shrewd
Loyal Member
Joined
Oct 29, 2011
Messages
1,336
Reaction score
196
reupload chair origin finder please !
 
<3
Joined
Feb 4, 2011
Messages
481
Reaction score
123
It is not broken. Works perfectly fine. Try again.
 
Newbie Spellweaver
Joined
Oct 30, 2011
Messages
8
Reaction score
1
What happens if the encryptions between where you're importing and exporting are different? Right now i'm trying to dump a v130 item into a v83 character wz and it's not going through.
 
<3
Joined
Feb 4, 2011
Messages
481
Reaction score
123
What happens if the encryptions between where you're importing and exporting are different? Right now i'm trying to dump a v130 item into a v83 character wz and it's not going through.

Well to read off anything at v117 and above, you must use BMS encryption (on the old HaRepacker) or GMS (new) on the new HaRepacker 4.2.3. And to read off the v83 wz, you'd select GMS on the old HaRepacker or GMS (old) on HaRepacker 4.2.3. Everything else is just like normal. Typical dumping and importing.
 
Newbie Spellweaver
Joined
Oct 30, 2011
Messages
8
Reaction score
1
I can read it, but i can't transfer the items. When i try, it just shows the item ID and nothing else, even when i try expanding the (i forgot what the thing was called oops) :( It shows up when i copy & paste but after i save it, they disappear. Thanks for the response though im like spazzing right now

also this is what happens when i try putting it in bms format on the old harepacker. It shows up on 4.2.3 but the xmls aren't transferable. I've been trying to do this for the past 4 days :( Thanks in advance!
 
<3
Joined
Feb 4, 2011
Messages
481
Reaction score
123
I can read it, but i can't transfer the items. When i try, it just shows the item ID and nothing else, even when i try expanding the (i forgot what the thing was called oops) :( It shows up when i copy & paste but after i save it, they disappear. Thanks for the response though im like spazzing right now

also this is what happens when i try putting it in bms format on the old harepacker. It shows up on 4.2.3 but the xmls aren't transferable. I've been trying to do this for the past 4 days :( Thanks in advance!

Hm, that's really odd. I will try looking into it for you since I am on my Spring Break. Need to redownload GMS. After that, I will test it out for you. Expect a response in a day or two.
 
Newbie Spellweaver
Joined
Oct 30, 2011
Messages
8
Reaction score
1
It's alright, i had a friend do it for me. Thanks anyway for the help! :)
 
Newbie Spellweaver
Joined
May 26, 2013
Messages
23
Reaction score
0
when i download HaRepacker 3.5 my antivirus tells me theres 2 trojans or virus, should i just ignore that or ?
 
Newbie Spellweaver
Joined
Aug 7, 2016
Messages
5
Reaction score
0
ND1oAXT - [Tutorial] Wz Editing Concepts and Tutorial - RaGEZONE Forums

I need to turn these words into other languages for my server! But I do not know where to find it in wz. Someone help me please !
Sorry my English !!!!
 

Attachments

You must be registered for see attachments list
Status
Not open for further replies.
Back
Top