Modding:Basic Inventory Handling: Difference between revisions

From Vintage Story Wiki
No edit summary
No edit summary
Line 13: Line 13:


<syntaxhighlight lang="c#">
<syntaxhighlight lang="c#">
private ICoreServerAPI _serverApi;
private ICoreServerAPI serverApi;


public override void StartServerSide(ICoreServerAPI api)
public override void StartServerSide(ICoreServerAPI api)
   {
   {
     _serverApi = api;
     serverApi = api;
     _serverApi.Event.PlayerRespawn += EventOnPlayerRespawn;
     serverApi.Event.PlayerRespawn += EventOnPlayerRespawn;
   }
   }


private void EventOnPlayerRespawn(IServerPlayer player)
private void EventOnPlayerRespawn(IServerPlayer player)
   {
   {
     ItemStack torch = new ItemStack(_serverApi.World.GetBlock(new AssetLocation("torch-up")));
     ItemStack torch = new ItemStack(serverApi.World.GetBlock(new AssetLocation("torch-up")));
     player.InventoryManager.TryGiveItemstack(torch);
     player.InventoryManager.TryGiveItemstack(torch);
   }
   }
Line 31: Line 31:


<syntaxhighlight lang="c#">
<syntaxhighlight lang="c#">
ItemStack torch = new ItemStack(_serverApi.World.GetBlock(new AssetLocation("torch-up")));
ItemStack torch = new ItemStack(serverApi.World.GetBlock(new AssetLocation("torch-up")));
ItemSlot offhandSlot = player.Entity.LeftHandItemSlot;
ItemSlot offhandSlot = player.Entity.LeftHandItemSlot;
if (offhandSlot?.Empty == true)
if (offhandSlot?.Empty == true)
Line 40: Line 40:
</syntaxhighlight>
</syntaxhighlight>


If you need access to other inventories like e.g. the backpack inventories, you can use the <code>InventoryManager.Inventories</code> Property. This contains a dictionary with the name of the inventory (for example "hotbar-APlayerUID") and the corresponding inventory. Remember that the backpack inventory contains the bags as well as the slots, so you have to check if it is valid to put the item there. If for example you want to fill every empty slot in the backpack with single torches you could do the following:
If you need access to other inventories like e.g. the backpack inventories, you can use the <code>InventoryManager.Inventories</code> Property. This contains a dictionary with the name of the inventory (for example "hotbar-APlayerUID") and the corresponding inventory. Another cleaner looking way if you only need a single inventory would be the <code>InventoryManager.GetOwnInventory()</code> method. Also note that most of the string names are already in <code>GlobalConstants</code>.
A thing to remember is that the backpack inventory contains the bags as well as the slots, so you have to check if it is valid to put the item there, you can use the <code>ItemSlot.CanHold</code> method for example.  
 
If for example you want to fill every empty slot in the backpack with single torches you could do the following:


<syntaxhighlight lang="c#">
<syntaxhighlight lang="c#">
Block torchBlock = _serverApi.World.GetBlock(new AssetLocation("torch-up"));
Block torchBlock = _serverApi.World.GetBlock(new AssetLocation("torch-up"));
IInventory backpack = player.InventoryManager.Inventories.FirstOrDefault(i => i.Key.StartsWith("backpack")).Value;
IInventory backpack = player.InventoryManager.GetOwnInventory(GlobalConstants.backpackInvClassName);
if (backpack != null)
if (backpack != null)
{
{
   ItemSlot dummySlot = new ItemSlot(null) { Itemstack = new ItemStack(torchBlock) }; //dummy slot to check if the slot would be a valid one
   var dummySlot = new ItemSlot(null) { Itemstack = new ItemStack(torchBlock) };
   foreach (ItemSlot bag in backpack.Where(b => b.CanHold(dummySlot) && b.Empty))
   foreach (ItemSlot bag in backpack.Where(b => b.CanHold(dummySlot) && b.Empty))
   {
   {

Revision as of 11:25, 13 April 2020

Template:GameVersion112

Overview

The most important classes for inventory management are:

  • InventoryManager: Contains multiple inventories (every player has one with different inventories). Also helps with common tasks like putting items into a valid inventory.
  • IInventory: Represents an item inventory (for example the players hotbar). Contains multiple ItemSlots.
  • ItemSlot: Represents a specific slot (for example the offhand slot) of an inventory. Contains the ItemStack of the slot and Methods to help transfer items to and from that slot.
  • ItemStack: Contains the Item and amount of items (called StackSize), e.g. "block torch-up" and StackSize of 2, for two Torches.

Basic Inventory Handling

To get access to a players inventory, you can use the InventoryManager of the IPlayer. For example, to simply give the player a torch when respawning you could use TryGiveItemStack:

private ICoreServerAPI serverApi;

public override void StartServerSide(ICoreServerAPI api)
  {
    serverApi = api;
    serverApi.Event.PlayerRespawn += EventOnPlayerRespawn;
  }

private void EventOnPlayerRespawn(IServerPlayer player)
  {
    ItemStack torch = new ItemStack(serverApi.World.GetBlock(new AssetLocation("torch-up")));
    player.InventoryManager.TryGiveItemstack(torch);
  }

If we want to put it directly into the offhand we can use player.Entity.LeftHandItemSlot:

ItemStack torch = new ItemStack(serverApi.World.GetBlock(new AssetLocation("torch-up")));
ItemSlot offhandSlot = player.Entity.LeftHandItemSlot;
if (offhandSlot?.Empty == true)
{
  offhandSlot.Itemstack = torch;
  offhandSlot.MarkDirty(); //this is needed because otherwise the client does not get the update
}

If you need access to other inventories like e.g. the backpack inventories, you can use the InventoryManager.Inventories Property. This contains a dictionary with the name of the inventory (for example "hotbar-APlayerUID") and the corresponding inventory. Another cleaner looking way if you only need a single inventory would be the InventoryManager.GetOwnInventory() method. Also note that most of the string names are already in GlobalConstants. A thing to remember is that the backpack inventory contains the bags as well as the slots, so you have to check if it is valid to put the item there, you can use the ItemSlot.CanHold method for example.

If for example you want to fill every empty slot in the backpack with single torches you could do the following:

Block torchBlock = _serverApi.World.GetBlock(new AssetLocation("torch-up"));
IInventory backpack = player.InventoryManager.GetOwnInventory(GlobalConstants.backpackInvClassName);
if (backpack != null)
{
  var dummySlot = new ItemSlot(null) { Itemstack = new ItemStack(torchBlock) };
  foreach (ItemSlot bag in backpack.Where(b => b.CanHold(dummySlot) && b.Empty))
  {
    bag.Itemstack = new ItemStack(torchBlock);
    bag.MarkDirty();
  }
}