[Guide] Adding Custom Items (no weapon/mob) for Clients 2012-04-10 and similar

[Kido]

Hello, first of all, this Guide was requested by a friend of mine, there's an already existing guide in the Wiki http://rathena.org/wiki/Custom_Items and it's more detailed, you may use it as reference

 

Remember that this Guide is for 2012-04-10 clients and simillar!

 

Before starting, you will need the following Diffs at least (recommended):

• Uncheck "read data folder first" so it will read first your GRFs
• Uncheck "load lua before lub" if you have .lua i recommend you to change them all to .lub
• Checked "Increase Item View ID" (i recommend 15,000 View IDs, max 30,000)
• Checked "Read multiple GRF" (i recommend max 2 custom GRFs)

Also, make sure that your DATA.INI reads your GRFs

 

This Guide doesn't use iteminfo.lub, just lua files

 

Requeriments

Text files:

• idnum2itemdisplaynametable.txt file (located inside data folder)
• idnum2itemdesctable.txt file (located inside data folder)
• idnum2itemresnametable.txt file (located inside data folder)
• num2itemdisplaynametable.txt file (located inside data folder)
• num2itemdesctable.txt file (located inside data folder)
• num2itemresnametable.txt file (located inside data folder)
• itemslotcounttable.txt file (located inside data folder)
• accessoryid.lub file (located in data/luafiles514/lua files/datainfo/ )
• accname.lub file (located in data/luafiles514/lua files/datainfo/ )
• item_db.txt (used to be item_db2.txt )file (located in trunk/db/import/ )

Tools that we will use:

• WinSCP (in my own personal and experienced opinion, much better than File Zilla)
  Note: i don't know/remember if it's allowed to put a link to download 3rd party software, so just google it, the icon is like this:
  
  
  
  

• GRF Editor (in my own personal and experienced opinion, much better than GRF Tool/Builder)) http://rathena.org/board/files/file/2766-grf-editor/

.sprt & .act files:

• This Guide is mean to add Armors and Headgears, for Weapons it's a different guide
• This Guide is not mean to teach how to do .spr & .act files, you should already have them; that would be another guide

Locations to add the .sprt & .act files:

• data/sprite/¾ÆÀÌÅÛ ( data/sprite/아이템 ) this is what will displayed when the item is dropped at the floor
• data/sprite/¾Ç¼¼»ç¸®/³² ( data/sprite/악세사리/남 ) this is what will be displayed when the item is equiped by a male character, only headgears (also weapons but that's another guide)
• data/sprite/¾Ç¼¼»ç¸®/¿© (data/sprite/악세사리/여 ) this is what will be displayed when the item is equiped by a female character, only headgears (also weapons but that's another guide)
• data/texture/À¯ÀúÀÎÅÍÆäÀ̽º/item ( data/texture/유저인터페이스/item ) this is what the item will look like when it's in the inventory and also equped in Alt+Q
• data/texture/À¯ÀúÀÎÅÍÆäÀ̽º/collection ( data/texture/유저인터페이스/collection ) this is what it will be displayed when right-clicking the item

For this guide, we will be adding a Nekoring Hat, a pretty cool free released by Adel

• Her post http://rathena.org/board/topic/54080-c-o-l-l-e-c-t-i-o-n-adels-sprites/?hl=aquaring
• You will find the link to download the Nekoring Hat in her post

Alright, with everything ready we can start now!

Adding the items | Text File Side

In this Guide we won't be adding custom items that will be droped by mobs. If you want to add custom items that will be droped by mobs you must open the num2itemdesctable.txt, num2itemdisplaynametable.txt and num2itemresnametable.txt files and add there the same as below. The name of the item that will go inside the text files must be the same name of the .spr & .act files, except the ones that differs when equipped by male and female characters ( which starts like ³²_name.spr & ³²_name.act | ¿©_name.spr & ¿©_name.act ). For this item we will be using the ID number 22024 and ViewID 960

 

I recommend to first do the item_db.txt line so you can easly set the rest inside the text files, for this example we are going to use this one:

22024,nekoring_hat,nekoring_hat,4,,,0,,0,,1,0xFFFFFFFF,7,2,256,,1,1,960,{ bonus bAgi,3; bonus bFlee,2; bonus bAspdRate,1; },{ },{ }

Reference (check this before doint the item inside trunk/db/import/item_db.txt:

• Syntaxys http://rathena.org/wiki/Custom_Items#Structure
• ViewID http://rathena.org/wiki/Custom_Items#View_IDs.2C_Having_A_Custom_Headgear_Without_Xray
• Bonus Script https://github.com/rathena/rathena/blob/master/doc/item_bonus.txt

 

Step 1:

• Open data/idnum2itemdisplaynametable.txt and add inside ID#name_of_the_item#

22024#nekoring_hat#

Step 2:

• Open data/idnum2itemdesctable.txt and add inside ID#<Enter>Description<Enter>#

22024#
A cute Nekoring Hat that increases your cuteness by 1000%!
•AGi + 3
•Flee + 2
•ASPD + 1%
#

Step 3:

• Open data/idnum2itemresnametable.txt and add inside ID#item_name#

22024#nekoring_hat#

Step 4 (in our example it has 1 slot, if your item doesn't has any slot then you can skip this step:

• Open data/itemslotcounttable.txt  and add inside ID#NumberOfSlots#

22024#1#

Step 5:

• Open data/luafiles514/lua files/datainfo/accessoryid.lub and add before the } ACCESSORY_Item_Name = ID,

ACCESSORY_Nekoring_Hat = 960,
}

Step 6:

• Open data/luafiles514/lua files/datainfo/accname.lub and add before the }  [ACCESSORY_IDs.ACCESSORY_Item_Name] = "_item_name",

[ACCESSORY_IDs.ACCESSORY_Nekoring_Hat] = "_nekoring_hat",
}

