RedisBungee/README.md

141 lines
5.4 KiB
Markdown
Raw Normal View History

2022-06-17 01:08:29 +00:00
# RedisBungee fork By Limework
2022-07-21 12:23:07 +00:00
The original project of RedisBungee is no longer maintained, so we have forked the plugin.
2022-03-22 12:57:07 +00:00
2022-07-21 12:23:07 +00:00
RedisBungee uses [Redis](https://redis.io) with Java client [Jedis](https://github.com/redis/jedis/)
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-21 12:23:07 +00:00
with critical bugs fixed, please use version [0.6.5](https://github.com/ProxioDev/RedisBungee/releases/tag/0.6.5) and java docs For legacy Version [0.6.5](https://proxiodev.github.io/RedisBungee-JavaDocs/0.6.5-SNAPSHOT/)
as its last version before internal changes. please note that you will not get support for any old builds unless critical bugs effecting both effect his version and 0.7.0 or above.
2022-07-08 04:15:42 +00:00
2022-07-21 12:23:07 +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*
[Click here, for more information about transfer packet](https://hypixel.net/threads/why-do-we-need-transfer-packets.1390307/)
2022-07-03 13:31:38 +00:00
2022-07-21 12:23:07 +00:00
SpigotMC resource page: [click](https://www.spigotmc.org/resources/redisbungee.87700/)
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 | ✔ |
2022-06-17 02:10:29 +00:00
| 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:09:04 +00:00
## Getting the latest commits to your code
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
```
2022-07-16 03:09:04 +00:00
then use any of these in your project.
2022-07-16 03:06:30 +00:00
```
<dependency>
<groupId>com.imaginarycode.minecraft</groupId>
<artifactId>RedisBungee-Bungee</artifactId>
<version>VERSION</version>
<scope>provided</scope>
</dependency>
2022-07-16 03:09:04 +00:00
```
```
2022-07-16 03:06:30 +00:00
<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/)
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)