RPG Regen icon

RPG Regen -----

The Best Configurable RPG Health Regen System




What's New
  • RPGRegen now runs on Spigot 1.12.2 and Spigot 1.17 to 1.21.5
Fixes
  • Now properly works on advertised as compatible versions
Notes
  • ⚠️ Older versions than 1.12.2 have not been re-tested
  • ⚠️ Versions between 1.12.2 and 1.17 (excluded) will not work
  • ❓ Not tested with Paper Spigot
  • ☕ Now requires Java 16+ (was 17+)
I will try to keep this repository updated but there is no guarantee of continued updates.
----------, Jun 14, 2025

What's New
- RPGRegen now runs on Spigot servers up to version 1.21.5
- The project is now public and licensed under Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)

Fixes
- General code cleanup
- Modularized the project for better API version management

Notes
- ✅ Compatible with Minecraft 1.21.5 and prior versions of the game
- ⚠️ Older versions than 1.18.2 have not been re-tested
- ⚠️ Some features remain untested, but are expected to behave as before
- ❓ Not tested with Paper Spigot
- ☕ Requires Java 17+

---

I will try to keep this repository updated but there is no guarantee of continued updates.
----------, Jun 12, 2025

I've re written the entire plugin and made sure it works on Minecraft 1.19.4. It should work with versions 1.17 to 1.20 as I'm not using version dependent classes in the code. As for older versions (prior to 1.17) I don't intend to test it. If there's a high enough demand I'll see what I can do to allow RPGRegen to work on old Minecraft versions.

Also, I changed the url of the source code to a new one containing the entirety of the code. I'll include a README.md file soon enough.

Regarding configurations most of the old options exist but with some minor changes (I'll add particle animations back later).

If you encounter issues prioritize the Github issue section by opening a ticket.

I hope the plugin will please old and new users!
----------, Jun 7, 2023

Update:
  • Upgraded plugin's build for a better 1.16 version support
----------, Nov 13, 2020

Update:
  • Added the possibility to choose what lingering/splash potion put players in combat
Important note:
  • If you have downloaded a previous version and wish to update, you have to update your config file. If you don't, the plugin will throw errors!
Copy/paste the following in the Potions Options section of your config file to update it if needed :

Code (YAML):
#List of all the splash potion effects that would put a player in combat if any-potion is set to false
splash-potion-list
:
 - INSTANT_DAMAGE

#List of all the lingering potion effects that would put a player in combat if any-potion is set to false
lingering-potion-list
:
 - INSTANT_DAMAGE
Please if you notice any bug, let me know in the discussion section.
----------, Sep 27, 2019

Important update:
  • I've re-written the entire plugin-in and greatly improved its functionalities (not in term of content but in term of performance and code reusability/readability). The reload command should be way more efficient and cause much less strange behaviors or issues
Please if you notice any bug, let me know in the discussion section, especially after such code modification.
----------, Aug 21, 2019

Update:
  • Added the possibility to choose if players are in combat or not when throwing a splash/lingering potion
Important note:
  • If you have downloaded a previous version and wish to update, you have to update your config file. If you don't, the plugin will throw errors!
Copy/paste the following in the Potions Options section of your config file to update it if needed :

Code (YAML):
#If set to true, throwing any splash potion will put players in combat
is-splash-fighting
: false

#If set to true, throwing any lingering potion will put players in combat
is-lingering-fighting
: true
Please if you notice any bug, let me know in the discussion section.
----------, Aug 14, 2019

Update:
  • I changed the version of the plugin for it to work for Spigot 1.14.3 but it is still working for previous versions as nothing else changed. Sorry no new features for today :cry: (but it is coming ;) )
Please if you notice any bug, let me know in the discussion section.
----------, Jul 13, 2019

Update:
  • Added the possibility to prevent players from being put in combat depending on the damage cause (set in the config) (such as FALL damage)
Important note:
  • If you have downloaded a previous version and wish to update, you have to update your config file. If you don't, the plugin will throw errors!
Copy/paste the following in the Advanced Options section of your config file to update it if needed :
Code (YAML):
#List of all the excluded damage cause. If a damage cause is in this list, it won't put players in combat. The list can be empty
#https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/EntityDamageEvent.DamageCause.html for a list of all the damage cause
excluded-cause
:
 - FALL

Please if you notice any bug, let me know in the discussion section.
----------, Apr 11, 2019

update:
  • Fixed an issue causing player being unable to regen their health when player max health increased because of items
Please if you notice any bug or performance issue, let me know in the discussion section.
----------, Apr 8, 2019

Update:
  • Attempt to fix a weird bug (that might be client side and not related to my plugin, or caused by incompatibilities) that prevent dead players from re-spawning in some occasions. As it was impossible to reproduce the bug to check if the fix is working, I can't promise this update will have any effect. And again, I'm not even sure that this bug comes from my plugin
Please if you notice any bug, let me know in the discussion section.
----------, Mar 27, 2019

Update:
  • Added the possibility to choose what type of potions would put the players in combat
Important note:
  • If you have downloaded a previous version and wish to update, you have to update your config file. If you don't, the plugin will throw errors!
Copy/paste the following in the Potions Options section of your config file to update it if needed :
Code (YAML):
#If set to true, drinking any potion will put the player in combat
any-potion
: false

#List of all the potion effects that would put a player in combat if any-potion is set to false
#You can find a list of all the potion types here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionType.html
potion-list
:
 - STRENGTH

