SolusRpg
General Information
Introduction
SolusRpg is the be-all, end-all role playing and user management plugin. It integrates many features from an old plugin of mine, DayJobs, with a good deal of new features. It was originally design for the Unlimited Clan Gaming Community at the request of their head admin.
SolusRpg, though it takes many of it's features from DayJobs, has become so much more the DayJobs was or ever could be.
Key Features
Just as DayJobs provided support for block and entity interactions, armor and tool usage, and crafting and smelting handling, so does Solus. However, unlike DayJobs, it handles these events in a much more efficient manner. It also provides support for modifying stats, such as a player's health, damage, defense, jump height, and more.
Synopsis of Features
- Complete player interaction control
- Block place and break events
- Player interact events
- Crafting events
- Furnance handling events
- Armor usage handling
- Per-class stat control
- Modify max health
- Modify damage output
- Modify damage resistance
- Modify max jump height
- Modify max speed
- Per class max carrying weight, with configurable item weights
- Configurable slow based on currently equipped armor
- Robust skill system, featuring support for both active (castable) skills and passive skills
- Configurable messaging system for deny messages and other plugin-created messages
Also, as I develop skills for the plugin itself, I will also release them as part of an archived download containing both the skills and the plugin jar file.
Wiki Page and Documentation
I am pleased to announce the development of the SolusRpg Wiki on GitHub! It's still under construction at the moment, but it will eventually detail even the most complex aspects of working with SolusRpg, including developing with it's Skill API! You can view the Wiki Landing page here!
Commands
The four main commands you will need is:
- /class
- /sr
- /stats
- /skill
For help and a list of all currently available commands, type /solus help.
Permission Nodes
- /class info
- dbstudios.solusrpg.player.info.self
- /class info <class>
- dbstudios.solusrpg.player.info
- /class list
- dbstudios.solusrpg.player.list
- /class admin <player> <new-class>
- dbstudios.admin.change-class
- /class whois <player>
- dbstudios.admin.whois
- /sr gui show|hide
- dbstudios.admin.player.gui
- /stats
- No permission node
Requirements
- Vault
- Spout
- Players will need the Spoutcraft Client
Bug Reporting
If you encounter any bugs, please use the Ticket Tracker system on BukkitDev. If it's an extremely pressing issue (like the plugin crashes every time you try to run it) submit a ticket and then pm me.
Forum
For some odd reason, the link to the BukkitDev forum isn't showing in the nav bar... So, until I can figure out why, you can access SolusRpg's forum with this link!
Daybreak Studios on Twitter
Follow DBStudios on Twitter! I'll be broadcasting updates for Solus on Twitter as I go, and I usually talk to "myself" as I program, so it might get pretty interesting on there!
Developing With SolusRpg
SolusRpg has no API at the moment, and the skill system, though simple, has no documentation. As soon as I finish writing up the documentation, I'll post a link here. The source code is also available on GitHub.
Contacting Me
The best way to contact me is via PM on BukkitDev. Additionaly, I will also be frequenting an IRC room when I have the chance. The server is hosted by UnderNet, at tampa.fl.us.undernet.org. The channel title will be 'dbstudiosdev'.
Donations
For those wishing to donate to support this plugin and further development of this and any future plugins, you can use the donation link at the top of the BukkitDev page! Just look up!
-
View User Profile
-
Send Message
Posted May 26, 2012btw, is there any option implemented yet to slow down the block breaking of players?
-
View User Profile
-
Send Message
Posted May 26, 2012@LartTyler
I think there are item or block groups you added, like COMMON_ITEMS and LEATHER_ARMOR. How many groups are there and can you list them?
-
View User Profile
-
Send Message
Posted May 26, 2012@EstJoel
It's actually already linked on the wiki. If you follow the Basic Configuration tutorial on the wiki, it's linked just above the final section. However, since it is kinda hard to find, I'm going to create an important links and references page when I get the chance.
-
View User Profile
-
Send Message
Posted May 26, 2012@LartTyler
Thanks :D I'm sure I'm not the only one looking for these. Maybe take a minute and put the link in the Solus wiki under the Classes section?
-
View User Profile
-
Send Message
Posted May 26, 2012A complete list of all valid material names can be found here: http://jd.bukkit.org/apidocs/org/bukkit/Material.html
-
View User Profile
-
Send Message
Posted May 26, 2012As there is no list of items, blocks, etc that can be utilized in the classes (eg IRON_CHESTPLATE) on the wiki, can you direct me to the .class file where they are stored? I'm not sure whether these are implemented in the Bukkit code or in yours.
-
View User Profile
-
Send Message
Posted May 23, 2012@STARWAR5NERD
Oh boy ._. that's alot of text. For fututre reference, something like this would make a much better PM. And, on that note, you can expect a private message from me shortly.
-
View User Profile
-
Send Message
Posted May 23, 2012I have got the plugin working and can create classes but the jump modifier does not work. Also, the damage, and speed modifiers don't work either. How do you make this work.
No class can place crafting tables either.
Also, what is the energy thing and how does it work?
Here is a copy of my config for relevence:
config:
default:
class: Classless
stats:
damage-dealt: x1.0
damage-taken: x1.0
max-weight: 350.0
speed: x1.0
jump-height: x1.0
energy:
name: Energy
max: 0
damage-on-empty: false
regen:
enabled: false
degen:
enabled: false
health:
name: Health
max: 20
regen:
enabled: false
delay: 600
amount: 2
degen:
enabled: false
messages:
place-deny: "{aqua}You may not place {item}..."
use-deny: "{green}You cannot use {item}..."
break-deny: "{AQUA}You may not break {item}..."
wear-deny: "{gold}You may not wear {item}..."
wear-deny-item-drop: "{GOLD}Your inventory was full, so your {item} was dropped..."
craft-deny: "{dark_aqua}You may not craft {item}..."
smelt-deny: "{dark_aqua}You may not place {item} in a furnace..."
colors:
info1: AQUA
info2: Green
list: aqua
skill: gold
stats: dark_aqua
sr: dark_red
help1: GREEN
help2: dark_green
skills: []
armor-speeds:
leather_helmet: 2.0
leather_chestplate: 4.0
leather_leggings: 2.0
leather_boots: 2.0
chainmail_helmet: 3.0
chainmail_chestplate: 6.0
chainmail_leggings: 3.0
chainmail_boots: 3.0
iron_helmet: 9.0
iron_chestplate: 18.0
iron_leggings: 9.0
iron_boots: 9.0
gold_helmet: 1.0
gold_chestplate: 2.0
gold_leggings: 1.0
gold_boots: 1.0
diamond_helmet: 5.0
diamond_chestplate: 10.0
diamond_leggings: 5.0
diamond_boots: 5.0
item-weight:
default: 0.01
overweight-slow: 35.0
bedrock: 0.0
bookshelf: 1.0
brewing_stand_item: 5.0
brick: 0.5
brick_stairs: 1.25
cauldron_item: 5.0
chest: 1.0
coal_ore: 2.0
cobblestone: 1.5
cobblestone_stairs: 2.0
cooked_beef: 0.25
cooked_checken: 0.25
cooked_fish: 0.25
diamond_axe: 18.5
diamond_block: 10.0
diamond_hoe: 12.0
diamond_pickaxe: 15.0
diamond_spade: 17.5
diamond_sword: 25.0
dirt: 0.25
furnace: 3.5
glass: 0.75
glowstone: 0.75
gold_axe: 16.5
gold_block: 8.0
gold_hoe: 15.0
gold_nugget: 0.0
gold_ore: 2.5
gold_pickaxe: 13.0
gold_spade: 14.5
gold_sword: 18.0
gravel: 1.0
grilled_pork: 0.25
iron_axe: 16.5
iron_block: 8.0
iron_fence: 1.75
iron_hoe: 15.0
iron_pickaxe: 13.0
iron_spade: 14.5
iron_sword: 18.0
ladder: 0.5
log: 2.0
mossy_cobblestone: 1.5
obsidian: 4.0
piston_base: 1.5
piston_sticky_base: 1.5
pork: 0.25
potion: 0.5
pumpkin: 1.5
raw_beef: 0.25
raw_chicken: 0.25
raw_fish: 0.25
redstone_torch_on: 0.1
rotten_flesh: 0.25
sand: 0.5
sandstone: 1.0
sapling: 0.5
shears: 8.5
sign: 1.25
smooth_brick: 2.0
smooth_stairs: 2.5
step: 0.75
stone: 2.5
stone_axe: 10.0
stone_hoe: 6.0
stone_pickaxe: 8.0
stone_spade: 7.0
stone_sword: 15.0
wood: 1.0
wood_axe: 8.0
wood_hoe: 2.0
wood_pickaxe: 5.0
wood_spade: 4.0
wood_stairs: 1.5
wood_sword: 10.0
wool: 0.1
workbench: 5.0
classes:
Classless:
name: Classless
bio: The default class
can-use:
- Nothing
can-wear:
- Nothing
can-craft:
- Nothing
can-smelt:
- Nothing
can-place:
- Nothing
can-break:
- Nothing
skills: []
stats:
health:
name: Health
max: 5
damage-dealt: 0
damage-taken: 5
max-weight: 0.0
speed: 0.0
jump-height: 0.0
Warrior:
name: Warrior
bio: Masters of combat, Warriors are the powerhouse of any force
can-use:
- COMMON_ITEMS
- SWORDS
- AXES
can-wear:
- LEATHER_ARMOR
- IRON_ARMOR
- GOLD_ARMOR
- DIAMOND_ARMOR
can-craft:
- COMMON_ITEMS
- WOOD_SWORD
can-smelt:
- COMMON_ITEMS
can-place:
- COMMON_ITEMS
can-break:
- COMMON_ITEMS
skills: []
stats:
health:
name: Health
max: 40
regen:
enabled: false
degen:
enabled: false
energy:
name: Rage
max: 100
regen:
enabled: true
delay: 1000
amount: 10
damage-dealt: x1.5
damage-taken: x0.75
speed: x0.9
BSmith:
name: Blacksmith
bio: Masters of the art of metallurgy, Blacksmiths can make just about anything you need for your adventures
can-use:
- COMMON_ITEMS
can-wear:
- LEATHER_ARMOR
can-craft:
- ALL
can-smelt:
- ALL
can-place:
- COMMON_ITEMS
can-break:
- COMMON_ITEMS
skills: []
Archer:
name: Archer
bio: Masters of the bow, Archers are capable of taking out their targets before the unfortunate victim even knows it is in danger
can-use:
- COMMON_ITEMS
- BOW
can-wear:
- LEATHER_ARMOR
can-craft:
- COMMON_ITEMS
- ARROW
- STICK
can-smelt:
- NOTHING
can-place:
- COMMON_ITEMS
can-break:
- COMMON_ITEMS
skills: []
stats:
health:
max: 25
energy:
name: Focus
max: 100
regen:
enabled: true
delay: 1000
amount: 15
damage-dealt: x1.25
speed: x1.5
jump-height: x1.5
Scout:
name: Scout
bio: Fast moving and agile, Scouts are best for searching the terrain. They can attack with high damage but must retreat quickly in case of counterstrike (I'M GOING TO CAMP AT THE HOSTAGES!)
can-use:
- COMMON_ITEMS
- WOOD_SWORD
- STONE_SWORD
- IRON_SWORD
- GOLD_SWORD
can-wear:
- LEATHER_ARMOR
can-craft:
- COMMON_ITEMS
- WOOD_SWORD
- MAP
- COMPASS
can-smelt:
- NOTHING
can-place:
- COMMON_ITEMS
can-break:
- COMMON_ITEMS
skills: []
stats:
health:
name: Health
max: 20
regen:
enabled: false
degen:
enabled: false
energy:
name: Adranaline
max: 100
regen:
enabled: true
delay: 1000
amount: 13
damage-dealt: x3
speed: x3
jump-height: x5
-
View User Profile
-
Send Message
Posted May 18, 2012@darkaxel102
Well, one option would be to create classes that combine features. For example, if you have a woodsman class and a miner, you could make a general Gatherer class. It's more in the config, but it's a solution for the time being. Multiple classes would be rather simple to implement though, so it's something I could do in the future.
-
View User Profile
-
Send Message
Posted May 18, 2012nobody has i swear as soon as you got it i downlod this and use it GET IT. lol sorry but i am searching for 2 days wthout succes nobody supports it i want people to have like 3 things to not limited them too much
-
View User Profile
-
Send Message
Posted May 18, 2012@darkaxel102
No multiple classes at the moment, sorry.
@lANTHONYl
Leveling may come later. It was a nightmare to implement, and my focus is getting a working skill system out first. Perhaps once that is squared away, I can look into a leveling system as well.
-
View User Profile
-
Send Message
Posted May 18, 2012can theye have multipell classes in here ?
-
View User Profile
-
Send Message
Posted May 18, 2012@LartTyler
But no leveling... It was a tossup between this and Jobs for me. Jobs offers leveling, but controlling what players can and cant do is a nightmare of creating custom permission nodes and assigning them based on level. ModifyWorld nodes out the wazzo :/
What good is XP without a reason to acquire it?
-
View User Profile
-
Send Message
Posted May 17, 2012@lANTHONYl
Yes and no.
I have another plugin I designed with role play in mind called DirectExp. I plan on including a system similar to it in the next release of SolusRpg. It will be a simple system, allowing configurable amounts of experience per experience source, with experience sharing between those involved. But that's all I have planned at the moment.
-
View User Profile
-
Send Message
Posted May 16, 2012Should we expect the inclusion of an Experience and Leveling system?
Just wondering if i should design my classes with that in mind...
-
View User Profile
-
Send Message
Posted May 2, 2012@Ozhound
I'm sorry to hear that. If you sent me your configuration file, I would be more then happy to help you get up and running again. Most likely, as EstJoel pointed out, you probably are still using the stock Classless class, which cannot move, jump, or interact with the world.
If you PM me your config.yml and your server log, I am confident that I can get you going.
-
View User Profile
-
Send Message
Posted May 2, 2012@EstJoel
You can craft and smelt being "classless"? i CAN...
-
View User Profile
-
Send Message
Posted May 2, 2012@Ozhound
That is probably either because you are stuck in a hole, deopped and in spawn or you are set as 'Classless' in the config.
-
View User Profile
-
Send Message
Posted May 2, 2012Doesnt work, cant move, cant type commands, all it says is type /solus halp, deleted, back to mcmmo
-
View User Profile
-
Send Message
Posted May 1, 2012When I use the default work "classless" I can not break, no place, no use, but if it allows me to crafting and smelt... You can try it yourself and see how you can do those things but in the configuration is an impediment.