Items

Search…
Items
SynapseItem
Namespace: Synapse.Api.Items
This is an object which represents an Item (on the Map, in the Inventory, as grenade or not yet spawned)
Static Fields
None => The only SynapseItem with the ID -1
AllItems => All existing Items and their Serials
Fields:
ID => The ItemId of the Item
ItemType => The Actually ItemType which is used
ItemCategory => The ItemCategory of the ItemType
TierFlags => The TierFlags of the Item
IsCustomItem => If the Item is an custom Item
Name => The Name of the Item
Serial => The Serial of this Item. Every Item has a own Serial ID that is only assigned to that Item
Weight => The Weight of the Item
State => The Current state of the Item
ItemHolder => The Player which holds the Item currently in his Inventory (is null if nobody has it)
Durabillity => The durabillity of the Item
Scale => The Scale of the item
Position => The Position of the Item (when a Player holds it it is obviously the Player Position as well)
Rotation => The rotation of the Item
ItemGameObject => The Gameobject of the Item
ItemBase => The ItemBase object of the Item when it is in an Inventory
ItemnPickupBase => The PickupBase of the Item when it is on the map
ItemData => A Dictionary to store Data inside of an Item
WeaponAttachments => The attachments of the item when it is a weapon
Item API
Since there are many diffent types of items with individual code there are some API objects to interact with they special features
ThrowableAPI
You can access it with SynapseItem.Throwable
Fields:
FuseTime => The Time until the Item explodes
ThrowableItem => The gameobject component for Thrownprojecties
Methods:
Fuse() => Activates the grenade when it is currently on the Map
DestroyProjectile() => Destroys the Item and therefore let it explodes (It is recommended to destroy the object afterwards)
Methods
PickUp(Player) => Gives the Player this Item
Drop(Vector3) => Drops it at the Position
Drop() => Drops the Item by the ItemHolder(if it has no ItemHolder at the Position stored in Position)
Despawn() => Despawns the Item (you can Spawn it again with Drop())
DespawnItemBase() => Despawns the ItemBase of the Item
DespawnPickup() => Despawns the Pickup of the Item
Destroy() => Destroys the Item and remove it from the Map entire.
How to spawn a new SynapseItem?
It's really easy to create SynapseItem by using it's constructor
Example:
1
new SynapseItem(ItemType.Coin)
2
​
3
//or you can use the Id of the Coin which would be 35
4
​
5
new SynapseItem(35)
Copied!
If you want to drop the Item on the map, you may use the one of these methods.
1
Vector 3 pos = ...; //Some Position of course ... would throw a Error
2
​
3
//Method 1
4
var item = new SynapseItem(ItemType.Coin, pos);
5
​
6
//Method 2
7
var item = new SynapseItem(ItemType.Coin);
8
item.Drop(pos);
9
​
10
//Methode 3
11
var item = new SynapseItem(ItemType.Coin);
12
item.Position = pos;
13
item.Drop();
Copied!
If you want to give the item a player, you may use one of these methods.
1
Player player = ...; // Some player of course ... would throw a Error
2
​
3
//Method 1
4
new SynapseItem(ItemType.Coin, player);
5
​
6
//Method2
7
var item = new SynapseItem(ItemType.Coin);
8
item.PickUp(player);
9
​
10
//Method3
11
var item = new SynapseItem(ItemType.Coin);
12
player.Inventory.AddItem(item);
Copied!
How to create a Custom Item?
In order to create a Custom Item you have to register it first.
You can do this through the ItemManager which you can get with SynapseController.Server.ItemManager or Server.Get.ItemManager.
Create a CustomItemInformations object (Namespace: Synapse.Api.Items) and use the method RegisterCustomItem() in the ItemManager with this.
Example:
1
using Synapse.Api;
2
using Synapse.Api.Plugin;
3
​
4
namespace FirstPlugin
5
{
6
    [PluginInformation(
7
        Name = "FirstPlugin",
8
        Author = "Dimenzio",
9
        Description = "My First Awesome Plugin",
10
        LoadPriority = int.MinValue,
11
        SynapseMajor = 2,
12
        SynapseMinor = 6,
13
        SynapsePatch = 1,
14
        Version = "v.1.0.0"
15
        )]
16
    public class PluginClass : AbstractPlugin
17
    {
18
        public override void Load()
19
        {
20
            var info = new Synapse.Api.Items.CustomItemInformations()
21
            {
22
                BasedItemType = ItemType.GunUSP, //The ItemType which is it based on (implementing new models is not possible)
23
                ID = 100,                        //You can take all Values for the ID except for the ones which is already used by the vanilla Items (0-35)
24
                Name = "CustomWeapon"            //The Name for your Item
25
            };
26
​
27
            Server.Get.ItemManager.RegisterCustomItem(info);
28
        }
29
    }
30
}
Copied!
After this you can simply create the item with new SynapseItem(100). If you want to find out if a SynapseItem is your new Item you can check it with item.ID.
Note: It's recommended to register the Item in your Load() Method of your PluginClass so that its early registered
Development - Previous
Player
Next - Development
CustomRoles
Last modified 6mo ago
Copy link
Contents
How to spawn a new SynapseItem?
How to create a Custom Item?