Skip to content

Alathra/RaidsPerRegion

Repository files navigation

RaidsPerRegion4

GitHub License GitHub Downloads (all assets, all releases) GitHub Release GitHub Actions Workflow Status GitHub Issues or Pull Requests GitHub last commit

RaidsPerRegion


Description

RaidsPerRegion adds a customizable PvE (Player v.s. Enviornment) server event/minigame that takes inspiration from plugins like MobArena and the vanilla Minecraft pillager raids. The name "RaidsPerRegion" refers to the fact that it adds dynamic mob "Raids" that can be started via commands in areas, or "Regions". The word "region" here is a reference to a WorldGuard region, which is the standard raid area type supported by the plugin. Additional (optional) raid types are also supported for other plugins such as Towny and Factions. RaidsPerRegion does not support vanilla mobs and instead uses MythicMobs as a base for for defining Raid mobs.


Dependencies/Hooks

Dependencies

Optional Hooks

  • Adds the ability to start raids on Factions.
  • Adds the ability to start raids on Kingdoms.
  • Adds the ability to start raids on Towns.

Oveview

What is a Raid?

A RaidsPerRegion "Raid" is a timed server event/minigame where players must kill a certain amount of mobs before the timer runs out or they will lose the raid. The Raids itself is more of a template, so how they are used and the purpose they serve is entirely up to the admins or gameplay designers of your Minecraft server. On the Alathra server for example, Raids are executed randomly on player settlements (Towny towns) in order to introduce a fun PvE challenge and provide players unique items through mob drops and Raid rewards. RaidsPerRegion is not designed to be plug-and-play software, and should be configured to achieve the best results. Fortunately, Raids are composed of dynamic and extendable components, making them relatively easy to modify to meet your specific needs.

Raid Presets

Raid Presets define the what mobs will spawn in the raid and their details. This includes things such as mob levels, spawn chances/weights and an optional boss mob. This allows you to create infinite "kinds" of raids, with one being selected when starting a new raid. Presets are pre-defined in the config.yml.

Raid Tiers

Raid Tiers define how hard the raid will be as well as general raid parameters. This is where the time limit, kills goal (mobs kills needed to win), spawn rates and other settings can be found. This allows you to create infinite "levels" of raids. Tiers are pre-defined in the config.yml.

Raid Scheduler

Raids can be scheduled to execute at set number of minutes from when the start command is run. Announcement messages can be configured in the config.yml that can be used to warn players before a raid starts. Since Raids can be started by console, it is possible to schedule raids via a scheduled task on your server panel or server's operating system.


Permissions & Commands

Permissions

RaidsPerRegion adds the following permission node(s):

  • raidsperregion.admin Grants the user the ability to start, stop and list raids

Commands

RaidsPerRegion adds the following commands:

  • /raid start [area_type] [world] [area_name] <raid_preset> <raid_tier> <scheduled_minutes> Starts a raid with the given parameters. [] indicates a required argument and <> indicates an optional argument. Selecting "random" for the area_name will pick a random area of the defined type in the defined world.
  • /raid stop [area_name] Stops an ongoing or scheduled raid.
  • /raid list Lists all ongoing and scheduled raids.

Configuration

RaidsPerRegion can be configured by editing values in the config.yml. RaidsPerRegion does not have a reload command because it automatically checks for updates in the config file. When you make edits to the file the changes will be applied immediately.

About

No description, website, or topics provided.

Resources

License

Code of conduct

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Languages