https://github.com/StrayVibes/LargeRaids-master
LargeRaids Remastered For 1.19.2
https://github.com/StrayVibes/LargeRaids-master
Last synced: 5 months ago
JSON representation
LargeRaids Remastered For 1.19.2
- Host: GitHub
- URL: https://github.com/StrayVibes/LargeRaids-master
- Owner: UnStackss
- License: gpl-3.0
- Created: 2022-10-30T15:12:27.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2022-11-06T12:39:47.000Z (over 3 years ago)
- Last Synced: 2024-11-11T07:42:45.377Z (about 1 year ago)
- Language: Java
- Size: 164 MB
- Stars: 0
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## LargeRaids By SolarRabbit Remastered By MyNameIsKiyoshi (Kiyoshi - Kiyoshi#8862)
## Updated To (1.19.2 Support) ⚠ This Version Works Only In 1.19.2 With JDK 18 ⚠
## Discord Support : https://discord.gg/ka7uGKfy7p
[](https://github.com/zhenghanlee/LargeRaids-API)
[](https://www.codacy.com/gh/zhenghanlee/LargeRaids/dashboard?utm_source=github.com&utm_medium=referral&utm_content=zhenghanlee/LargeRaids&utm_campaign=Badge_Grade)
[](https://img.shields.io/github/license/zhenghanlee/LargeRaids)
[](https://www.spigotmc.org/resources/largeraids-1-14-x-1-17-x.95422/)
[](https://img.shields.io/github/commit-activity/m/zhenghanlee/LargeRaids)
[](https://discord.gg/YSv7pptDjE)
**LargeRaids** is a vanilla Spigot game experience enhancement plugin for [raids](https://minecraft.fandom.com/wiki/Raid), which are added to the game in the _Village & Pillage Update_. It expands the raid's mechanism to accommodate for the multiplayer environment with higher difficulty, higher bad omen levels, more raiders, more waves and higher rewards.
## Server Requirements
- Version: 1.14.4, 1.15.2, 1.16.5, 1.17.1, 1.18.1
## Statistics
[](https://bstats.org/plugin/bukkit/LargeRaids/13910)
## Installation
If you wish to install the repository locally, you might want to first install the [remapped jars](https://www.spigotmc.org/threads/spigot-bungeecord-1-17-1-17-1.510208/#:~:text=In%20order%20to%20assist%20developers%20with%20the%20transition%20we%20have%20added%20an%20additional%20option%20to%20BuildTools%2C%20%2D%2Dremapped) for versions 1.17.1 and 1.18 via [BuildTools](https://hub.spigotmc.org/jenkins/job/BuildTools/). Afterwhich, follow these steps to ensure that the project builds correctly.
1. Open up Terminal
2. Change to any desired directories for cloning the repository
3. Run `git clone https://github.com/zhenghanlee/LargeRaids.git`
4. Run `cd ./LargeRaids` to head into the project directory
5. Run `mvn install` to install the project locally and build the jar file (named `LargeRaids.jar`) in `target` folder
## Using the API
The API for the plugin has a separate [repository](https://github.com/zhenghanlee/LargeRaids-API). The instructions are duplicated here for your convenience.
### Maven Repository
You can add the project as your dependency by including the JitPack repository in your `pom.xml`:
```xml
jitpack.io
https://jitpack.io
```
Then after add the dependency like so (replace `VERSION` with the version provided by the jitpack badge located at the start of this document):
```xml
com.github.zhenghanlee
LargeRaids-API
VERSION
```
### Gradle Repository
You can add the project as your dependency by including the JitPack repository:
```gradle
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
```
Then after add the dependency like so (replace `VERSION` with the version provided by the jitpack badge located at the start of this document):
```gradle
dependencies {
implementation 'com.github.zhenghanlee:LargeRaids-API:VERSION'
}
```
### Example Usage
#### Getting the Plugin
```java
Plugin plugin = Bukkit.getPluginManager().getPlugin("LargeRaids");
if (plugin != null) {
LargeRaids lr = (LargeRaids) plugin;
// Rest of the operations here
}
```
#### Getting Corresponding LargeRaid
A LargeRaid object can be obtained from either a Bukkit's `Location` or Bukkit's `Raid` instance.
```java
RaidManager raidManager = lr.getRaidManager(); // where lr is a LargeRaids instance
Optional raid = raidManager.getLargeRaid(location);
```
#### Getting Player Kills
We can get the number of kills a player have in a large raid when it finishes (or any time of the raid) as follows:
```java
@EventHandler
public void onRaidFinish(RaidFinishEvent evt) {
Raid raid = evt.getRaid(); // Vanilla raid
if (raid.getStatus() != RaidStatus.VICTORY)
return;
Optional largeRaid = raidManager.getLargeRaid(raid);
if (!largeRaid.isPresent()) // No corresponding LargeRaid instance
return;
Optional killCount = largeRaid.map(LargeRaid::getPlayerKills)
.map(map -> map.get(player.getUniqueId()));
if (!killCount.isPresent()) // Player is not a hero of this raid
return;
// Perform operations with the kill count (e.g. rewarding players based on kill count)
}
```