RedisBungee/README.md

143 lines
5.0 KiB
Markdown
Raw Normal View History

2022-06-17 01:08:29 +00:00
# RedisBungee fork By Limework
2022-03-22 12:57:07 +00:00
2021-01-10 19:38:14 +00:00
Spigot link: [click](https://www.spigotmc.org/resources/redisbungee.87700/)
2022-04-13 08:22:35 +00:00
The main project of RedisBungee is no longer maintained, so we have forked the plugin.
2021-01-07 17:23:31 +00:00
2022-07-08 04:07:50 +00:00
*if you are here for transferring players to another proxy when the first proxy crashes or whatever this plugin won't do it, tell mojang to implement transfer packet*
2022-06-30 21:24:48 +00:00
2022-07-09 19:53:50 +00:00
RedisBungee uses [Redis](https://redis.io) to Synchronize players data between [BungeeCord](https://github.com/SpigotMC/BungeeCord) or [Velocity*](https://github.com/PaperMC/Velocity) proxies
2021-01-07 17:23:31 +00:00
Velocity*: *version 3.1.2 or above is only supported, any version below that might work but might be unstable* [#40](https://github.com/ProxioDev/RedisBungee/pull/40)
2022-07-08 04:14:22 +00:00
2022-07-08 04:07:50 +00:00
If you are looking to use Original RedisBungee without a change to internals,
2022-07-08 04:14:22 +00:00
with critical bugs fixed, please use version [0.6.5](https://github.com/ProxioDev/RedisBungee/releases/tag/0.6.5)
as its last version before internal changes.
2022-07-08 04:15:42 +00:00
2022-07-03 13:31:38 +00:00
2022-06-17 02:03:56 +00:00
## Supported Redis versions
| Redis version | Supported |
2022-06-17 02:10:29 +00:00
|:-------------:|:---------:|
| 1.x.x | ✖ |
| 2.x.x | ✖ |
| 3.x.x | ✖ |
| 4.x.x | ✖ |
| 5.x.x | ✖ |
| 6.x.x | ✔ |
| 7.x.x | ✔ |
2022-06-17 02:03:56 +00:00
2022-05-26 01:02:31 +00:00
## Implementing RedisBungee in your plugin: [![RedisBungee Build](https://github.com/proxiodev/RedisBungee/actions/workflows/maven.yml/badge.svg)](https://github.com/Limework/RedisBungee/actions/workflows/maven.yml) [![](https://jitpack.io/v/limework/redisbungee.svg)](https://jitpack.io/#limework/redisbungee)
RedisBungee is distributed as a [maven](https://maven.apache.org) project.
2022-07-16 03:06:30 +00:00
By using jitpack [![](https://jitpack.io/v/limework/redisbungee.svg)](https://jitpack.io/#limework/redisbungee)
2022-05-26 01:02:31 +00:00
## Setup jitpack repository
2022-05-26 01:02:31 +00:00
```
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
```
## [BungeeCord](https://github.com/SpigotMC/BungeeCord)
add this in your project dependencies
2022-05-26 01:02:31 +00:00
```
<dependency>
<groupId>com.github.limework.redisbungee</groupId>
<artifactId>RedisBungee-Bungee</artifactId>
2022-06-30 11:03:16 +00:00
<version>VERSION</version>
2022-05-27 13:05:01 +00:00
<scope>provided</scope>
2022-05-26 01:02:31 +00:00
</dependency>
```
then in your project plugin.yml add `RedisBungee` to `depends` like this
```
name: "yourplugin"
main: your.main.class
version: 1.0.0-SNAPSHOT
author: idk
depends: [ RedisBungee ]
```
## [Velocity](https://github.com/PaperMC/Velocity)
```
<dependency>
<groupId>com.github.limework.redisbungee</groupId>
<artifactId>RedisBungee-Velocity</artifactId>
<version>VERSION</version>
<scope>provided</scope>
</dependency>
```
then to make your plugin depends on RedisBungee, make sure your plugin class Annotation have `@Dependency(id = "redisbungee")` like this
```
@Plugin(
id = "myplugin",
name = "My Plugin",
version = "0.1.0-beta",
dependencies = {
@Dependency(id = "redisbungee")
}
)
public class PluginMainClass {
}
```
2022-07-16 03:06:30 +00:00
If you want to use the latest commits without waiting for releases.
first, install it to your maven local repo
```
git clone https://github.com/ProxioDev/RedisBungee.git
cd RedisBungee
mvn clean install
```
then use any of these to your project.
```
<dependency>
<groupId>com.imaginarycode.minecraft</groupId>
<artifactId>RedisBungee-Bungee</artifactId>
<version>VERSION</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>com.imaginarycode.minecraft</groupId>
<artifactId>RedisBungee-Velocity</artifactId>
<version>VERSION</version>
<scope>provided</scope>
</dependency>
```
2022-05-26 01:02:31 +00:00
## Javadocs
2022-05-26 00:50:08 +00:00
2022-07-15 22:33:58 +00:00
For current version [0.8.0](https://proxiodev.github.io/RedisBungee-JavaDocs/0.8.0-SNAPSHOT/)
For legacy Version [0.6.5](https://proxiodev.github.io/RedisBungee-JavaDocs/0.6.5-SNAPSHOT/)
2021-01-07 17:32:24 +00:00
2013-09-29 20:22:52 +00:00
## Configuration
2022-07-08 04:07:50 +00:00
**REDISBUNGEE REQUIRES A REDIS SERVER**, preferably with reasonably low latency. The default [config](https://github.com/ProxioDev/RedisBungee/blob/develop/RedisBungee-API/src/main/resources/example_config.yml) is saved when the plugin first starts.
2021-01-07 17:28:50 +00:00
2021-01-07 17:32:24 +00:00
## License!
2021-01-07 17:28:50 +00:00
This project is distributed under Eclipse Public License 1.0
2021-01-07 17:28:50 +00:00
2022-04-13 08:22:35 +00:00
You can find it [here](https://github.com/proxiodev/RedisBungee/blob/master/LICENSE)
2021-01-07 17:28:50 +00:00
You can find the original RedisBungee by Tux [here](https://github.com/minecrafter/RedisBungee) or spigot page [here](https://www.spigotmc.org/resources/redisbungee.13494/) "**NO LONGER WORKS**"
2021-05-23 20:45:13 +00:00
2022-03-22 11:28:41 +00:00
## Support
You can join our matrix room [here](https://matrix.to/#/!zhedzmRNSZXfuOPZUB:govindas.net?via=govindas.net&via=matrix.org)
![icon](https://matrix.org/images/matrix-logo-white.svg)
2021-05-23 20:45:13 +00:00
## YourKit
YourKit supports open source projects with innovative and intelligent tools for monitoring and profiling Java and .NET applications. YourKit is the creator of [YourKit Java Profiler](https://www.yourkit.com/java/profiler/), [YourKit .NET Profiler](https://www.yourkit.com/.net/profiler/) and [YourKit YouMonitor](https://www.yourkit.com/youmonitor/).
![YourKit](https://www.yourkit.com/images/yklogo.png)