API

Events

• JobsAreaSelectionEvent
• JobsChunkChangeEvent (cancellable)
• JobsExpGainEvent (cancellable)
• JobsJoinEvent (cancellable)
• JobsLeaveEvent (cancellable)
• JobsLevelUpEvent (cancellable)
• JobsPaymentEvent (cancellable)
• JobsPrePaymentEvent (cancellable)
• JobsScheduleStartEvent (cancellable)
• JobsScheduleStopEvent (cancellable)

JobsAreaSelectionEvent

The event is called when selected an area with the specified item.

Example

@EventHandlerpublicvoidonJobsAreaSelection(JobsAreaSelectionEventevent) {
event.getPlayer().sendMessage("You have selected the area in high and low location: " + event.getArea().getHighLoc() + " " + event.getArea().getLowLoc());
}

JobsChunkChangeEvent

The event is called when the chunk has changed.

Example

@EventHandlerpublicvoidonJobsChunkChange(JobsChunkChangeEventevent) {
event.getPlayer().sendMessage("The new chunk is: " + event.getNewChunk());
}

JobsExpGainEvent

The event is called when a player gain exp from job.

Example

@EventHandlerpublicvoidonJobsExpGain(JobsExpGainEventevent) {
event.getPlayer().sendMessage("You got " + event.getExp() + " amount exp in job " + event.getJob().getName());
}

JobsJoinEvent

The event is called when a player join to a specified job.

Example

@EventHandlerpublicvoidonJobsJoin(JobsJoinEventevent) {
event.getPlayer().getPlayer().sendMessage("You have joined to " + event.getJob().getName() + " job!");
}

JobsLeaveEvent

The event is called when a player left from a specified job.

Example

@EventHandlerpublicvoidonJobsLeave(JobsLeaveEventevent) {
event.getPlayer().getPlayer().sendMessage("You have left from " + event.getJob().getName() + " job!");
}

JobsLevelUpEvent

The event is called when a player leveled up in that job.

Example

@EventHandlerpublicvoidonJobsLevelUp(JobsLevelUpEventevent) {
event.getPlayer().getPlayer().sendMessage("You have leveled up in " + event.getJob().getName() + " job!");
}

JobsPaymentEvent

The event is called when calculating the payment.

Example

@EventHandlerpublicvoidonJobsPayment(JobsPaymentEventevent) {
event.getPlayer().sendMessage("You got " + event.get(CurrencyType.MONEY) + " money!");
}

JobsPrePaymentEvent

Event fired, before the payment calculation process should beginning.

Example

@EventHandlerpublicvoidonJobsPrePayment(JobsPrePaymentEvente) {
e.getPlayer().sendMessage("Payment event is cancelled in " + e.getJob().getName() + " job!");
e.getPlayer().sendMessage("You not get any income for doing actions.");
e.setCancelled(true);
}

JobsScheduleStartEvent

The event is called when started the schedule.

Example

@EventHandlerpublicvoidonJobsScheduleStart(JobsScheduleStartEventev) {
if (e.getSchedule().isStarted()) {
Bukkit.getLogger().log(Level.INFO, "The scheduler has started.");
}
}

JobsScheduleStopEvent

The event is called when stopped the schedule.

Example

@EventHandlerpublicvoidonJobsScheduleStop(JobsScheduleStopEventev) {
if (e.getSchedule().isStoped()) {
Bukkit.getLogger().log(Level.INFO, "The scheduler has stopped.");
}
}

Player information

To get player's information object, use:

JobsPlayerjobsPlayer = Jobs.getPlayerManager().getJobsPlayer(player);

Then you can get things such as their log, left times, quests, total levels and more. Remember that this method can return null if the given player is not cached into memory.

To get player's job progression list (unmodifiable) use:

JobsPlayerjobsPlayer = Jobs.getPlayerManager().getJobsPlayer(player);
if (jobsPlayer != null) {
List<JobProgression> jobs = jobsPlayer.getJobProgression();
for (JobProgressionprog : jobs) {
// Do your stuff here
}
}

To get an unmodifiable jobs list:

Jobs.getJobs();