- Native Minecraft Version:
- Tested Minecraft Versions:
FreeRPG is a spigot 1.15+ plugin that adds an RPG skill system to minecraft. Inspired by Mcmmo, the goal of FreeRPG is to offer a free Mcmmo alternative. Each skill has a skill tree, with an additional global skill tree. The skill trees can be accessed with a very simplistic, Hypixel inspired GUI accessed using /freeRPG.
To install on any spigot server, simply drag the FreeRPG.jar file into the plugins folder.
To get started playing, type "/frpg". This will bring up the Skills GUI seen in the top screenshot. Clicking on any of the icons will take you to that skill's skill tree. Hovering over any of the icons or clicking on them will tell you more about the perk.
Earning experience is straightforward, mine to get mining experience, cut trees to get woodcutting experience, etc. By the default config, every level you will gain 1 passive token which can be invested in the passive skills represented by the dyes on the left. Every 100 levels, you will gain 1 skill token which can be invested in the skills represented by the terracotta skill tree. Every 1000 levels, you will gain a global token that can be used in the global skill tree.
To activate abilities, in most cases you can right click the corresponding tool then break a block. The 10 abilities are as follows:
Big Dig: Activated by right clicking a shovel then breaking a block. Increases dig speed drastically.
Timber: Activated by right clicking an axe then cutting a log. Will cause all logs above to break.
Berserk Pick: Activated by right clicking a pickaxe then breaking a block. Will increase mining speed drastically.
Natural Regeneration: Activated by right clicking a hoe then breaking a crop. Automatically replants all crops at a random growth stage.
Super Bait: Activated by left clicking a fishing rod then fishing. Fish are instantly pulled out of the water, without waiting to get a bite.
Rapid Fire: Activated by left clicking a bow. Arrow shots come out at maximum speed no matter how far the bow is pulled back.
Spur Kick: Activated by right clicking most items while on a horse then left clicking most items. Grants your horse a temporary speed boost.
Swift Strikes: Activated by right clicking a sword then hitting an entity. Your swings no longer have a cooldown.
Stone Solid: Activated by right clicking with an empty hand then hitting an entity. Grants resistance at the cost of being slowed down.
Great Axe: Activated by right clicking an axe then hitting an entity. Your attacks become an AOE strike that deals damage in a certain radius.
- Intuitive experience gain
- 3 different token types to be invested in each skill tree
- Tree Feller as an ability
- Fishing system completely reworked, with many new drops
- A grappling hook perk
- New potion recipes, such as Haste and Resistance
- Leaves drop table expanded
- Custom crafting recipes for mob eggs
- Custom crafting recipes for tipped arrows, without requiring dragon's breath
- Ability to check horse stats
- Much more detailed in the information page
Config, Permissions and Use:
- Experience curve tweaking
- Experience amount tweaking
- Ability to tweak how often players receive tokens
- Ability to modify drop items and rates
- Permissions for earning exp, using abilities, and every command
- Ability to set level caps
- More to come soon...
playerBaseHP: 20.0 #Amount of
defaultLanguage: enUs #Current Choices: enUs, huHu, frFR
saveStatsTimer: 900 #Number of seconds between each time the server saves all player stats
multipliers: #EXP multipliers, global STACKS with any other multiplier
automaticPassiveUpgradesPerLevel: 1.0 #Number of passive tokens gained per level
levelsPerPassiveToken: 1.0 #Number of levels required before a passive token is earned (ex. 0.5 --> 2 passive tokens per level)
levelPerSkillToken: 100.0 #Number of levels required before a skill token is earned
levelsPerGlobalToken: 1000.0 #Number of levels required before a global token is earned
startingPassiveTokens: 0 #Starting tokens for newly joining players...
skillTokenToPassiveTokenConversion: 50 #When a skill tree is maxed, skill tokens will convert to passive tokens automatically at this exchange rate
globalTokenToEXPbuff: 0.01 #When the global tree is maxed, Players will gain a +1% global exp boost instead of a token (ex. 0.05 --> +5% global exp boost per global token)
# Use this link to visualize the EXP curve and test parameters:
description: Gives access to all FreeRPG commands
description: Grants the player all recommended permissions (for a common player)
description: Gives access to all GUI commands
description: gives access to all toggle commands
description: Gives access to all stat changing commands
description: Allows player to gain every type of EXP
description: allows the player to use all skill abilities
description: allows user to access main GUI with all skills
description: allows user to access a skill's GUI (skill tree)
description: allows user to access the configuration GUI
description: allows user to access the GUI that shows crafting recipes
description: allows user to access the cofirmation GUI when refunding skills
decription: Allows the user to access the link to the info google document
description: Allows the user to see all FreeRPG commands
description: Allows the user to access the leaderboard command, showing the user the top players in each skill
descriptin: Allows the user to access the enchant item command
decription: Allows the user to give FreeRPG experience to any other player, including themselves
description: Allows the user to set the FreeRPG skill level of any skill for any player
description: Allows the user to reset any FreeRPG skill of any player
description: Allows the user to set any player's personal EXP multiplier
description: Allows player to get digging experience
description: Allows player to get woodcutting experience
description: Allows player to get mining experience
description: Allows player to get farming experience
description: Allows player to get fishing experience
description: Allows player to get archery experience
description: Allows player to get beastMastery experience
description: Allows player to get swordsmanship experience
description: Allows player to get defense experience
description: Allows player to get axeMastery experience
description: Allows player to get repair experience
description: Allows player to get agility experience
description: Allows player to get alchemy experience
description: Allows player to get smelting experience
description: Allows player to get enchanting experience
description: allows the player to use the digging ability
description: allows the player to use the woodcutting ability
description: allows the player to use the mining ability
description: allows the player to use the farming ability
description: allows the player to use the fishing ability
description: allows the player to use the archery ability
description: allows the player to use the beast mastery ability
description: allows the player to use the swordsmanship ability
description: allows the player to use the defense ability
description: allows the player to use the axe mastery ability
description: allows player to use iron blocks to repair
description: allows player to use gold blocks to salvage
description: players with this permission will use freeRPG's changed fishing system
description: allows player to set other players (including themselves) soul stat
description: allows player to set other players (including themselves) token stats (global, skill, passive)
description: allows player to earn souls after unlocking the Soul Harvest Perk
description: allows to player to toggle the flint finder perk
description: allows to player to toggle the graceful feet perk
description: allows to player to toggle the potion master perk
description: allows to player to toggle the flame pickaxe perk
description: allows to player to toggle the grappling hook perk
description: allows to player to toggle the hot rod perk
description: allows to player to toggle the vein miner perk
description: allows to player to toggle the mega dig perk
description: allows player to save any or all player's stats to their stat file
basePlayerHP is the double value of the default player's HP. If for some reason you alter player's starting HP, change this value accordingly. This is only used in the "Hearty" Perk in the Defense skill. Changing this value will NOT change the default value of players total HP. It is simply a reference value.
Multipliers change how much experience is earned for performing actions under each skill. For example, setting "diggingMultiplier" to 0.9 will cause ALL PLAYERS to earn 90% of base digging experience. In the future, I want every experience drop to be customizable.
levelBefore_x_Token can be modified to change how many levels are required to earn each token type. These can be made any decimal value and should round accordingly.
starting_x_Tokens are the tokens each new player starts with. This value is best set when initially installing the plugin.
Here is an interactive Graph to assist in editting the leveling config:
MaxLevel is currently not functioning, changing the value will do nothing.
The leveling system is an exponential curve that switches to linear at level 1000 by default. The experience threshold for each level is given by:
where B is exponentialGrowthFactor.
The plugin determines an exponential curve that goes through two points:
(level, experience) = (0,0)
(level, experience) = (level reference, experience reference)
This uniquely determines an exponential curve, the curve is replace with a linear growing experience curve at any point defined by levelBeginLinear. After this level, it will take LinearEXPperLevel's value in experience to level up. By default, the curve is exponential for the first 1000 levels, and becomes linear after that.
This equation can be tweaked to the server administrator's liking. For solely linear growth, set levelBeginLinear to 1000.
Drop tables can also be changed in the config. The name should match the minecraft id name. It should not be case sensitive. Any items with "null" at the end of them are specialty (enchanted, a random music disc, etc.).
/frpg or /frpg skills - Opens skills GUI
/frpg globalGUI - manually opens the global skill tree GUI
/frpg skillTreeGUI [skillName] - manually opens a skill tree GUI
/frpg configurationGUI - manually opens the configuration GUI
/frpg expGive [playerName] [skillName] [amount] - gives any player experience in any skill
/frpg setStatLevel [playerName] [skillName] [newLevel] - sets the skill level for any skill of a player
/frpg statReset [playerName] [skillName] - resets a skill for a given player (this will not refund any tokens or experience)
/frpg setSouls [playerName] [amount] - Sets the amount of souls a player has
/frpg setTokens [playerName] [skillName] [skill/passive] [amount] OR
/frpg setTokens [playerName] global [amount] - sets the amount of tokens a player has in a particular stat
/frpg saveStats [playerName] OR /frpg saveStats - saves a singular player or all players' stats to their stat file. Will update the leaderboard
/frpg setMultiplier [playerName] [multiplier] - Sets the amount of souls a player has
/frpg flintToggle - manually toggles the "flint finder" perk
/frpg speedToggle - manually toggles the "graceful feet" perk
/frpg potionToggle - manually toggles the "potion master" perk
/frpg flamePickToggle - manually toggles the "flame pick" perk
/frpg grappleToggle - manually toggles the "grappling hook" perk
/frpg hotRodToggle - manually toggles the "hot rod" perk
/frpg veinMinerToggle - manually toggles the "vein miner" perk
/frpg megaDigToggle - manually toggles the "mega dig" perk
/frpg statLeaders [skillName] [page #] - produces list of highest level players in a particular stat
/frpg enchantItem [level] - tries to enchant an item in your hand with a given enchantment level
/frpg help [page #] - displays all the information above in game
/frpg info - sends the player a message with a link to a google doc that outlines every skill and general mechanics
FreeRPG should be compatible with most popular plugins. It has been tested with Essentials, Bssentials, World Edit, and Worldguard and yielded no issues. It has additionally been tested with Multiverse and has no major issues. However, player profiles for different worlds is not possible at the moment.
FreeRPG is an open source project. Anyone is welcome to view, use, or re-purpose the (poorly, self written) java on the github project page.
FreeRPG [1.15-1.16.1] 1.1.1
An RPG plugin that adds skills, leveling, abilities, and more!