World Buffs is a plugin that allows for the creation of server-wide quests, allowing for players to work together to complete a common goal.
Quests are comprised of any number of tasks, and will reward the entire server upon completion with a mixture of built-in buffs such as increased gather yields, bonus damage to NPCs etc, as well as the option for permissions and server commands. All players, regardless of their online status, will receive the built-in and permission based rewards.
Tasks can be set based on the task type, along with a list of identifying features.
For example, you can have a task that requires players to kill npcs using the KillNpc task type. If you only wanted certain npcs to count, you could then add further restrictions by listing the short prefab names of the npc, such as npc_tunneldweller & npc_underwaterdweller, if you only wanted Tunnel & Underwater dwellers to be considered towards the goal.
The plugin supports the use of a quest queue (disabled by default). Quests in the queue are automatically started when the plugin loads.
When the active quest is completed, the plugin will queue up the next quest after a short while.
The identifier of a task depends on the task type itself. Some tasks work with item shortnames when considering quest progress, while others may use prefab shortnames..
Leaving the identifier field empty or set to null will consider any action that triggers the check to contribute towards the task.
A list of item shortnames can be found here.
A list of prefabs can be found here.
TaskType: Woodcutting
Identifier: Item shortname
TaskType: Mining
Identifier: Item shortname
TaskType: Skinning
Identifier: Item shortname
TaskType: Collectible
Identifier: Item shortname
TaskType: Growable
Identifier: Item shortname
TaskType: Fishing
Identifier: Item shortname
TaskType: Growable
Identifier: Item shortname
TaskType: KillNpc
Identifier: prefab shortname
TaskType: KillNpcSpawn
Identifier: Npc displayname [profile name]
TaskType: KillAnimal
Identifier: prefab shortname
TaskType: KillBradleyApc
Identifier: prefab shortname
TaskType: LootCrates
Identifier: prefab shortname
TaskType: DestroyBarrels
Identifier: prefab shortname
TaskType: Dig
Identifier: prefab shortname
Reward types function similar to Task Types. They allow for identifiers to limit the sources that they impact.
For example, you can specify "cloth" for the CollectibleYield RewardType, which would only boost the yield when collecting cloth, and not other items such as pumpkins or diesel.
RewardType: WoodGatherBonus
Identifier: Item shortname
RewardType: MiningGatherBonus
Identifier: Item shortname
RewardType: SkinningGatherBonus
Identifier: Item shortname
RewardType: FishingBonus
Identifier: Item shortname
RewardType: CollectibleYield
Identifier: Item shortname
RewardType: GrowableYield
Identifier: Item shortname
RewardType: NpcDamageBonus
Identifier: Prefab shortname
RewardType: NpcSpawnDamageBonus
Identifier: Prefab shortname
RewardType: ScientistDefenceBonus
Identifier: Prefab shortname
RewardType: AnimalDefenceBonus
Identifier: Prefab shortname
RewardType: BradleyDamageBonus
Identifier: Prefab shortname
RewardType: BradleyDefenceBonus
Identifier: Prefab shortname
RewardType: NpcSpawnDamageBonus
Identifier: Npc displayName [profile name]
RewardType: XpBonus
Identifier: None
RewardType: UniversalSwipeCardsBonus
Identifier: None
RewardType: PvpDamageBonus
Identifier: None
RewardType: PvpDefenceBonus
Identifier: None
Command: wb.toggle
Type: Chat command
Description: Toggles the ui on and off.
Command: wb.setquestqueueindex <index>
Type: Console command
Description: Set's the next quest in the queue to the specified index value
Requires admin: Yes
Command: wb.startnextquest
Type: Console command
Description: Starts the next quest in the queue if no quest is running.
Requires admin: Yes
Command: wb.cancelquest <true/false: start next quest in queue>
Type: Console command
Description: Cancels the current quest
Requires admin: Yes
Command: wb.completequest
Type: Console command
Description: Mark the current quest as complete (this gives players rewards from the quest)
Requires admin: Yes
Command: wb.startquest <quest name> <optional true/false: force cancel the current quest>
Type: Console command
Description: a
Requires admin: Yes