Confirmedusers
711
edits
mNo edit summary |
|||
Line 44: | Line 44: | ||
To keep the code organized, you should create a new folder called "Items". Right click on your project, hover over add, and select ''New Folder''. | To keep the code organized, you should create a new folder called "Items". Right click on your project, hover over add, and select ''New Folder''. | ||
You need a name for the new item class. These follow the same convention as the Blocks, and most other types. In this case, our thorny blade item class, you should name this class "ItemThornsBlade". | You also need a name for the new item class. These follow the same convention as the Blocks, and most other types. In this case, our thorny blade item class, you should name this class "ItemThornsBlade". | ||
Create your new class. Right click the new folder, hover over ''Add'', and select ''Class''. Ensure you have the standard ''Class'' selected in the template list, enter your class name, and click create. | Create your new class. Right click the new folder, hover over ''Add'', and select ''Class''. Ensure you have the standard ''Class'' selected in the template list, enter your class name, and click create. | ||
The class you created needs to extend the 'Item' | The class you created needs to extend the 'Item' class. This will allow you to use many of the available functions for items. Change the class definition to now be: <syntaxhighlight lang="csharp"> | ||
internal class ItemThornsBlade : Item | |||
</syntaxhighlight>Most of the time, Visual Studio will automatically add 'using' statements. However, if this errors, click on "Item", press Alt+Enter, and select the "using Vintagestory.API.Common" option. | |||
[[File:VisualStudioModdingTutorialAutoErrorSolving.png|center|frameless|623x623px]] | |||
The ItemThornsBlade class now exists, but it does nothing. Time to override a function, I suppose. | |||
Inside the empty class, type "override " and a list of methods we can use will be displayed. In this instance, you will want to override the 'OnAttackingWith' function. This function is called whenever our item is used to attack an entity. Search for this in the list and double click on it to automatically add the required code sample. | |||
[[File:VisualStudioModdingTutorialOverrideOnAttackingWithFunction.png|center|frameless|767x767px]] | |||
Your class should now look like this: | |||
{| class="wikitable mw-collapsible mw-collapsed" | |||
|ItemThornsBlade.cs | |||
|- | |||
|<syntaxhighlight lang="csharp"> | |||
using Vintagestory.API.Common; | |||
using Vintagestory.API.Common.Entities; | |||
namespace VSTutorial.Items | |||
{ | |||
internal class ItemThornsBlade : Item | |||
{ | |||
public override void OnAttackingWith(IWorldAccessor world, Entity byEntity, Entity attackedEntity, ItemSlot itemslot) | |||
{ | |||
base.OnAttackingWith(world, byEntity, attackedEntity, itemslot); | |||
} | |||
} | |||
} | |||
</syntaxhighlight> | |||
|} | |||
Note that the the sample code in ''<nowiki/>'OnAttackingWith' contains a function called 'base.OnAttackingWith'.'' This essentially runs any default behavior for the function. If you were to remove this line then any default behavior would not happen, and, in this case, the item will not lose any durability when used for attacking. | |||
In the OnAttackingWith function, you are given access to the world, the entity who is attacking, the entity who is being attacked, and the itemslot that this item exists in. For testing purposes, add some code that outputs a message to the console when we attack an entity. You'll need to add the following code below the '''base''<nowiki/>' line:<syntaxhighlight lang="csharp"> | |||
world.Api.Logger.Event("Got attack with thorns blade!"); | |||
</syntaxhighlight>You can access the current game API from a lot of places. This particular line accesses the API through the world, however it can also be accessed through any entity with very similar code. You should be aware that this will create a message to the console when we attack an entity with the new item. | |||
=== Registering the Item Class === | === Registering the Item Class === | ||
Line 75: | Line 107: | ||
== Testing the Block Class == | == Testing the Block Class == | ||
Press F5 again to run the game with the mod. Remember to set the game to windowed mode by pressing F11. Find the | Press F5 again to run the game with the mod. Remember to set the game to windowed mode by pressing F11. Find the thorns blade in the creative menu, and use it to attack an entity. | ||
After doing so, take a look at the console that opened when launching the game. You should be able to see the following logs:<syntaxhighlight> | |||
[Client Event] Got attack with thorns blade! | |||
[Server Event] Got attack with thorns blade! | |||
</syntaxhighlight>Remember what's going on here? Although you only attacked the entity once, there are two entries. One of these is sent to the console by the client, and the other is sent by the server. You should start to become aware that a lot of the code you write is going to happen on both the client and server. You'll be shown ways of controlling this later. | |||
The thorns blade class and function are working, so close the game and go back to the ItemThornsBlade class. | |||
== Thorns Blade Functionality == | |||
You now need to add the real functionality for the thorns blade. Remove the line of code that logs the attack event, since you don't need that anymore. Your code should look like the following. Feel free to copy and paste this, as it contains some useful code comments too. | |||
{| class="wikitable mw-collapsible mw-collapsed" | {| class="wikitable mw-collapsible mw-collapsed" | ||
| | |ItemThornsBlade.cs | ||
|- | |- | ||
|<syntaxhighlight lang="csharp"> | |<syntaxhighlight lang="csharp"> | ||
using Vintagestory.API.Common; | using Vintagestory.API.Common; | ||
using Vintagestory.API. | using Vintagestory.API.Common.Entities; | ||
namespace VSTutorial.Items | |||
namespace VSTutorial. | |||
{ | { | ||
/* | /* | ||
* As this is an item, you need to inherit the Item class. This gives access to functions within Item, and CollectibleObject. | |||
* | * Take a look at https://apidocs.vintagestory.at/api/Vintagestory.API.Common.Item.html#methods and | ||
* https://apidocs.vintagestory.at/api/Vintagestory.API.Common.CollectibleObject.html#methods for all the methods that can be overriden. | |||
internal class | */ | ||
internal class ItemThornsBlade : Item | |||
{ | { | ||
/* | |||
* This function is called whenever this item is used by an entity to attack another entity. | |||
* You have access to the world, the entity who is attacking, the entity who is being attacked, and the held item's data. | |||
*/ | |||
public override void OnAttackingWith(IWorldAccessor world, Entity byEntity, Entity attackedEntity, ItemSlot itemslot) | |||
{ | |||
base.OnAttackingWith(world, byEntity, attackedEntity, itemslot); | |||
} | |||
} | } | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
|} | |} | ||
=== Reflecting Damage === | |||
To inflict damage on an entity, there are two small steps: | |||
# A ''DamageSource'' instance must be created. | |||
The | # The damage source must be inflicted on the entity using the Entity.ReceiveDamage function. | ||
So, add the following block inside the function:<syntaxhighlight lang="csharp"> | So, add the following block inside the function:<syntaxhighlight lang="csharp"> |