Please if you notice any bug, let me know in the discussion section.
----------, Mar 25, 2019

Important Update
  • Fixed a very important bug making the regeneration stacking multiple times, which could cause insane regeneration amount. Please update the plugin!
  • Added an option to put players in combat state if they consume any potion. I will add more customization about it in later updates (like deciding on what potions put the player in combat state or not)
Important note:
  • If you have downloaded a previous version and wish to update, you have to update your config file. If you don't, the plugin will throw errors!
Copy/paste the following in your config file to update it if needed :
Code (YAML):
              ################
###############Potion Options########################
              ################

#Wether or not drinking a potion will put the player in combat
is-potion-fighting
: false

Please if you notice any bug, let me know in the discussion section.
----------, Mar 21, 2019

Update:
  • Fixed a bug crashing the plugin and spamming the console with errors if the 'use-SkillAPI-experience-level' option is activated without SkillAPI being present
Please if you notice any bug, let me know in the discussion section.
----------, Mar 17, 2019

Update:
  • Added the possibility to modify the regen amount depending on the player's SkillAPI main class level
  • Fixed a bug where players with more than 20 hp (default max value) couldn't regenerate all their health
  • I've made the config file a bit more clear (and nice). Check the ressource Overview if you want to copy it
  • Modified an option name in the config file
Important note:
  • If you have downloaded a previous version and wish to update, you have to update your config file. If you don't, the plugin will throw errors!
  • Be sure to check the modified 'per-experience' -> 'per-level'
Copy/paste the following in your config file to update it if needed :
Code (YAML):
#   !Enable ONLY ONE of the experience-level system!
#If set to true, players will have a regen bonus based on their experience level
use-experience-level
: false

#If set to true, players will have a regen bonus based on their main class experience
use-SkillAPI-experience-level
: true

#The bonus is applied every 'experience'. For exemple, per-experience: 3 will give a bonus every 3 levels
per-level
: 3
#The amount of bonus health regen received every 'per-experience'
regen-bonus
: 0.5

Please if you notice any bug, let me know in the discussion section.
----------, Mar 14, 2019

Update:
  • Added the possibility to modify the player regen amount based on his level
  • Fixed a bug with float regen amount values
Important note:
  • If you have downloaded a previous version and wish to update, you have to update your config file. If you don't, the plugin will throw errors!
Copy/paste the following in your config file to update it if needed :
Code (YAML):

#If set to true, players will have a regen bonus based on their experience level
use-experience-level
: false
#The bonus is applied every 'experience'. For exemple, per-experience: 3 will give a bonus every 3 levels
per-experience
: 3
#The amount of bonus health regen received every 'per-experience'
regen-bonus
: 0.5
 

I will add compatibilities with the SkillAPI level system on a future update.

Please if you notice any bug, let me know in the discussion section.
----------, Mar 10, 2019

Update:
  • Added configurable options for the particle animation (added in the previous update)
Important note:
  • If you have downloaded a previous version and wish to update, you have to update your config file. If you don't, the plugin will throw errors!
Copy/paste the following in your config file to update it if needed :
Code (YAML):
#If set to true, light green particles will spawn on the player when regenerating
particles
: true
amount
: 3
x-offset
: 0.4
y-offset
: 0
z-offset
: 0.4

Please if you notice any bug, let me know in the discussion section.
----------, Mar 8, 2019

Update:
  • Added the possibility to spawn light green particles around the player when regenerating
Important note:
  • If you have downloaded a previous version and wish to update, you have to update your config file. If you don't, the plugin will throw errors!
Copy/paste the following in your config file to update it if needed :
Code (YAML):
#If set to true, light green particles will spawn on the player when regenerating
particles
: true

I will add the possibility to modify the particle options in a future update

Please if you notice any bug, let me know in the discussion section.
----------, Mar 6, 2019

Update:
  • Fixed a bug where players couldn't regenerate their health after taking fall damage at full health
Please if you notice any bug, let me know in the discussion section.
----------, Mar 5, 2019

Update:
  • Added the possibility to activate the RPG Regen system only in the desired worlds
Important note:
  • If you have downloaded a previous version and wish to update, you have to update your config file. If you don't, the plugin will throw errors !
Copy/paste the following in your config file to update it if needed :
Code (YAML):
#If set to true, the plugin will only work in the world listed below
per-world-system
: false

#If per-world-system is true, RPG Regen will only work in these worlds (even if replace-minecraft-system is true)
#The world's name must be exactly the same as the world's folder name
worlds
:
  - world
  - world_the_end
  - world_nether

Please if you notice any bug, let me know in the discussion section.
----------, Mar 4, 2019

Update:
  • Made the plugin compatible with Minecraft 1.12.0+ version, using a deprecated Spigot method to check the player's current world natural regeneration gamerule
Please if you notice any bug, let me know in the discussion section.
----------, Mar 3, 2019

Update:
  • The command '/rpgregen reload' has been created and now reloads all the changes made in the config without restarting the server
  • The permission rpgregen.reload has been added and is now required to run the command (being an operator bypass the permission)
Please if you notice any bug, let me know in the discussion section.
----------, Mar 3, 2019

Resource Information
Author:
----------
Total Downloads: 6,092
First Release: Mar 1, 2019
Last Update: Jun 14, 2025
Category: ---------------
All-Time Rating:
9 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings