LegendQuest
[ Main | Guide | Races | Classes | Skills | Default Skills | Effects | Skill Anatomy | Cmds | Perms ]
Compatible with craftbukkit-1.8/spigot-1.8, 1.8.3 and 1.8.4 builds (as well as 1.7.9)
Checkout the new LegendQuest addons:
ManaBar: An always visible ManaBar on the GUI
MagicItems: MagicItems that modify stats and have classic +X enchants, as well as a customisable RPG friendly enchanting overhaul, and 3 new skills for working with items.
LegendQuest was created to power SableCraft's RPG servers, and with it players are able to become heroes and shape their character with a wide range of races, classes and skills.
LegendQuest is designed from the beginning to be completely configurable, highly flexible, and totally adaptable to your needs. Consisting of a system of configurable races, classes and skills. LegendQuest is the core of your servers RPG setup, and powers all your RPG elements.
Server owners have the option of completely customising their RPG setup.
Want to go high fantasy Tolkien style? Setup Humans, Elves, Orcs, Dwarfs and Hobbit races, with fighter, mage, bard, ranger and more as classes.
Want a modern setting? Turn of races, and setup classes for mercenary, merchant, soldier, etc. Or use "race" for a body type - Brute, Athletic, Intelect...
Want a more classic MineCraft feel - Make races for Human, Ender, Wither and Pigmen. And classes for miner, farmer, hunter, crafter...
It's your RPG experience - your way.
As characters gain experience, they can gain more skills, health, mana. Either unlocking skills automatically as they level up - or by earning skill points to choose the skills they want. Its up to you the server owner which system to use, you can even mix and match both.
More importantly, each class and race can have limits placed on allowed, weapons, tools, armour and "abilities" such as crafting, smelting, enchanting, repairing etc... And you can (per class/race) turn them on/off, use the inbuilt groups (or add your own) to quickly give sets of allows, or control down to specific item at individual levels, as general or as detailed as you need.
LegendQuest also lets you use other plugins as skills by setting and removing permissions nodes and issuing commands complete with delays, build-ups, duration, cooldown, mana cost, cash, karma and material costs! Way beyond the simple on/off mechanisms of other systems.
For example this config lets you use essentials Fly, Jump and Workbench commands as skills:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 |
permskills: blinker: level: 0 cost: 0 perm: essentials.teleport.timer.bypass type: PASSIVE portabench: level: 0 cost: 0 cooldown: 6000 perm: essentials.workbench command: workbench fly: level: 10 cost: 0 buildup: 1000 delay: 1000 cooldown: 20000 duration: 10000 consumes: FEATHER perm: essentials.fly commandon: "fly on" commandoff: "fly off" blink: level: 0 cost: 5 cooldown: 6000 delay: 1000 buildup: 1000 perm: essentials.jump command: jump |
You can read more indeph info here.
Features
Complete, configurable RPG plugin.
Advance your characters by earning experience.
Completely configurable classes, races and skills.
Alignment tracking - are you being good, or evil?
Easy setup - drop in the jar, and go! Run with the default setup - or go wild with your own settings!
Feature Details
This plugin is now out of Beta (yay!) and has the following features...
- Worlds
- Configure LQ to work only in selected worlds, if required
- Stats + levels
- Classic RPG stat-line for all players
- Adjusts many game elements especially combat
- /stats command to view your stats, optionally view others
- Optional '/stats journal' to spawn a Journal book, that updates to always show your stats.
- Unlock skills, stats, health, mana, mana regen, item use, and many more as you level up
- Configurable max level to allow mastery of a class and unlock other dependant classes.
- Block repair level loss and (with MagicItems enchanting level loss).
- Configurable xp loss on death.
- Classes and races
- Permissions nodes to allow limitation of races and classes to certain player groups
- Stat mods for each class/race. Make your figters stronger, mages more wise, rouges more dexterous, dwarves more tough...
- Customise race and class names, chat tags and descriptions
- Configure ex gains by exp type such as kills, smelting and mining.
- Races
- Optional use of race types in your server.
- Fully customisable by adding/removing/editing config file for each race.
- Adjustable base health, mana, mana regen and skill points per race
- Adjustable mana, health and skill points bonus per level
- Classes
- Optional use of Class types in your server.
- Fully customisable by adding/removing/editing config file for each class.
- Each class can be limited to one or more races.
- Dual class system with option to limit class to prime or secondary.
- Flexible dependency system allowing you to build complex class-paths, from simple parent > child to sprawling chains with multiple requirements and optional lists.
- Health, mana and skill point modifiers per class to further modify base given by health
- Further adjustable mana, health and skill points bonus per level
- Item control
- Control weapons, tools, and armour user per race and class.
- With flexible overrides and per level item control.
- Control item use per level, for crafting, repairing, smelting, brewing and enchanting
- Use global race and class controls, item groups, or per item per level control. As broad or as complex as you want.
- Skills
- Each class and race can allow either unlocking classes at various levels OR accumulate skill points to allow players to select from a list of skills for each class/race.
- 58 skills and counting - most with numerous configuration options. For example Summon can summon any one of over 40 Entities, Hurt can be used to produce any number of ranged damage options and Hex; Aura; PassiveAura and Enchant can be used with any of 28 effects - that's 152 variants from just 5 skills without breaking a sweat :)
- Where appropriate skills can have build-ups, delays, durations, cooldowns, manacosts, permissions requirements, consume items, give xP, cost money and more!
- Use skills with /skill <skillname> - by /link to an item (or /bind) or via the flexible loudouts system.
- Native skills use a jar loading system to allow developers to code new skills and drop the jar in the skills folder. You can even package bundles of skills in one jar package.
- Reuse any skill with multiple alias' to perform different effects
- Flexible weaponmaster skill allows configuration of damage per item per level.
- Permission skills
- Either add permissions nodes as you level, or go the phole hog and use a permskill to allow any permissions node (or nodes) to be used solo in combination with a command or a start and stop command pair - to use 3rd party plugins as skills.
- Lets use use almost any permission based plugin as a skill. Complete with all the LQ skills power; cooldowns, delays, build-ups, durations, mana costs,
- Can provide passive always on effects, or active skills that use /skills <name> and can be /link'ed to an item or used in loadouts just like 'regular' LQ skills.
- Permissions
- your class, race level and optionally karma and stats are added as permissions nodes.
- Excellent for use with plugins like Quests to lock a quest to a class/race.
- Mechanics and Combat
- Global scaling for falling damage
- Combat system - Your statline will affect how often you hit, dodge and damage in combat.
- Configurable base hit chance, dodge change, block chance, height bonus and size difference modifiers.
- Health scale cap to limit hearts shown in client - even with extreme health levels.
- Mana system for powering skills. Adjustable per race/class/level and with configurable regeneration.
- Optionally, replace or reduce repair levels and add a money cost, item cost and/or mana cost
- Renaming blacklist to protect custom items
- loadouts - (NEW)
- Specify class items to use to quickly select and use skills.
- left click with one item to toggle skill selected
- right click with another (or even same item) to use selected skill
- Alignment
- Your deeds count!
- Option to track players actions and reward or remove alignment points as appropriate.
- Now with optional kamra rewards, penalties or requirements for skills.
- Persistence
- Use SQLite or MySQL for data storage.
- Parties
- Join with friend to share experience, give/receive buffs, stop PvP and teleport back to your group :)
- Adjustable Bonus XP for groups
- Adjustable party range
- party tp command to take you to where the "bulk" of your party is adventuring.
- Chat
- Built in chat prefix system
- or use your own and allow LQ to process {class} and {race}
- chattags for shorter char prefix tags.
- MChat and deluxe chat integration
- API
- LQ has many many events and a flexible PC (player character) object to make coding addons and skills highly flexible.
Interoperability
The following plugin API's add extra optional features:
- Vault - each skill can have a monetary cost applied.
- Factions - prevents some skills causing PvP damage and altering blocks in rival factions.
- GriefPrevention - prevents some skills causing PvP damage and altering blocks in other players claims without permissions.
- Towny - prevents some skills causing PvP damage and altering blocks in rival towns/plots.
- MChat - adds variables for use in MChat formats.
- Deluxechat Placeholders. See list of available codes here.
- WorldGuard - honour no PvP and protected regions.
Planned updates:
- CityWorld - because I can, because it's awesome ;) - mainly thinking detection of nature zones for ranger bonus's and urban zones.
- AntiCheat - So skills don't trigger cheat warnings. (You can always use perms to add the exceptions :) )
Please feel free to leave feedback - and let me know what you want to see in this RPG plugin.
Setup/Usage
See the following pages for help on each aspect of LegendQuest config and usage.
- Guide
- Races
- Classes
- Skills
- Default Skills Configurations
- Effects
- Anatomy of a skill
- Commands
- Permissions
Dependancies
CraftBukkit 1.7.9+ / Spigot 1.8.1+
SQLibrary For database persistence.
Please note that LegendQuest is built against Bukkit and is NMS/OBC free. Minecraft updates should not affect LegendQuest, only Bukkit API changes. This should make things much simpler during updates. (Each extra skill jar may or may not be NMS free.)
Source code
https://github.com/Sablednah/LegendQuest
https://github.com/Sablednah/LegendQuest-Skills
https://github.com/Sablednah/LegendQuest-Skills-Extras
Donations
Donate now to help keep LegendQuest alive :)
If you love LQ and use it on your server, especially if your server is generating an income, then please think of us and help us keep LegendQuest alive up to date!
You can support me via Patreon at https:www.patreon.com/sablednah
You can donate via PayPal (in £) - PayPal (in $)
Custom skills are also available on request, whether its something bespoke, or just adding particle effects - PM me for details
@pepper82
This would be so much easier in the forums :) (Why does nobody want to use them !! lol)
Would you mind copy+paste to here: http://dev.bukkit.org/bukkit-plugins/legendquest/forum/legendquest/questions/ ? Meanwhile I'll work an answers...
Question #1:
So experience is gained through standard minecraft experience orbs. That means when a player collects such an experience orb it will increase his class' experience, right?
(so I can have some other plugin drop exp orbs for smelting IF the player is in the class "blacksmith" for example -> result: a blacksmith gain experience through smelting ... hopefully I will find such a plugin :-) )
Question #2:
I have a character like this:
Race: Human
Class: Fighter
I have this line in the (human) race file:
allowCrafting: true
I added this line into the (fighter) class file:
allowCrafting: false
But I am able to use the workbench to craft items - why is that and how can I change it?
# Update: I had to restart the server in order to make this work - but why is there a reload command? Can you fix the reload command then so I won't need to restart the whole server when changing something in the classes / races files?
Question #3:
I have setup and are using mysql. The tables have been genereated, however I don't see any player data? Where do you store player data? I want to have classes / races / player data displayed on my homepage :-)
Question #4:
Is it a bug?
Normal players can't use /skill list - even when with correct permission node (using PermissionEx)
Thanks for your help!
@smokeymcjay
Nope. As LQ uses a database to persist data - it uses UUID's to store/key said data.
Everyones going to have to move to 1.7.9 soon ;)
would there maybe be a 1.7.2 vers? ;D
@soulscapex
Commands and Permissions pages added.
Will add LQSkill-Defaults info tommorow.
@soulscapex
http://dev.bukkit.org/bukkit-plugins/legendquest/pages/skills/ is the skills overview page ? not sure where you got that "skill-config" link from?
I'm trying to get people to use the forums so that this kind of help doesn't get lost in the depth of comments. http://dev.bukkit.org/bukkit-plugins/legendquest/forum/skills/nativeskills/ is the place to ask about configuring skills - go on why not be the first forum user? :)
As for commands - http://dev.bukkit.org/bukkit-plugins/legendquest/pages/guide/ lists most of them (but not all) commands page will be comming soon.
Permissions is a bit of a weird one too. Theres a few basic permissions to allow access to each command. But permissions nodes for characters and races is freeform. You can use your own "myservername.members" or just make them up "legendquest.figterclass" and so on. I'll get another page up for the perms nodes that are in place for command use.
@1SDAN
No worries, just I know mcore/factions are very unforgiving plugins - alot of care in the first few days of setup can save you months of issues later on ;)
I'm very sorry, I tried to read as much as possible, but I have a habit of skimming. I knew I must have did something wrong but I just couldn't figure out what. Thank you very much for responding. I'll lurk moar next time.
When i try to view the skills page http://dev.bukkit.org/bukkit-plugins/legendquest/create-page/?name=skill-config
says no permission , im lost on how we see what the skill is or how to set each one up,
do you have a command page to show the commands , i cant seem to find how to select a race or class
or is there a perm page i also cant find how to set perms or what they are.
@1SDAN LQSkills-Defaults.jar is the skill pack it goes in /plugins/LegendQuest/ no in just /plugins/ LegendQuest.jar is the plugin, LQSkills-Defaults is an add-on to add skills.
Please read through the project description and the files change log and Known caveats when you download plugins, as I can also see from the snippet below that you haven't installed Mcore for Factions either.
So with that in mind please note the dependencies for LegendQuest - i.e. SQLibrary.
It failed to load, not a crash but it just didn't load up:
10:35:06] [Server thread/INFO]: Starting minecraft server version 1.7.9
[10:35:06] [Server thread/INFO]: Loading properties
[10:35:06] [Server thread/INFO]: Default game type: SURVIVAL
[10:35:06] [Server thread/INFO]: Generating keypair
[10:35:06] [Server thread/INFO]: Starting Minecraft server on *:25565
[10:35:07] [Server thread/INFO]: This server is running CraftBukkit version git-Bukkit-1.7.9-R0.1-b3084jnks (MC: 1.7.9) (Implementing API version 1.7.9-R0.1)
[10:35:07] [Server thread/ERROR]: Could not load 'plugins\LQSkills-Defaults.jar' in folder 'plugins'
org.bukkit.plugin.InvalidDescriptionException: Invalid plugin.yml
at org.bukkit.plugin.java.JavaPluginLoader.getPluginDescription(JavaPluginLoader.java:150) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
at org.bukkit.plugin.SimplePluginManager.loadPlugins(SimplePluginManager.java:133) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
at org.bukkit.craftbukkit.v1_7_R3.CraftServer.loadPlugins(CraftServer.java:355) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
at org.bukkit.craftbukkit.v1_7_R3.CraftServer.<init>(CraftServer.java:317) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
at net.minecraft.server.v1_7_R3.PlayerList.<init>(PlayerList.java:68) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
at net.minecraft.server.v1_7_R3.DedicatedPlayerList.<init>(SourceFile:14) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
at net.minecraft.server.v1_7_R3.DedicatedServer.init(DedicatedServer.java:126) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
at net.minecraft.server.v1_7_R3.MinecraftServer.run(MinecraftServer.java:436) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
at net.minecraft.server.v1_7_R3.ThreadServerApplication.run(SourceFile:628) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
Caused by: java.io.FileNotFoundException: Jar does not contain plugin.yml
... 9 more
[10:35:07] [Server thread/ERROR]: Could not load 'plugins\Factions.jar' in folder 'plugins'
org.bukkit.plugin.UnknownDependencyException: mcore
at org.bukkit.plugin.SimplePluginManager.loadPlugins(SimplePluginManager.java:216) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
at org.bukkit.craftbukkit.v1_7_R3.CraftServer.loadPlugins(CraftServer.java:355) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
at org.bukkit.craftbukkit.v1_7_R3.CraftServer.<init>(CraftServer.java:317) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
at net.minecraft.server.v1_7_R3.PlayerList.<init>(PlayerList.java:68) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
at net.minecraft.server.v1_7_R3.DedicatedPlayerList.<init>(SourceFile:14) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
at net.minecraft.server.v1_7_R3.DedicatedServer.init(DedicatedServer.java:126) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
at net.minecraft.server.v1_7_R3.MinecraftServer.run(MinecraftServer.java:436) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
at net.minecraft.server.v1_7_R3.ThreadServerApplication.run(SourceFile:628) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-b3084jnks]
It says that somethings wrong with something called plugin.yml
@soulscapex
It means they wont work with the Heroes Plugin (people have asked).
And they don't work on their own in the plugins folder - they require LegendQuest (people have tried this).
The skills present are quite flexible btw - e.g. summon can summon any entity - so you don't need one skill per EntityType.
Ask in the forums if you want help configuring skills. And if there isn't one that does what you'd like - ask away in forums so I know what ones to add next!
These are not Heroes skills and will not work solo. im sorry but does this mean you can use hero skills or well what does this mean.
@SableDnah
I think what sephstrom is trying to say is there are no skills listed; and there's no file or .yml sephstrom can access.
Would this be something fixable?
@sephstrom
Ahh that skills.yml is to override defaults for each skill on a global. Each skill has a manifest inbuilt with default in. like this:
This is overridden by skills.yml.
And then its further overridden by the skills settings in each class/race yaml file.
tbh skills.yml is usually unused - you have to be repeating a skill ALOT before it was worthwhile.
@SableDnah
Well what I guess I'm not getting is if the .jar supposed to create a .yml that has the default skills in them? Because the skills.yml only has:
@sephstrom
LegendQuest Default Skills v1.3 is the first (and only at the moment!) skill pack.
It goes in /plugins/LegendQuest/skills/ and allows you to use Aura, Enchant, Hex, Shoot, Stun, Weaponmaster, Dodge, Brawler and Summon skills.
http://dev.bukkit.org/bukkit-plugins/legendquest/pages/skills/ shows a little how you can use this skills to product several variants.
Where are the skill packs? I'm looking all over and I can't find them :( I'm sure I'm just overlooking them though. I did find that DefaultSkills1.3.jar thing but I threw that on my server and restarted but don't see any file anywhere with the skills in them.
@SableDnah
I feel like an idiot. Thank you! :]
@Chellizard
Did you get SQLibrary and place that in /plugins/ too?