Skip to content

csh/minecraft-rebel-plugin

Repository files navigation

minecraft-rebel-plugin

Travis GitHub tag Github All Releases Donate

A JRebel plugin for automatically reloading Bukkit and BungeeCord plugins as their classes are recompiled.

This project is by no means about money, don't think that I won't support people who elect to not donate.

License

Copyright (C) 2016 Connor Spencer Harries

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Usage

Setup the JRebel agent as you normally would. If you do not know how to do this please refer to the official guide. Support will not be provided for anything other than this plugin.

Setting the plugin up is simple, simply place the JAR for the plugin you are using in a location you will remember and update your startup arguments.

BungeeCord

-Drebel.plugins=path/to/bungee-rebel-plugin.jar -Drebel.bungee=true

Bukkit

-Drebel.plugins=path/to/bukkit-rebel-plugin.jar -Drebel.bukkit=true

If done correctly you should see the following message appear in stdout, though obviously the timestamp will be different.

2016-02-12 13:21:02 JRebel: Plugins will be reloaded when class changes are detected.

Now you simply compile classes like normal and wait for JRebel to reload them, when a reload occurs then the plugin you installed will kick in and attempt to reload any Bukkit or Bungee plugins that use the reloaded class.

Recommendation

As far as I'm aware it is not possible to reload shaded dependencies using JRebel, for this reason I advise you to use Gradle's distribution plugin or Maven's dependency plugin (org.apache.maven.plugins:maven-dependency-plugin) plugin to copy dependency JARs into the classpath prior to launching the server with JRebel. Once you finish writing your code you can enable dependency shading once more for a pain-free experience.

About

JRebel plugin for reloading Bukkit and BungeeCord plugins.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages