ManyOrbs - Crops | Effects | Commands & More! 1.6.0
Create your own orb for you and your players!
ManyOrbs gives you custom orbs for your server. Those orbs can be useful for server owners and players alike.
Features
- Extremely configurable.
- Want a new orb? You can create yourself! Check below to see more info.
- You can change the texture of any orb, create them however you want.
- Orbs can execute commands, give potion effects, plant crops and more!
- Dropped Orbs This orbs can drop from mobs (or players), pick it up to get its effects!
- You can have permanent server orbs that are stored in the database, MySQL (online) or SQLite (local).
- Very simple and easy to set up!
- Own orb shop, but you can also create your own shop using your Menu plugin and give the orbs via command.
- Performance is my number 1 priority, the plugin was tested on the very worst scenario possible to make sure it will not cause a large impact on your server.
- But! Your configuration is not the same as mine, so read the plugin page for more info on performance. We will keep improving as necessary.
Bugs
If you have any issues, report via discussion or private message. Do not use the rating area to report bugs or request features. Please go to discussion.
You can see from my other resources that bugs are patched within a few hours, so please be patient if you are having a problem -- let me know your issues and we'll get it fixed as soon as possible.
Performance
As said above, everything was carefully created and tested with performance in mind. However, things are not equal for everyone.
If you think the plugin is hurting your server, Install spark and give me a report of your server running for a few hours with the plugin Installed.
There are a few options in orbs.yml and settings.yml that can alleviate performance for low-end servers, and more to be added in the future as necessary.
Dependencies
None. But you can install Vault to work with economy.
Plugin support
You can toggle certain orbs to be placed only in non-protected regions. At the moment, we can check for the following plugins:
- WorldGuard
Need support for a plugin? Send a suggestion, as long as the plugin has a API we can get info from it will be added.
Commands
Command: manyorbs
Aliases: orbs
Player commands:
- /orbs menu - Opens the orb menu.
- Permission: manyorbs.menu
Admin commands, require the permission manyorbs.admin
- /orbs reload - Reloads all language.yml, messages.yml, orbs.yml, refreshes player cooldown and reload all spawned orbs.
- /orbs save - Send all current server orbs to the database, storing their location and other important data.
- /orbs disable - Disables all spawned orbs.
- /orbs restore - Restores all disabled orbs.
- /orbs get <orb> - Gets a orb, use tab to see all your orbs from orbs.yml.
- /orbs give <orb> <player> - Gives an orb to a player, use tab to see all your orbs from orbs.yml.
Files
The orb.yml file. Don't worry! The default orb.yml contains an example of every orb type, so you can start from there!
This is here you can create your orbs. As 1.4.2, you can create:
- Crops, to grow/plant crops.
- Powerups, to give potion effects.
- Commands, to execute commands, those commands can repeat how many times you need.
- Fishing, to accelerate fishing spawn and fishing bite speed.
- Dropped Orbs, orbs will drop from entities you set in the orb config.
- Flower Orbs, will plant flowers.
- Spawner Orbs, will spawn mobs.
The orbs can be owned by server or owned by a player.
- Orbs owned by the server will plant the fully growth crop.
- Orbs owned by server are not shown in the menu to players that don't have the manyorbs.admin permission.
Example of a orb:
Crop Orbs
Crop orbs will target FARMLAND and SOULSAND block types, meaning that anything that you can plant in those blocks can be created via orbs.yml.
Just change the "block" of the orb and done!
Special cases:
You can set the block to MELON and PUMPKIN (not MELON_STEM and PUMPKIN_STEM), this will place the block on the nearest GRASS or DIRT block.
Powerups Orbs
Those can give you potion effects. You can see the full potion effect list HERE. The effect is reapplied every second.
Commands Orbs
Command orbs can, well, execute commands. If the %player% placeholder is present in a command, it will execute only for that player, otherwise the command is global.
Commands can repeat every tick, in orbs.yml you can see "repeatEveryTicks", in the default orb.yml file:
commands:
- eco give %player% 1
repeatEveryTicks: 20the eco give %player% 1 command is repeated every second (20 ticks = 1s), so the player will receive $1 every second.
Fishing Orbs
Those can change the speed of fishing spawn and the time it takes to bite. Please note that this feature is only available for 1.17+ at the moment.
Here's how it works in default orb.yml, info from Spigot javadoc:
#Set both the minimum (default 100) and maximum (default 600) amount of ticks one has to wait for a fish appearing.
min-wait-time: 10
max-wait-time: 40
#Set both the minimum (default 20) and maximum (default 80) amount of ticks one has to wait for a fish to bite after appearing.
min-lure-time: 10
max-lure-time: 60
Spawner Orbs
This orb works as a normal orb, but spawns mobs. There are some specific configurations to it:
spawner_orb:
type: spawner
name: "&e&lPig Spawner Orb"
lore:
- "&7Area: &e%aoe%"
- "&7Duration: &a%duration%s"
- "&7Cooldown: &c%cooldown%s"
- "&7Spawn delay: &a%delay%s"
- " "
- "&7Price: &a%price%"
duration: 12000 #10 minutes
cooldown: 300000 #5 minutes
effect-delay: 600 #How often mobs will spawn, in ticks. 20 ticks = 1s.
aoe: 25 #Area for the mobs to spawn
max-mobs: 25 # Max number of mobs this Orb can have alive at the same time. Killed/despawned mobs free up the limit.
mob-type: PIG #The Entity type to spawn. Reference: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html
price: 100
permission: ""
ownedByServer: true
spawn-particles: true
particles: FLAME
head: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZWIxOGZjNTZiNWVkMzg5MDFiNzdjZTA2MThhYjIyZTcwMzJmMDI5OWM3MGM1MTBmMmYyZDViM2UwN2U5ZjI3OCJ9fX0=" Flower Orbs
This orb can spawn flowers. Configuration is the same as the Crop file.
Comming soon: Schematic-related Orbs (Trees, structures), PvP-related Orbs, Mob-related orbs. Leave your suggestions for orb types.
Settings.yml file
It's a pretty simple file. Everything that you need is in orbs.yml, but I'll list some important options.
Storage:
Type: SQLite
MySQL:
Host: localhost
Port: '3306'
User: user
Password: '123456'
Database: database
Update-Interval-In-Ticks: '6000'
Orbs-Load-Delay-In-Ticks: '300'
Global:
Use-Vault: 'false'
Check-For-Persistent-Meta 'true'
Orbs:
Region-Protection:
Protect-Crops-Orb: 'true'
Protect-Commands-Orb: 'false'
Protect-Effects-Orb: 'false'
Protect-Fishing-Orb: 'false'
Load-Chunks-On-Start: 'true'
Always-Check-For-Old-Entities-On-Start: 'true'
Grow-Crops: 'true'
Show-Server-Orbs-Display-Name: 'false'
Particles:
Offset-X: '0.3'
Offset-Y: '0.2'
Offset-Z: '0.3'
Particle-Amount: '15'
Particle-Delay: '15'
Farming:
Closest-First: 'true'
Spawner-Orb-Remove-Entities-On-Despawn: 'true'- Storage: MySQL or SQLite
- Load-Chunks-On-Start: Will load chunks where the orbs are when the server starts.
- Always-Check-For-Old-Entities-On-Start: Checks for any orbs (Armor Stands) that might still be in a location in case of a server crash, this will remove those old entities.
- Farming.Closest-First: Crops orbs will sort the cache block list by distance.
- Spawner-Orb-Remove-Entities-On-Despawn: Removes entities that was spawned by the orb when the orb is removed.
Language.yml
And of course, you can change every single message that players can see.
Messages:
Cooldown: '&cWait %time% to use this orb again!'
Recharged: '&eYour &c%orb% &eis ready to use!'
No-Permission-Generic: '&cNo permission.'
No-Permission-Buy-Orb: '&cYou don''t have permission to buy %orb%&c.'
Not-Enough-Money: '&cYou don''t have enough money to buy %orb%&c.'
Purchase-Successfully: '&aOrb %orb% &apurchased successfully.'
Menu:
Name: '&e&lSelect an orb'
Items:
Next-Page: '&a&lNext Page ➡'
Previous-Page: '&c&l⬅ Previous Page'
TimeUnits:
Milliseconds: milliseconds
Seconds: seconds
Minutes: minutes
Hours: hours
Days: days
Permanent: Permanent
Orbs:
Player-Orb-Display-Name: '&b&l%player%''s %orb%'
Server-Orb-Display-Name: '%orb%'
Generic-Orb-Display-Name: '%orb%'
Support
For now, please send me a Private Message, it's the best way I can help you out.