We are done for the Text Files part, now we go ahead to add the .spr, .act & .bmp files

Adding the items | Sprite Side

Step 1:

Open data/sprite/¾ÆÀÌÅÛ ( data/sprite/아이템 ) and drop there:

• nekoring_hat.act
• nekoring_hat.spr

Step 2:

Open data/sprite/¾Ç¼¼»ç¸®/³² ( data/sprite/악세사리/남 ) and drop there:

• ³²_nekoring_hat.act
• ³²_nekoring_hat.spr

Step 3:

Open data/sprite/¾Ç¼¼»ç¸®/¿© ( data/sprite/악세사리/여 ) and drop there:

• ¿©_nekoring_hat.act
• ¿©_nekoring_hat.spr

Step 4:

Open data/texture/À¯ÀúÀÎÅÍÆäÀ̽º/item ( data/texture/유저인터페이스/item ) and drop there:

• nekoring_hat.bmp

Step 5:

Open data/texture/À¯ÀúÀÎÅÍÆäÀ̽º/collection ( data/texture/유저인터페이스/collection ) and drop there:

• nekoring_hat.bmp

We are done for the .spr, .act & .bmp files

 

And that's it, if you follow this Guide step by step without skipping the notes and so on you shouldn't have any error.

 

If you are stuck or soemthing don't pm me D: just repply to this post. You may ask why, well the answer is simeple, you should repply to this post first so if someone has the same error, problem or got stucked like you it may find the answer here.

 

This is really easy to do, it's about practice and you will do it automaticlly with the time. I can add 1 single custom item in about 2 minutes with everything ready to add. 

 

Well, good luck!

 

FAQs:

Q: Why it's better to use .lub instead of .lua?
​A: Because .lub files can be encrypted and because most fot he clients already reads .lub by deffault

http://rathena.org/board/topic/81439-lua-lub-files-oo/?p=193536

Q: How do i convert all .lua files to .lub at once?

A: There are some converters pretty useful. You may download the .lub files

here http://www.supportmii.com/ro1/Clients/Judas_Setups/RecommendSetup/Lubs0410.7z (thanks to Judas!)

If you already have some custom items in your .lua files, i recommend you to use a converter, there are some in rAthena or just try to google it.

 

Q: I have a lot of Custom Items to implement, how much this will take me to add them?

A: It depends how fast you can add them with practice you should be able to do it pretty fast since it's really easy. My first time adding Custom Items in this way took me around 10 min. because i had to check everything again again and again xD so don't worry if it takes you some time, just with practice you will be able to it pretty fast.

 

Q: Does other server owners will be able to see my .lua/.lub files?

A: Yeah, unless you encrypt them with a software.

 

Q: I'll have to convert them to .lua files again everytime i need to make new custom items?

A: Nope, once you convert your .lua to .lub you won't need to convert them back to .lua (for what i know)

To do:

• Fix some (many) grammar mistakes X
• Add colors ✓ (done)
• Add FAQs ✓

[Fluffle Puff]

