Raid Outpost - A Factions Addon - Create Unlimited Raid Outposts. icon

Raid Outpost - A Factions Addon - Create Unlimited Raid Outposts. -----

Add raid outposts to your factions server.

Download Now
59 KB .jar


_sTW5ymRRwym5a7J0mxpPA.jpg



This plugin supports FactionsUUID on versions less than 4.0 and SaberFactions. It has support for paper spigot/wine spigot but you have to enable this in the config. I am not opposed to adding support for other factions plugins but you will have to give me a message on what factions plugin/version you need supported.
⚔️ RaidingOutpost - The Ultimate Factions PvP Event Plugin


RaidingOutpost brings the high-stakes, destructive PvP action from top Factions servers directly to your network. Set up dynamic, automatically resetting capture points that reward the most powerful factions with valuable, recurring loot and prestige!



Core Gameplay Loop


  1. Preparation: Players are alerted via server broadcast that a new raid window has begun, usually after a Hard Reset (see below).

  2. Raid Initiation: Factions travel to the Outpost location (/rpost for quick teleport).

  3. Destructive Claiming: The Raiding Outpost is protected by a configured system faction. To successfully breach and claim, the attacking faction must meet a specific condition:
    • Faction-Authorized TNT: All TNT used to destroy the base must be dispensed or placed from within a claim belonging to the attacking Faction. This mechanism is tracked by the plugin ensure the legitimately raiding Faction gets credit for the raid.
  4. Ownership & Rewards: Once successfully claimed, the new owning Faction immediately receives a One-Time Reward and begins accruing Recurring Rewards on a timer for the duration of their control.

  5. Defense & Contest: The owning Faction must now defend the Outpost, as enemy Factions will continuously attempt to claim it for themselves.


Key Features


  • FactionsUUID + SaberFactions Integration
    • This plugin is built specifically for and only supports FactionsUUID and now SaberFactions currently
  • TNT Ownership Tracking
    • Ensures Fair Raiding: Prevents "griefing" by requiring that all offensive TNT deployed is linked to an existing Faction claim. This is how the plugin determines which Faction is actively trying to claim the Raid Outpost.
  • Automated Hard Resets with Template
    • Raid Outposts are configured to undergo a Hard Reset on a set daily or weekly interval (reset-interval-days).

    • The World Reset Utility handles the reset live, including teleporting players out and restoring the Outpost world to its original state by copying a template folder from the plugin directory.

    • The world also resets when an enemy faction claims the Raid Outpost.
  • Tiered & Recurring Rewards
    • Passive/Recurring Rewards: Owners can claim valuable rewards (money, keys, commands) on a set time interval.

    • One-Time Rewards: Rewards claimable only once immediately after a successful capture.
  • Raid Outpost World Claim Limits
    • Control power-claiming by limiting the maximum number of surrounding claims a single faction can place in the Outpost's world (max-claims-per-faction).
  • Interactive GUI Menu (/rpost)
    • Players can open a main selector GUI to view the real-time status of all outposts and quickly teleport to them. They use this GUI to collect their rewards as well.


️ Setup Instructions (Crucial Steps!)


Prerequisite: You must have a compatible version of FactionsUUID or SaberFactions installed on your server.

Step 1: Raid Outpost World Design Requirements

The plugin relies on a specific world setup for proper function. Your Raid Outpost build and world must adhere to the following:

  • Center at (0,0): The physical center of your Raid Outpost base must be placed at the world coordinates X=0, Z=0 in the specified world.
    • This ensures that the central chunk claimed by the Raid Outpost exactly covers the base.

    • The plugin assumes that your configured world border is centered around (0,0) so the Outpost is perfectly in the middle of the warzone.
    • Make sure that you look into each of the config options, they are very important for having the exactly correct settings for your outpost.
    • Note that the faction land claim coordinates are based on chunks (chunk coordinates), and the base region coordinates are normal coordinates.
Step 2: Crucial World Template Setup (Mandatory for Resets!)

The World Reset Utility uses a complete copy of your outpost's world as a template to instantly restore the base.

  1. Create your raid outpost world that players will teleport to in order to raid the base and build the base centered around 0,0,0.

  2. Create a clean, exact copy of this active world folder.

  3. Rename the copied folder to be prefixed with template_ followed by the active world name.
    • Example: If your active world is warzone, the template folder must be named template_warzone.
  4. Place the renamed template folder (template_warzone) inside the plugin's data directory: plugins/RaidingOutpost/.
If the template folder is missing, the automated timed resets and the admin /rpost reset command will fail, and the Raid Outpost will not restore its structure.



️ Admin Commands


Command Description Permission
/rpost or /raidingoutpost Opens the main Outpost Selector GUI. (None - Default)
/rpost reset <key> Forceful Hard Reset: Resets the outpost's world and clears its owner without stopping the server. raidingoutpost.admin
/rpost setowner <key> <tag/id> Forcefully sets the owner of the specified outpost. raidingoutpost.admin
/rpost setgrace <key> <minutes> Set the grace period duration for the specified outpost. raidingoutpost.admin
/rpost info <key> Displays detailed status information for an outpost. raidingoutpost.admin



