Interface CampaignEventManagerAPI
public interface CampaignEventManagerAPI
-
Method Summary
Modifier and TypeMethodDescriptionvoid
endEvent
(CampaignEventPlugin event) int
getNumOngoing
(String eventType) getOngoingEvent
(CampaignEventTarget eventTarget, String eventType) getProbability
(String eventType, MarketAPI market) getProbability
(String eventType, CampaignEventTarget target) getProbability
(String eventType, LocationAPI eventTargetLocation) getProbability
(String eventType, SectorEntityToken eventTargetEntity) getProbability
(String eventType, Object custom) boolean
isOngoing
(CampaignEventTarget eventTarget, String eventType) boolean
Whether an event associated with this probability is already ongoing.primeEvent
(CampaignEventTarget eventTarget, String eventType, Object param) Initialize the event plugin, but don't actually start the event.void
startEvent
(CampaignEventPlugin primedEvent) Start an event previously created with primeEvent()startEvent
(CampaignEventTarget eventTarget, String eventType, Object param) Starts an event immediately, bypassing any probability checks.
-
Method Details
-
getProbability
-
getProbability
-
getProbability
-
getProbability
-
getProbability
-
isOngoing
Whether an event associated with this probability is already ongoing. Only one event of a given type can occur at a time for a given event target.- Parameters:
ep
-- Returns:
-
isOngoing
-
startEvent
Starts an event immediately, bypassing any probability checks. Returns null if failed to start the event because there's already an ongoing event of the same type, or the event plugin otherwise. param gets passed in to the event via CampaignEventPlugin.setParam().- Parameters:
eventTarget
- can be null if the event doesn't have a specific target.eventType
-param
-- Returns:
-
getOngoingEvent
-
endEvent
-
primeEvent
Initialize the event plugin, but don't actually start the event. Useful if the event is needed for doing token replacement in reports, for example, but it's not desired for the event to start. Will return null if the event can't be created for any reason - for example, if another event of the same type is ongoing for this target and the event doesn't allow multiple ongoing at the same time.- Parameters:
eventTarget
-eventType
-param
-- Returns:
-
startEvent
Start an event previously created with primeEvent()- Parameters:
primedEvent
-
-
getNumOngoing
-
getOngoingEvents
List<CampaignEventPlugin> getOngoingEvents()
-