Mod Server API
Introduction
This page provides some tips for how to interact with the Server API when you create mod that needs to interact with the game's runtime state or behaviour. A full comprehensive list of the entire API can be found at https://docs.play.eco/api/server/index.html.
Player
The User
and Player
class contain references to information about a specific player. The User
class contains references to the player's owned objects, inventories, their stats, professions, etc. While the Player
class has references to their location, technical server properties, player name, etc. If you have a User
and need to get a Player
instance it's as simple as:
user.Player
Or vice-versa:
player.User
Accessing the Player's Inventory
All of a player's inventory is referenced by the UserInventory
class which is accessed by the Inventory property:
user.Inventory
The player's backpack, action bar, carried items and clothing can be accessed through this object like this:
user.Inventory.Backpack user.Inventory.ActionBar user.Inventory.Carried user.Inventory.Clothing
The items in these inventories can be accessed in a couple different ways as discussed here (TBD link to generic inventories section)
user.Inventory.Backpack
is an Inventory instance that lists all the stacks of items inside the player's backpack but not their clothes or items on their hotbar.
user.Inventory.ActionBar
is an Inventory instance that lists all the standard buttons used to open the backpack, economy viewer, etc. located next to the minimap.
What the action bar looks like in-game:
user.Inventory.Carried
is an Inventory instance that represents the stack of items the player can carry around such as dirt, stone, or logs.