Config.yml:

Code (Text):

# ----------------------------------------------------
# Global Settings
# ----------------------------------------------------
settings:
  global-check-interval-minutes: 10
  rewards-check-interval-minutes: 5
  world-border-radius: 1000
  paper-fork: false
  saber-impl: false
  old-factions-impl: false

# ----------------------------------------------------
# Global GUI Configuration
# ----------------------------------------------------
gui:
  selector_title: "&4Raiding Outpost Selector"
 
# ----------------------------------------------------
# Global Messages
# ----------------------------------------------------
messages:

  reward_not_found: "&cError: Reward ID '&e%reward_id%&c' not found for this outpost."
  config_data_missing: "&cError: Internal config data for rewards is missing. Contact an admin."
  reward_cooldown: "&cThis recurring reward is still on cooldown! Time remaining: &e%time_remaining%&c."
  reward_claimed_recurring: "&aYou successfully claimed the recurring reward: &e%reward_id%&a!"
  reward_already_claimed_one_time: "&cYou have already claimed the one-time reward: &e%reward_id%&c."
  reward_claimed_one_time: "&aYou successfully claimed the one-time reward: &e%reward_id%&a!"

  broadcast_hard_reset: "&c&lRAIDING OUTPOST: &6%outpost_name% &ehas reset! A new raid window has begun!"

  claim_limit_reached: "&cYour faction has reached the maximum claim limit (&e%max_claims%&c) in the &e%outpost_name%."

  teleport_fail: "&cCould not find a safe location to teleport. Try again later."
  teleport_success: "&aTeleported to the &e%outpost_name% &awarzone!"
  reward_claim_owner_only: "&cOnly members of the controlling faction can claim rewards."

