DwarfCraft

Basic PlaceHolders

--------------------------------------------------------------------------------------------------------------------------

%dwarfcraft_maxskilllevel% - Displays the maximum level a player can level a skill to.

%dwarfcraft_racelevellimit% - Displays the maximum level a player can level a skill to for when their race doesn't specialise in a skill

--------------------------------------------------------------------------------------------------------------------------

Player PlaceHolders

--------------------------------------------------------------------------------------------------------------------------

%dwarfcraft_playerrace% - Displays the player's race.

%dwarfcraft_playerlevel% - Displays the player's level

--------------------------------------------------------------------------------------------------------------------------

The API in DwarfCraft is slowly coming along. Everything should be accessible if you make an object of the plugin through spigot. You can have a look through the source code if it helps. Also your IDE should tell you what most methods do. A Javadocs is in progress. If you need any help just PM me.

Currently there are six events, DwarfLevelUp, DwarfDepositEvent, DwarfEffectEvent, DwarfRaceChangeEvent, DwarfLoadSkillsEvent and DwarfLoadRacesEvent.
DwarfLevelUpEvent is fired whenever a player levels up a DwarfSkill.
DwarfDepositEvent is fired whenever a player deposits item for a DwarfSkill to a trainer.
DwafEffectEvent is fired whenever an effect is fired. i.e. whenever DwarfCraft alters a mob drop, crafting recipe, block drop, etc.
DwarfRaceChangeEvent is fired when a player's race is attempted to be changed. (Just before the race change is saved into the database)
DwarfLoadSkillsEvent is fired just after all the skills are read from the csv files.
DwarfLoadRacesEvent is fired just after the races.config file is read.

Here's an example of how to utilise DwarfCraft.

public class Companion extends JavaPlugin implements Listener {

    private DwarfCraft dwarfcraft;

    @Override
    public void onDisable() {
    }

    /**
     * Called upon enabling the plugin
     */
    @Override
    public void onEnable() {
        PluginManager pm = getServer().getPluginManager();
        if (getServer().getPluginManager().getPlugin("DwarfCraft") == null || getServer().getPluginManager().getPlugin("DwarfCraft").isEnabled() == false) {
            System.out.println("[Companion] Couldn't find DwarfCraft!");
            System.out.println("[Companion] Companion now disabiling...");
            getServer().getPluginManager().disablePlugin(this);
            return;
        }
        dwarfcraft = (DwarfCraft) pm.getPlugin("DwarfCraft");
        System.out.println("[Companion] Hooked into DwarfCraft!");
        pm.registerEvents(this, this);
        System.out.println("[Companion]" + getDescription().getName() + " version " + getDescription().getVersion() + " is enabled!");
    }

public void onPlayerInteract(PlayerInteractEvent event) {
        DCPlayer player = dwarfcraft.getDataManager().find(event.getPlayer());

        if (event.getAction() == Action.LEFT_CLICK_BLOCK) {
               if(player.getRace().equalsIgnoreCase("Dwarf")) {
                     //DO SOMETHING HERE
              }
        }
    }
}

The commands shown below are all sub commands of the base command DwarfCraft. i.e. "/DwarfCraft <subcommand>"
For Example "/DwarfCraft SkillSheet"

Basic Commands

--------------------------------------------------------------------------------------------------------------------------

SkillSheet - Displays your skillsheet.

Info - Displays a General Info Page about DwarfCraft.

Rules - Displays the set Server Rules in the DwarfCraft config.

SkillInfo - Displays the Progress/Info of the specific Skill of that player.

Race - Displays the DwarfCraft Race GUI which displays a players race information, or changes it.

EffectInfo - Displays the Effect of the specified skill of the specified player.

Tutorial - Gives the player the DwarfCraft Pocket Guide

--------------------------------------------------------------------------------------------------------------------------

Admin Commands

--------------------------------------------------------------------------------------------------------------------------

Debug - Changes the Debug Level the less it is the more Debug Messages you will see.

Reload - Reloads DwarfCraft.

Race - Allows an admin to manually change a players race.

Tutorial - Allows an admin to give a player the DwarfCraft Pocket Guide

List - List all the trainers that are on the server.

SetSkill - Sets the level of the specified skill on the specified player.

Create - Creates a DwarfCraft Trainer at your location.

--------------------------------------------------------------------------------------------------------------------------

Permissions Nodes:

dwarfcraft.norm.dwarfcraft

• This base command permission node is required for all sub commands to work

dwarfcraft.norm.commandname

• This permissions node is only for the specified Basic Commands.

dwarfcraft.norm.race.racename

• This permissions node is for races, if the player doesn't have the perm they can't change to this race. The race name has to be in lowercase.

dwarfcraft.op.commandname

• This permission node is only for the specified Admin Commands.