[Hedgehog Fog]

Items API

Description

Simple API for create custom items.
This can be used for the creation of healthkits, keycards, etc.

Natives

Register item.

• item_create(const pick_func[]);

Set model index to item.

• item_set_modelindex(item, modelindex);

Set collision box size to item.

• item_set_size(item, const Float:fSize[3]);

Check if the entity is a item.

• bool:item_is_valid(ent);

Spawn item by index.

• item_spawn(item, const Float:fOrigin[3]);

Remove item correctly.

• item_remove(ent);

How to use?

• Use item_create native for create new item (Pass the name of the callback function that is executed when item was picked).
• Use item_set_modelindex native for set modelindex to item.
• Use item_set_size native for set size to item.
• Create callback function. Function must return ITEM_PICKED if item has been picked and ITEM_IGNORED if not.

Example

PHP Code:

#pragma semicolon 1

#include <amxmodx>
#include <cstrike>
#include <fakemeta>
#include <fakemeta_util>

#include <api_items>

#define PLUGIN    "[Item] CS Defuse Kit"
#define VERSION    "0.1.0"
#define AUTHOR    "Hedgehog Fog"

new g_itemIndex;
new g_itemMdl;

public plugin_init()
{
    register_plugin(PLUGIN, VERSION, AUTHOR);

    g_itemIndex = item_create("on_item_picked");
    item_set_modelindex(g_itemIndex, g_itemMdl);
    item_set_size(g_itemIndex, Float:{8.0, 8.0, 4.0});

    register_clcmd("dk", "clcmd_dk");
    register_clcmd("say /dk", "clcmd_dk");
}

public plugin_precache()
{
    g_itemMdl = precache_model("models/w_thighpack.mdl");
}

public clcmd_dk(id)
{
    new Float:fOrigin[3];
    fm_get_aim_origin(id, fOrigin);

    fOrigin[2] += 4.0;

    item_spawn(g_itemIndex, fOrigin);
}

public on_item_picked(id, ent)
{
    if(cs_get_user_defuse(id))
        return ITEM_IGNORED;

    cs_set_user_defuse(id, 1);

    return ITEM_PICKED;
} 


[Phant]

Good job! What about submodels and skins support for models of items?
Why you not visit CSM-chat (IRC) anymore ?

[fysiks]

This should be posted in Code Snippets/Tutorial since it is not a plugin that a non-scripting user can use.

[Hedgehog Fog]

fysiks,
I posted this in Code Snippets/Tutorial before, but then I saw that other users post API's in Plugins.

Phant,
I can add submodels and skins support in next version. I think about the good solution for all variables.

[fysiks]

Originally Posted by Hedgehog95 fysiks, I posted this in Code Snippets/Tutorial before, but then I saw that other users post API's in Plugins.

Just because other users have done it doesn't make it the best place to put it. People who are writing plugins wont' look in any of the plugin forums for an API.

[HamletEagle]

So, basically your API allow users to create an entity, give it a model and the plugin is noticed when the entity is touched.

You don't need an API for that, this are basic stuffs that can be done easily. Unapproved.

[Hedgehog Fog]

HamletEagle,
It saves more than 100 lines of code and you don't need to allocate memory for EngFunc_AllocString everytime.

[fysiks]

Originally Posted by Hedgehog95 HamletEagle, It saves more than 100 lines of code and you don't need to allocate memory for EngFunc_AllocString everytime.

100? lol That is not very much code.

[Hedgehog Fog]

fysiks,
This is enough.

You don't need remove entity, make basic checks, make/remove HamHook. This is a simple API, but it simplifies the creation of custom items. It contains the basic checks and the setups that allows you to not write the same code many times. It could well be useful for mods, where is necessary to implement a few custom items (it was created for Halloween Mod, here we have 3 custom items: pumpkins, spells, gifts and I have decided to replace the duplication of same code to the ready-made solution).
I agree that it is not very difficult to implement, but I do not agree that it is useless, but your forum - your rules.

OFFTOP

I would like to change the nickname to Hedgehog Fog. Who do I contact?

[addons_zz]

Originally Posted by Hedgehog95 I agree that it is not very difficult to implement, but I do not agree that it is useless, but your forum - your rules.

Could you try Code Snippets/Tutorials subforum instead of new plugins.