Laborus
a Minecraft job plugin for Sponge
- Features
- How to use
- Configuration
- Jobs
- Actions
- Boni
- Ability
- Commands
- Translation
- Contribution
Features
- Jobs in Minecraft
- reward the placing and destroying of Blocks, the using of items and the killing and taming of mobs
- Job Abilities that eg. allow you to destroy blocks faster for 3 minutes every two hours
- anti replace farming system that blocks the rewarding of the placing and destroying of blocks on the same spot so the economy isn’t as easily exploidable
- only allow doing the actions (eg. destroying of a block) after a specific level
- Job Boni like special or multiple drops or repairing of items
- completly configurable and translatable
A full lists of all possible actions, boni and abilities you can find in the Configuration section.
How to use
To use this plugin you need a Sponge Server that is supporting the SpongeApi Version 4.0.
If you have a Server like this you only need to place the pluginfile into the mods folder.
When you have done this and you have started and stopped the server the default configuration file will automaticly be added, but you still need to add the jobs you want to have to this file due to the missing of jobs in the default configuration.
Some ready configuration files you can find in the jobs folder in this repo. These files you can just copy and paste into the configuration folder of the plugin and link them in the configuration file (de.lergin.sponge.jobs.conf) like this:
jobs: {
miner: "miner.conf"
woodcutter: "woodcutter.conf"
}
Commands
/jobs addXP [player]
This command adds the given amount of xp to the xp of the job.
Permission: laborus.commands.addXp
Permission for player arg: laborus.commands.addXp.outher_player
/jobs change <join|leave>
Joins or leaves the job. A job that is joined can give more xp for actions and special boni. The amount of jobs that can be joined can be limited.
Permission: none / can be set in the config
/jobs toggle
Activates or deactivates the job system for the player that executes this command.
Permission: laborus.commands.toggle
/jobs ability
Starts the ability of the job.
Permission: laborus.commands.ability
Configuration
Jobs
General settings
Name | Description | Default value |
---|---|---|
name | the display name of the job | “” |
description | a description of the job | “” |
use_default_level | does the job uses the default levels | true |
level | the levels of the job see Level |
[] |
bonus | a list of jobBoni | [] |
ability | the ability of this job | |
ACTION_NAME -> needs to be replaced by the name of the action |
the settings for the action | {} |
Actions
Settings for JobItems
Name | Description | Default value |
---|---|---|
xp | the amount of xp the player gets if he does the action with this item | 0.0 |
needLevel | the level the player needs to have to do this action | 0 |
Possible actions:
Name | Description | info |
---|---|---|
destroyBlocks | for the destruction of blocks | |
placeBlocks | placing of blocks | |
killEntities | killing of entities | can’t be canceled -> no needLevel |
damageEntities | damaging of entities | |
useItems | interaction with the item in the hand (right and left click) | |
tameEntities | when an entity is tamed |
Boni
Settings
Name | Description | Default value |
---|---|---|
probability | the probability the boni will be used at an action | 0.05 |
sendMessage | should a message be send to the player if the boni is rewarded | false |
message | the message that will be send if sendMessage is true | “” |
condition.minLevel | the min. level the player need to have to get this boni | Integer.MIN_VALUE |
condition.maxLevel | the max. level the player is allowed to have to get this boni | Integer.MAX_VALUE |
condition.onlySelected | only reward the boni if the job is selected | true |
condition.actions | only reward if the action that starts this boni is in this list. A comma separated list of actionNames within [] |
[] -> all actions will start the boni |
condition.items | only reward if the item that starts this boni is in this list. A comma separated list of itemNames within [] |
[] -> all items will start the boni |
Possible actions:
Name | Works with Jobactions | Description | special config settings |
---|---|---|---|
multiDrop | destroyBlocks, placeBlocks | drops the item of the action another time | itemMultiplier -> amount of items that should be droped extra |
ep | all | drops some ep (not job xp) | minEp -> minimum of ep droped maxEp -> maximum of ep droped |
itemRepair | all, needs an item in the hand slot with durability | repairs the item by a given percentage | minPercentage -> minimum the item gets repaired maxPercentage -> maximum the item gets repaired |
itemDrop | all | drops an extra item | itemType -> the itemType of the item amount -> the amount of items that should be droped |
Ability
Settings
Name | Description | Default value |
---|---|---|
name | the name of the ability | none |
coolDown | amount of seconds between uses | 60 |
Possible abilities:
Name | Desctription | special config settings |
---|---|---|
effect | adds a potion effect to the player | amplifier -> effect level duration -> amount of seconds the effect holds on type -> potion type particles -> should the particles not be hidden ambience -> the ambience setting of a effect |