Best guide of adding item custom ever (:

[Kido]

Best guide of adding item custom ever (:

 

Thanks! i will fix those grammar errors for sure haha hope you like it o:!

[elcontrol00]

One of the best guides i've seen so far regarding Custom items +1 Keep it up

[Kido]

One of the best guides i've seen so far regarding Custom items +1 Keep it up

 

Thank you o: any suggestions for improvement are very really much a lot welcom ;D!

[BavariaN]

I try to use this guide but when everything is ok 

i use @item 25000 [25000 is the id of my custom item]

But something happened.

 

 

How to fix this .. pLease Help ! 

[Kido]

I try to use this guide but when everything is ok 

i use @item 25000 [25000 is the id of my custom item]

But something happened.

How to fix this .. pLease Help ! 

 

I'm pretty sure you made a mistake in the steps of the guide, please post your files that show the item you are trying to add.

 

[mrlongshen]

can you make a tutorial for 2013 client ? forgot already

[Kido]

can you make a tutorial for 2013 client ? forgot already

 

i don't liek that client, nothing personal agains it or anyone lol, i don't know how to use it or to set it up

 

if someone teaches me i will make the guide ;o

[mrlongshen]

 

can you make a tutorial for 2013 client ? forgot already

 

i don't liek that client, nothing personal agains it or anyone lol, i don't know how to use it or to set it up

 

if someone teaches me i will make the guide ;o

 

 

aw.. why you dont like ? its good lorr. hahaha. 

[jTynne]

Excellent guide!

[Kido]

 

 

can you make a tutorial for 2013 client ? forgot already

 

i don't liek that client, nothing personal agains it or anyone lol, i don't know how to use it or to set it up

 

if someone teaches me i will make the guide ;o

 

 

aw.. why you dont like ? its good lorr. hahaha. 

 

 

i know it's a good client, my problem is that i can't set it up properly, i followed the steps, i think i did mistakes in the diff, the guide should say which diffs are must to make it work. Sorry for the late repply D:

 

Excellent guide!

 

Thank you, it took me sometime, i'm glad you guys like it :DD

[seifman123]

best guide ever

[Kido]

best guide ever

 

Thank you

[seifman123]

add me

how   to fix that ?


it says unknow item and now collecton or item pic  just an apple pic
any help

Kido kido  any help ??

[Kido]

 

add me

how   to fix that ?

it says unknow item and now collecton or item pic  just an apple pic

any help

Kido kido  any help ??

 

 

Make sure that you have done the steps correctly, check your text files, if you don't have any lub or lua problems then it's more like you mispelled the name of the item in your text files o: if you can show me any pic. that would be of help o:

[seifman123]

pic for what ? can u explain what shoul i picture for u ?

[Kido]

pic for what ? can u explain what shoul i picture for u ?

the error you are having with it D:

 

or the text files of the items you are going to add

 

remember that the name of the item must be the same of the name of the sprite

[seifman123]

i know all of that and  its not an error its just that the item's description and name is "unknown" and its collection pic is apple  

i wil  try to redo all of that tomorrow

[Kido]

i know all of that and  its not an error its just that the item's description and name is "unknown" and its collection pic is apple  

i wil  try to redo all of that tomorrow

 

so, seems like you didn't specified the ID

 

 

so the problem may be in the text file side D:

 

[seifman123]

is there a way to change what the item do  ? i mean if i want it to add 40 agi or 10 str  or sthg ?

[Kido]

is there a way to change what the item do  ? i mean if i want it to add 40 agi or 10 str  or sthg ?

 

yeah, you have to edit the item description and then do the item script so it will grant that bonus

 

https://github.com/rathena/rathena/blob/master/doc/item_bonus.txt

 

to change the description of your item do the step 2 of my guie text side

• Open data/idnum2itemdesctable.txt and add inside ID#<Enter>Description<Enter>#

[seifman123]

hey  can u tell me if i wanted to add a wing what should i change this code to be ??

22024,nekoring_hat,nekoring_hat,4,,,0,,0,,1,0xFFFFFFFF,7,2,256,,1,1,960,{ bonus bAgi,3; bonus bFlee,2; bonus bAspdRate,1; },{ },{ }

oh and u missed sthg ACCESSORY_Nekoring_Hat = 960, here u should make it to be ACCESSORY_Nekoring_Hat = 960  with no comma or am i wrong ?

now i had a problem i corectly added the item but when i try to wear it it  says i cant   wear it    with a socr job any answer ??

and cant u just     talk about the code i put in the item_db  ??  cuz if i wanted to add another item  it cant be the same code right ?

and i also tried to wear the item a added with all the jobs and  cant wear it sorry for all of this questions

[Kido]

hey  can u tell me if i wanted to add a wing what should i change this code to be ??

22024,nekoring_hat,nekoring_hat,4,,,0,,0,,1,0xFFFFFFFF,7,2,256,,1,1,960,{ bonus bAgi,3; bonus bFlee,2; bonus bAspdRate,1; },{ },{ }

oh and u missed sthg ACCESSORY_Nekoring_Hat = 960, here u should make it to be ACCESSORY_Nekoring_Hat = 960  with no comma or am i wrong ?

now i had a problem i corectly added the item but when i try to wear it it  says i cant   wear it    with a socr job any answer ??

and cant u just     talk about the code i put in the item_db  ??  cuz if i wanted to add another item  it cant be the same code right ?

and i also tried to wear the item a added with all the jobs and  cant wear it sorry for all of this questions

 

use this a reference http://rathena.org/wiki/Custom_Items there's how to make it wings, and which jobs can use them

 

hmm not sure about the coma in accessory part, for me it works liek that o: 

 

well uh ehre's a trick

 

wings are locate in lower headgear right? then search in your item_db (no custom) for a lower headgear that can be used by any job 

for example a flu mask

 

then copy it and in the end jsut change the id and the names

ID,name,name <-- 

 

yeah you can't sue the same view id and/or the same id of another item, they need their own ids and names

 

tell if it worked, if not let me know the script of your item o:

[seifman123]

hey  i  made every thing OK    just OK but the problem is that i  cant wear any thing any help ?

Kido