Creating a skill tree is a fairly straightforward process. This explanation assumes you know how to setup your mod and have set up your proxies. This adds skill support to all LivingEntities.

The skill tab is what the player sees and clicks on to view the page. Its creation was modeled after and similar to creating a Creative Tab. [You can find the Skill tab class here.](../master/src/main/java/zdoctor/skill tree/tabs/SkillTabs.java) During the FMLPreInitializationEvent, create a new instance of SkillTabs passing a String as the label and class that extends SkillPage. This skill page will be where you add and position your skills. That's all you need to create a skill tab. You can save it as a reference, but currently, it is not needed. An example can be seen here. You also need to define the icon (item stack like creative tabs).

A Skill Page holds all your skills. When the page is created you add all your skills to the page. The skill page class can be found here. Depending on the backgound you want, you can replace what getBackgroundType() returns with the enums found here. Skills should extend the Skill.class or you can extend the SkillBase.class if you want more control. You can create you skills in-line, but it is recommended to create more complex skills in a separate class. There are two methods used in page creation: registerSkills and loadPage. In registerSkills you can create your skills for the first time, saving them to a variable. LoadPage is where you add your skills to the page. This gets called when the page is reloaded, making it easier to position skills for devs. This mod supports and unlimited number of skills per page and will resize the page depending on need. Depending on where you want it placed, pass the appropriate column and row during page creation and it will automatically render there. A basic image guide can be found here. The skill icon will also be automatically sized and rendered on top of the skill and the mod will handle all other visuals by default.

A skill needs several parameters: unlocalized name, an Item or ItemStack for the icon, and optional requirements. If you are creating a new attribute skill, it is recommended to create a base attribute class like this. Where you take the name, icon and an Attribute modifier and hard code a passing of an attribute to be modified. There are multiple interfaces that can increase the functionality of skills easily. If you rename a skill, a player will lost that skill if they have it.

A requirement is one of the most important parts of skills. They are what determine whether or not the play can buy a skill. Their are serval built-in requirements. The name and parent requirement are automatically added to the skill. Skill Point requirement is used when the player needs a certain number of skill points, and Level Requirement is used when the player needs a number of levels to buy the skill. Creating a requirement is simple. Create a class that extends ISkillRequirment and override the methods. Then override the methods for description, text color and what happens onFufillment (when the entity pays the price). This classes support of living entiies, so add a check if your requirement requires something entity specific.

You have successfully created a skill page and some skills. Now we will talk about some useful API and other functionality.

This mod does not award the player skill points, but offers a built-in wallet system for points and methods to add points to the entity. To add points to the player or entity, simply pass the entity you want to give points to to the SkillTreeApi method addSkillPoints(EntityLivingBase entity, int points). These will be added and sync across the server and clients.

You can override your Skill Tab if you want greater over how the tab works, or change the background texture. By default, a new tab is placed in the next available slot. You can manually place it, however. If you try to place it where another tab would be, all the other tabs will shift over for you. You cannot guarantee your spot, the last man can come first.

If you would like greater control over how your page is rendered like the Player Info Page. You must register your custom GuiSkillPage class in the GuiPageRegistry during the client side preinit with registerGui(...). If you would like to override an existing page or someone else's, you must then call overrideGui(...). These pages must have a constructor that takes in a SkillPageBase.

Skill Trees adds several default Interfaces that will increase the customizability of skills. To make your skill a toggle ability, simply implement the IToggleSkill interface.. To do something every tick the skill is active, simply implement ISkillWatcher and define what happens..

The class you will use the most is SkillTreeApi. It makes working with the Skill Capability simple. First, it is recommended to use or add the SkillTreeApi.DEPENDENCY to you dependencies annotation in your mod. That way you are sure to have the correct version of the API for your mod. Most of the methods already have documentation, and the other methods are self-explanatory. Use the getSkillHandler(EntityLivingBase entity) to get the entity's skill capability. This provides more methods associated with the ISkillHandler capability. If you want to add a skill tree capability to a non-player (like for a custom NPC with skills), follow the example of attaching the skill handler here.