Inventory - Meteor 2 Scripting Functions

void givePlayerItem(int playerID, string itemName, int amount)

Give items to a player.

if(isServer())
{
    // give all players 1 rifle mag
    for(int i=0; i<getPlayersCount(); i++)
    {
        int playerID = getPlayerAtIndex(i);
        givePlayerItem(playerID, "Rifle Mag", 1);
    }
}

Pass a negative amount to take items.
Final item counts are clamped between 0 and max specified in base\game\items.ini (depending on game mode)
Can be called from server or client.

getPlayerItemCount resetPlayerItems clampPlayerWeapon

int getPlayerItemCount(int playerID, string itemName)

Get amount of an item a player has.

// show how many rifle mags player has
for(int i=0; i<getPlayersCount(); i++)
{
int playerID = getPlayerAtIndex(i);
print(getPlayerName(playerID) + " has " + getPlayerItemCount(playerID, "Rifle Mag") + " rifle mags");
}

givePlayerItem resetPlayerItems

void resetPlayerItems(int playerID, bool mapStartItemsOnly)

Reset a player's items (server only).

if(isServer())
{
    // reset all player loadouts to basics only
    for(int i=0; i<getPlayersCount(); i++)
    {
        int playerID = getPlayerAtIndex(i);
        int playerObjectID = getPlayerObject(playerID);
        resetPlayerItems(playerID, false);
        clampPlayerWeapon(playerID);
    }
}

set mapStartItemsOnly to true to keep weapons and ammo but loose keys etc.
set mapStartItemsOnly to false to keep only default starting items like starting a new game (e.g. pistol and some bullets).

givePlayerItem getPlayerItemCount clampPlayerWeapon

void addItem(int objectID, string itemName, int count)

Add item to an object's inventory (server and clients).

addItem(PLAYER_OBJECT, "Rifle Mag", 1);

removeItem getItemCount

void removeItem(int objectID, string itemName)

Remove an item from an object's inventory (server and clients).

removeItem(PLAYER_OBJECT, "Rifle Mag");

addItem getItemCount

void getItemCount(int objectID, string itemName)

Get the count of an item from an object's inventory (server and clients).

print(getItemCount(PLAYER_OBJECT, "Rifle Mag"));

addItem removeItem

string getItemTypeNumber()

Get the index of an item type.

print(getItemTypeNumber("Chocolate Bar"));

Returns 0 (default item) if the item does not exist.

getItemTypeName

string getItemTypeName()

Get the name of an item type by index.

print(getItemTypeName(0));

getItemTypeNumber getItemTypesCount getItemTypeNames

int getItemTypesCount()

Get the amount of item types.

print("There are " + getItemTypesCount() + " item types.");

getItemTypeName getItemTypeNames

int getItemTypeNames()

Get the names of all item types.

// show how many of each item the local player has
array<string> itemTypeNames = getItemTypeNames();
for(uint i=0; i<itemTypeNames.length(); i++)
{
print(itemTypeNames[i] + ": " + getPlayerItemCount(getLocalPlayer(), itemTypeNames[i]));
}

getItemTypeName getItemTypesCount