[TUTORIAL] How to add your own Item-Code!

[ImTheReal]

Hey Guys, this tutorial will show you how to add your own Item-Code!


Knowledge: 6/10

Step 1: Visit OpenNos.GameObject/Item/then choose the wished handler.
For example:
- Special Item = Speaker, Bubbles, Fairy-Booster etc.
- Magic Item = Dowsing Rod, Airwaves etc.
- No Function Item = Quest Items, some Materials

Step 2: After u choose the handler, let's start with adding a case!
For this, you write:

case <INSERT_RANDOM_NUMBER>:
break;

What is meant with INSERT_RANDOM_NUMBER? That means, you can add a number you want to have in there.
I personally start behind 9000
so: case 9000:

Step 3: After writing the code, you have to insert the case as effect to the wished item.
If you want to create your own Random Box, then search for the Item in the Database, and insert the case Number in "Effect" on the item values.
Item: Random Box of divine Fairys
Case Number: 9000
Effect Value: 9000

Step 4: Insert your code!
As i already said, we will add the Random Box of divine Fairy.

HELPER

 Spoiler

If you insert a code, where a character should get something, you have to work with Sessions.
For example:
//To Add give the Character Items ON_USE
Session.Character.GiftAdd(id, amount);
//To give the Character Compliments ON_USE
Session.Character.Compliment = +amount;
//To give the Character a new Rank ON_USE
Session.Character.Authority = AuthorityType.YourAuthority;
//To delete the Item ON_USE
session.Character.Inventory.RemoveItemFromInventory(inv.Id);
//To keep the Item ON_USE
//Just dont Insert a InventoryRemover
//To send a Message ON_USE
Session.SendPacket(Session.Character.GenerateSay("Success! You recieved your Items!", 12));

You can also just try out urself with using Session.Character. and just look at the statements. There are many methods. Try to do something urself

The code i will show now, is a bit complexer. Its just to show you, how to add a randomizer for Random Boxes.

// Random Box of Divine Fairys
                case 9000:
//For this Code, you have to add also 9000 as EffectValue to the Database
                    if (EffectValue == 9000)
                    {
                        int rnd = ServerManager.RandomNumber(0, 1);
                        if (rnd < 1)
                        {
                            short[] vnums =
                            {
                            //ID's of the Items, you will get
                                4129, 4130, 4131, 4132
                            };
                            //This Code counts the Items, you inserted
                            byte[] counts = { 1, 1, 1, 1};
                            int item = ServerManager.RandomNumber(0, 4);
                            session.Character.GiftAdd(vnums[item], counts[item]);
                        }
                            //This Code, deltes the Item from the Inventory                      session.Character.Inventory.RemoveItemFromInventory(inv.Id);
                    }
                    break;

Another Example:

//Item: White Tiger Costume Set
//ID: 5487
                case 9001: //9000 already in use, so just go up
//Adds the Costume and the Hat to the inventory
                    session.Character.GiftAdd(4248, 1);
                    session.Character.GiftAdd(4256, 1);
//Deletes the Item from Inventory
                   session.Character.Inventory.RemoveItemFromInventory(inv.Id);
//You can also add a message, ON_USE
//session.SendPacket("msg 5 Success! You recieved your Items.");
                    break;

DB_HELPER

 Spoiler

[ID] 5279 [NAME] Random Box of divine Fairys [EFFECT] 9000 [EFFECT_VALUE] 9000

[ID] 5487 [NAME] White Tiger Costume Set [EFFECT] 9001 [EFFECT_VALUE] 0

[Blowa]

This solution is the result of what OpenNos became : An unmaintainable project.

Having a Dictionary, with Id/Effect/EffectValue as keys and Lambdas as values (splitted over files) would be much more maintainable than a 4054305340 length switch case.
(Even if the dictionary is slower than switch statement, you would not notice the difference)

[ImTheReal]

Originally Posted by val77

This solution is the result of what OpenNos became : An unmaintainable project.

Having a Dictionary, with Id/Effect/EffectValue as keys and Lambdas as values (splitted over files) would be much more maintainable than a 4054305340 length switch case.
(Even if the dictionary is slower than switch statement, you would not notice the difference)

Im just willing to help, and ye prob. that is a better solution, but i like this way and its easy to explain for newbies. But Blowa, i please you to be more kind cuz the way u comment, is like an insult. Im just willing to help, nothing more.

[Worldie]

I don't understand, why not use the table RollGeneratedItem ?

[Blowa]

Originally Posted by Worldie

I don't understand, why not use the table RollGeneratedItem ?

He tried to explain to add a custom handling when an item is used

But his solution will actually result in an unmaintainable code

[[NH]Pyro]

RollgeneratedItem?? have we forgotten?

[BladeTiger12]

Originally Posted by [NH]Pyro

RollgeneratedItem?? have we forgotten?

Where is the dislike button... We actually need one.
And I guess he just want some posts.

[Zanouu]

RollGeneratedItem is For , ONLY 1 item random But if you have Box " Not random " ( exemple :Box for Suit , Box for wedding etc U cant ** )

** If you do not Added Another Column in RollGenerated

[ImTheReal]

Originally Posted by [NH]Pyro

RollgeneratedItem?? have we forgotten?

First: What kind of english is that?
Secondly: ????????????????????????????????????
I guess some people don't understand Examples.
Although, have fun adding a Ancelloan Blessing in RollGeneratedItems

[[NH]Pyro]

Ancelloan non a box, but divine fairy yes

[roxas9797]

This tutorial is awesome
Useless
But awesome