Skip to content

Outpost outpost

This feature adds outposts that players can capture for their faction. These outposts can add passive buffs and give money for holding them.

Control of an outpost is done by percentage, from 0-100%.

Config

onlyBroadcastPassiveMessagesToFactionsInvolved

Outposts periodically broadcast passive messages like capture status. This option makes it so those messages only get sent to users attacking or controlling an outpost.

percent-per-player

The percentage of 'attack' that each player is worth when standing on the outpost's control point.

max-percent-per-outpost-tick

The absolute maximum amount the outpost can move in each tick.

Note

Outposts tick at the speed of one per second.

max-captured-outposts

The maximum amount of outposts a faction can control at one time.

only-broadcast-in-world

The world in which outpost status changes should broadcast. Set to all for all worlds.

boosts-stack-with-booster-feature

If xp and spawner boosts should stack with the booster feature.

boosts-stack-with-raiding-outpost-feature

If xp and spawner boosts should stack with the raiding outpost feature.

require-armored

If the feature should require players capturing outposts to be fully armored.

xp-boosts-accumulate

If a faction controls more than one outpost with an XP boost, setting this to true will multiply each subsequent boost.

Example

A faction controlling 3 outposts, each with an xp boost of 2, the player's XP boost will effectively be 8x.

spawner-boosts-accumulate

Same as xp-boosts-accumulate but with spawners.


progress-bar Section

This section defines the progress bar used for displaying the status of the outpost to players on the capture point.


gui Section

This GUI is used for players that use the /outpost command. The available placeholders are: * {CAP_PERCENT_OUTPOST} * {STATUS_OUTPOST} * {CONTROLLING_OUTPOST} * {ATTACKING_OUTPOST}


outposts Section

This section defines all outposts active on the server and the structure of them. Here's the default one:

    castle:
      corner-one: 50:50:50:world
      corner-two: 55:55:55:world
      on-capture-commands:
      - 'eco give {LEADER} 10000'
      capture-cooldown-seconds: 60
      perks:
        sell-boost:
          amount-boost: 1.5
          prevent-sell-higher-than-buy: true
        xp-boost:
          amount-boost: 2.0
        give-money:
          interval-minutes: 10
          amount: 50000
        spawner-boost:
          amount-boost: 1.3
        cmd-runner:
          cmds:
            - 'eco give {LEADER} 50000:5'
            - 'eco give {LEADER} 100000:30'
        pot-effects:
          REGENERATION: 1
        pot-effects-disabled-worlds:
          - 'arena-world'
The primary values of note are corner-one and corner-two. These define the bounds of the capture point.

capture-cooldown-seconds

The time in seconds that an outpost remains immune to attacks after capture.

on-capture-commands

These commands are ran when a faction has captured the outpost.

The perks section defines the perks of controlling the outpost.

sell-boost

This defines a boost for selling items within the shop. Note that prevent-sell-higher-than-buy will dynamically prevent items from being sold for more than their buy price. This should prevent shop exploits.

xp-boost

A boost for XP gained from killing mobs.

give-money

Gives the defined amount of money per interval to the faction's leader.

spawner-boost

A boost for spawner speed.

cmd-runner

The commands in the list are formatted as fully formatted command:interval where interval is the time in minutes between runs. You can use the following placeholders in each command * {LEADER} Faction leader's name * {ONLINE_LEADER} Faction leader's name if the leader is online, otherwise the empty string * {FACTION} The tag of the faction * {FACTION_ID} The id of the faction * {ALL_ONLINE} This will make the command run for every online player in the faction, replacing itself for each run with a different member

pot-effects

A section defining potion effects to give all members of the controlling faction.

pot-effects-disabled-worlds

A list of worlds in which the players won't receive the potion effects from this outpost.

Command

  • /outpost - Opens the outpost GUI.
  • /outpost list - Lists all outposts the sender's faction has controlled.
  • /outpost top [outpost=all] - Lists top capture times for all, or a specific, outpost(s).
  • /outpost forfeit (outpost) - Forfeits control of the given outpost. If the sender has the admin permission, control is not needed.
  • /outpost listadmin - Lists all outposts and their statuses.
  • /outpost setcap (outpost) (amount) - Sets the capture amount of the given outpost.

Permissions

  • Base Level - Some commands.
  • Admin Level - Some commands.