# ----------------------------------------------------
# Define Individual Outposts Here
# ----------------------------------------------------
Outposts:
  Desert_Pyramid:
    outpost-name: "Desert Pyramid"
    world-name: raidoutpost_l1
    reset-interval-days: 7
    grace-duration-minutes: 30
    max-claims-per-faction: 15
 
    faction-settings:
      # Configuration for the neutral/owner-proxy faction
      outpost-faction:
        name: "Desert_Pyramid"
        tag: "&2[OP]"
        description: "Faction used to proxy ownership of Raiding Outposts."
 
    base-region:
      x1: -32
      x2: 32
      y1: 0
      y2: 256
      z1: -32
      z2: 32
    claim-region:
      x1: -1
      x2: 0
      z1: -1
      z2: 0

    rewards:
      claim-commands:
        - id: "money_passive"
          command: "eco give {player} 5000"
          type: "RECURRING"
          interval-minutes: 60
        - id: "key_bonus"
          command: "key give {player} Basic 1"
          type: "ONE_TIME"

    state:
      owner-faction-id: ""
      capture-start-time: 0
      next-reset-time: "2025-11-16T21:00:00"
      grace-period-end: "2025-11-09T20:30:00"
      claimed-rewards-data:
        money_passive: 0
     
    menu-titles:
      options_title: "&4Desert Pyramid Outpost Options"
      rewards_title: "&bDesert Pyramid Rewards Store"
     
    # Per-Outpost Selector GUI Items
    gui-selector:
      item_claimed:
        material: GOLD_BLOCK # 1.8
        name: "&6Desert Pyramid (CLAIMED)"
        lore:
          - "&7Owner: &f%owner_tag%"
          - "&7Control Time: &f%control_duration%"
          - "&7Next Reset: &f%reset_time%"
          - ""
          - "&eClick to view options!"
      item_active:
        material: REDSTONE_BLOCK
        name: "&6Desert Pyramid (ACTIVE)"
        lore:
          - "&7Status: &cUnclaimed - Ready for capture!"
          - "&7Next Reset: &f%reset_time%"
          - ""
          - "&eClick to view options!"
       
    # Outpost-Specific Options GUI Items/Slots
    gui-options:
      item_border:
        slot: 4
        material: COAL_BLOCK
        name: " "
        clickable: false
     
      option_item_stats:
        slot: 12
        material: PAPER
        name: "&6Outpost Statistics"
        clickable: true
        lore:
          - "&7Owner: &f%owner_tag%"
          - "&7Grace Period: &f%grace_period_status%"
          - "&7Reset Interval: &f7 days"
       
      option_item_rewards_selector:
        slot: 14
        material: DIAMOND_BLOCK
        name: "&bClaim Rewards"
        clickable: true
        lore:
          - "&7Status: &eOnly Faction Members can claim."
          - ""
          - "&aClick to view and claim rewards!"
       
      option_item_teleport:
        slot: 22
        material: ENDER_PEARL
        name: "&dTeleport to Warzone"
        clickable: true
        lore:
          - "&7Note: Teleports to a random location"
          - "&7in the warzone area."
          - ""
          - "&eClick to teleport!"

    # Per-Outpost Rewards GUI Items/Slots
    gui-rewards:
      item_back_button:
        slot: 31
        material: ARROW
        name: "&cReturn to Options"
        clickable: true
        lore:
          - "&7Go back to the main menu."

      item_fill_left:
        slot: 1
        material: IRON_BLOCK
        name: " "
        clickable: false
     
      reward_money_passive:
        id: "money_passive"
        slot: 10
        material: GOLD_INGOT
        name: "&aPassive Money Reward"
        clickable: true
        lore:
          - "&7Type: &eRecurring"
          - "&7Amount: &f5000"
          - "&7Claim Interval: &f%interval_minutes% minutes"
          - "&7Status: %status%"
          - "&6Next Claim In: &e%time_until_next_claim%"
          - "&6Accumulated Claims: &e%accumulated_claims%"
          - ""
          - "&eClick to claim available rewards!"
       
      reward_key_bonus:
        id: "key_bonus"
        slot: 11
        material: CHEST # 1.8
        name: "&6One-Time Key Bonus"
        clickable: true
        lore:
          - "&7Type: &bOne-Time"
          - "&7Reward: &fBasic Key x1"
          - "&7Status: %status%"
          - ""
          - "&aClick to claim now!"
       
  Coastal_Fortress:
    outpost-name: "Coastal Fortress"
    world-name: raidoutpost_l2
    reset-interval-days: 14
    grace-duration-minutes: 60
    max-claims-per-faction: 10
 
    faction-settings:
      # Configuration for the neutral/owner-proxy faction
      outpost-faction:
        name: "Coastal_Fortress"
        tag: "&2[OP]"
        description: "Faction used to proxy ownership of Raiding Outposts."
 
    base-region:
      x1: -32
      x2: 32
      y1: 0
      y2: 256
      z1: -32
      z2: 32
    claim-region:
      x1: -1
      x2: 0
      z1: -1
      z2: 0
     
    rewards:
      claim-commands:
        - id: "money_passive"
          command: "eco give {player} 10000"
          type: "RECURRING"
          interval-minutes: 60
        - id: "key_bonus"
          command: "key give {player} Legendary 1"
          type: "ONE_TIME"

    state:
      owner-faction-id: ""
      capture-start-time: 0
      next-reset-time: "2025-11-16T21:00:00"
      grace-period-end: "2025-11-09T20:30:00"
      claimed-rewards-data:
        money_passive: 0
     
    menu-titles:
      options_title: "&3Coastal Fortress Controls"
      rewards_title: "&aFortress Loot Vault"
       
    # Per-Outpost Selector GUI Items
    gui-selector:
      item_claimed:
        material: QUARTZ_BLOCK
        name: "&3Coastal Fortress (CLAIMED)"
        lore:
          - "&7Owner: &f%owner_tag%"
          - "&7Control Time: &f%control_duration%"
          - "&7Next Reset: &f%reset_time%"
          - ""
          - "&eClick to view options!"
      item_active:
        material: OBSIDIAN
        name: "&3Coastal Fortress (ACTIVE)"
        lore:
          - "&7Status: &cUnclaimed - Ready for capture!"
          - "&7Next Reset: &f%reset_time%"
          - ""
          - "&eClick to view options!"

    # Custom Slots and Items for outpost Options
    gui-options:
      item_separator:
        slot: 13
        material: STONE
        name: "&7---"
        clickable: false
     
      option_item_stats:
        slot: 10
        material: BOOK
        name: "&3Fortress Data"
        clickable: true
        lore:
          - "&7Current Owner: &f%owner_tag%"
          - "&7Interval: &f14 days"
   
      option_item_rewards_selector:
        slot: 16
        material: EMERALD_BLOCK
        name: "&aClaim Fortress Riches"
        clickable: true
        lore:
          - "&7Status: &eOnly Faction Members can claim."
          - ""
          - "&aClick to view rewards!"
       
      option_item_teleport:
        slot: 24
        material: COMPASS
        name: "&dTeleport to Fortress"
        clickable: true
        lore:
          - "&7Travel to the warzone."
          - ""
          - "&eClick to teleport!"
       
    # Per-Outpost Rewards GUI Items/Slots
    gui-rewards:
      item_back_button:
        slot: 31
        material: ENDER_CHEST
        name: "&5Return to Controls"
        clickable: true
        lore:
          - "&7Go back to the main menu."

      reward_money_passive:
        id: "money_passive"
        slot: 10
        material: DIAMOND
        name: "&bHigh Value Money Reward"
        clickable: true
        lore:
          - "&7Type: &eRecurring"
          - "&7Amount: &f10000"
          - "&7Claim Interval: &f%interval_minutes% minutes"
          - "&7Status: %status%"
          - "&6Next Claim In: &e%time_until_next_claim%"
          - "&6Accumulated Claims: &e%accumulated_claims%"
          - ""
          - "&eClick to claim available rewards!"
      reward_key_bonus:
        id: "key_bonus"
        slot: 12
        material: TRIPWIRE_HOOK
        name: "&eLegendary Key Bonus"
        clickable: true
        lore:
          - "&7Type: &bOne-Time"
          - "&7Reward: &fLegendary Key x1"
          - "&7Status: %status%"
          - ""
          - "&aClick to claim now!"
 
View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 12
First Release: Nov 23, 2025
Last Update: Nov 29, 2025
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings