MapleSim - Home of BannedStory

Adding Custom Items

After you had made your custom item, you are now ready to add it to BannedStory. Follow these steps in order to add your custom item in BannedStory.

BannedStory 3.0 custom items are now installed in a more simple way than in previous versions. You can now have you custom item either in a zip file or in a regular folder. If you are planning to create a custom item using a folder, remember that it must be located inside the custom folder.

Place the custom item in the apropiate Custom folder

In the root folder of BannedStory, there should be a folder named "img". Inside of it you will find two folders: "custom" and "original". Both folders have the same structure (the same folder hierarchy). The one named "original" contains everything form the MapleStory clients, while the folder "custom" will hold all your custom items.

For this example, I will make a custom top for the character as a zip file. I will name it "custom_item". Remember that BannedStory 3.0 now supports custom items in regular folders, so this example could also be accomplished without using zip files:

In the path of the folder (the one that is inside a red box) you can see that the custom item was added in the Coat folder that appears under the Character folder, inside the custom folder. Remember that your custom item zip file or folder must be named as your custom item ID.

Add the thumbnail in the "thumbs" folder

Thumbnails in BannedStory 3.0 are way more easier to install than in previous versions. All you need to do is make a copy of you custom item thumbnail inside the "thumbs/custom" folder. That's it. All custom item thumbnails are stored inside that folder, regardless of the type of custom item.

Add the custom item in the custom xml list

The final step is to register your custom item in the custom xml list. The custom xml lists are located in the "dat" folder in the BannedStory root folder. All the xml files that are in that folder (character.xml, equip.xml, pet.xml, skill.xml) are the ones needed to add custom items. The ones that the original items use are inside the zip file there named "dat.zip". By any means try to make your own dat.zip, otherwise BannedStory will stop working.

Since I am adding a character custom item, I will need to modify the xml file named "equip". I will use XMLPad to add the custom item in the list.

When I open the equip.xml file in XMLPad, this is what appears:

Everthing that is inside the green box is just a comment. It is not relevant to this example. Since my custom item is a character top, I will locate the line that has the category "Top":

To insert the code of my custom item, I will add the following node between the > and </i> in the red colored line above:

The ID of my custom item goes in the "u" attribute. The other attributes are explained in the comment section (the green box above). Remember to add the slash (/) at the end of your custom item line.

Save the document, and you are done. The custom item is ready to be used!

Reference Manual

• What is BannedStory?
• System Requirements
• Installing BannedStory
• Uninstalling BannedStory
• Making Custom Skins
• Interface
• Startup Window
• Working Space
• Layer Manager Window
• Search Window
• Save Image Window
• Adobe JSX Code Window
• Sprite Sheet Window
• Items Windows
• Keyboard Shortcuts
• Custom Items
• About Custom Items
• Creating Custom Items
• Adding Custom Items