MinigamesLib
MinigamesLib
Currently there are 16 released and three unreleased minigames and more are planned to be added soon.
That's the API I'm using in all of my newer minigames. Of course you are free to use it too, be sure to drop me a message and I'll list your project here too. There's Arcade functionality already included which enables you to be able to play all minigames in one run, you just need to install MGArcade.
Important links:
- Github Repo
- Wiki
- JavaDocs
- Minigames Github Organisation (I upload all minigames using this API here to keep things organized)
- Maven repo
- Forum
Development Files (towards MinigamesLib 1.13)
Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk. Link: https://drone.io/github.com/instance01/MinigamesAPI/files (use the file in the mid)
I usually upload a new release on bukkitdev every 20-30 commits and sometimes they contain ciritical bugfixes. Here you can download these pre-releases while they're not on bukkitdev yet. You might want to turn off autoupdating in the MinigamesLib config if you use these builds.
Tutorials and Trivia (hidden features)
- Default Config explanation and Item Markup tutorial
- All commands
- Kit Configuration: Coming soon. Just copy paste current kits and adjust them to your needs, if you want to disable a kit, add "enabled: false" to it.
- Trivia (cool side infos)
- MinigamesLib-Bungee tutorial: https://www.youtube.com/watch?v=_863fMQpKm8
Minigames
Links are pointing to the github repos where the projects aren't up on bukkitdev yet.
Project | Done | Released | MGLib Compatibility |
---|---|---|---|
FlyingCars | ✓ | ✓ | 1.7-1.13.x |
Snake | ✓ | ✓ | 1.7-1.13.x |
Warlock | ✓ | ✓ | 1.7-1.13.x |
Warlock-Tactical | ✓ | × | |
Bowbash | ✓ | ✓ | 1.9.1-1.13.x |
MGArcade | ✓ | ✓ | 1.9.1-1.13.x |
MGMobEscape | ✓ | ✓ | 1.9.1-1.13.x |
MGSkyWars | ✓ | ✓ | 1.7-1.13.x |
Trapdoor Spleef | ✓ | ✓ | 1.7-1.13.x |
Gungame | ✓ | ✓ | 1.7-1.13.x |
Conquer | ✓ | ✓ | 1.9.1-1.13.x |
NoteblockBlitz | ✓ | ✓ | 1.13.x |
ChickenVolley | × | × | |
SeaBattle | ✓ | ✓ | 1.9.1-1.13.x |
Splegg & Spleef | ✓ | ✓ | 1.7-1.13.x |
BedWars | ✓ | × | |
DeathRun | ✓ | ✓ | 1.13.x |
OneInTheChamber | ✓ | ✓ | 1.13.x |
MinigamesLib-Bungee (Download is on the full package link on the spigot page) | ✓ | ✓ | 1.9-1.13.x |
! means work in progress, x means not started/released yet.
What does the MGLib Compatibility column mean? This means that the latest file is only compatible with the given version.
All minigames built with this API will be automatically available in Arcade, which means you can play all of them in one run.
Features
- Arenasystem
- Customizable messages
- Different minigame types
- VIP Arenas
- Economy, command and item rewards
- Overall Customization/Attributes like player counts, countdowns, spawns, boundaries etc.
- Signs and corresponding Arena states
- Fast map regeneration mechanism
- Kits/Classes and Classesmenu
- Arcade (play all games in one run)
- MySQL/SQLite support
- Gun API
- Bungee support
- Party (/party)
- Additional shops with Gui
- Achievements
- Included effects like blood or dead bodies lying around
- Moar stuff
Arcade and MinigamesParty Info
I started redirecting people from MinigamesParty as I don't plan on doing big updates on MGParty anymore. It's an old idea/system I was using there, MinigamesLib is my new approach. So how does this new system work?
Pretty simple, it consists of a core, MinigamesLib, and a bunch of minigames you can download seperatly and install on the server. You can now setup arenas for each minigame and change pretty much everything else what the minigame offers for customization. If you now want to have something like MGParty, install MGArcade which will automatically recognize all installed minigames and use the respectively first arena available, and that's pretty much it. A bit more setup work, but more stable and more customization. Also the minigames aren't limited to 1 minute! If there's still big demand on big MGParty updates with new minigames, I'll of course think about it. :)
Enchantments, PotionEffects and Sounds
- Please use the following enchantment names for the kits of all minigames: http://jd.bukkit.org/rb/apidocs/org/bukkit/enchantments/Enchantment.html
- For potioneffects use the following names: http://jd.bukkit.org/rb/apidocs/org/bukkit/potion/PotionEffectType.html
- For sounds use these names: http://jd.bukkit.org/beta/apidocs/org/bukkit/Sound.html
- Here's a tutorial on how to include enchantments and potioneffects in the classes.yml: Default Config explanation and Item Markup tutorial
MySQL
As of v1.4 MySQL Support is fully functional, each minigame creates its own table and will save stats like points, wins and loses into these. To use MySQL enable it in the config.yml of each minigame you want and create a database called "mcminigames". Reload the server, done.
Upcoming version: 1.12 (Uploaded 6th December)
- Fix XP
- Adds spectate command
- Will now use 1.8 titles to display you_lost or you_won message
- Adds option whether to use xp bar levels or not
- /mapi info will now output all arenas with their players
- Adds Holograms as damage indicators
- Make TP Fix distance lower
- Cleanup and some API work
- More user input validation when parsing items
Party system (v1.6)
People can now invite players to their party and join arenas together with their friends, just like many huge networks have these now. To change messages of the party commands take a look at partymessages.yml in the MinigamesLib directory. The main command is /party and shows all available subcommands with small descriptions.
Additional Information and disclaimers
Contact me if you would like to help me out or join the MCMinigames Organisation on github.
This plugin has an autoupdater included which you can turn off in the MinigamesLib config (auto-updating: false). Also, it utilizes Hidendra's Metrics system which sends information to his metrics server like java version, server version, plugin version, player count, OS version/name, Metrics version, which I can later look at and be happy with. Can also be turned off in the Metrics config which can be found at /plugins/PluginMetrics/ (opt-out: true). This is the only plugin having Metrics/Updater, all the minigames from above do not have stuff like that included.
Having Problems?
Please use the Forum to report any bugs or suggestions.
Have fun. :)
@instancelabs
For example: &6Time remaining 10, &cTime remaining 5, &cTime remaining 4, &4Time remaining 3, &4Time remaining 2, &4Time remaining 1. Or if there were a cooldown in the scoreboard also that change color ;)
@ferrago
Well, MinigamesLib-Bungee was removed by curse.
@ELSaitam
I think there are sounds already there for both cooldowns, check the config for the sounds section. What do you mean by a cooldown with different colors?
@Skippaddin
To add more items check the item markup tutorial. You pretty much just have to add a semicolon (;) and then the new item. So if you current items are: 5*64;10*1 and you want to add 32 stone, you'd have: 5*64;10*1;1*32
@stefan457yt
The extra lobby item only works with commands that the console can execute, what command did you try? The permission for setarenavip is [minigame].setup. Be aware that this permission node is also used for all other setup commands.
@instancelabs
Would be a good idea to add: in skywars (a cooldown after being released the players stop to activate the pvp arena), add a cooldown of different colors before reaching the time limit each minigame and sounds to the cooldown ;)
@instancelabs
I am pretty sure Bungee and alt server Apis plugins are allowed here now since the whole Dev /quit fiasco.
@maxlehot1234
You have all of the reason! Bridge Minigame on Spigot its a sh!t
i like the plugin from Mineplex
Please add The bridges mini-game. If you create a mini-game like the bridge, I download this plugin and make advertisement for your plugin on my server ;)
I pay, the bridge minigame on spigot, but no updates and not works...
@instancelabs
instances extralobby item does not work, when placing commands it commands does not work.
other thing, which is the permission of /sw setarenavip?
Can you add PlantTheBomb with guns :) it will be nice
Hi, can you please tell me how to add more items in the classes.yml or is it not possible?
@Floodeer
If you mean bungee signs, I dropped the support. It got deleted anyways, because now these kind of plugins (with bungee support) aren't allowed here on bukkitdev. But I'll someday redo it with sockets and upload it on spigot then.
@DanSpedey
True, I'll update the description real quick. :)
@instancelabs
The signs are not updating correctly, both the number of players and also the status of the arena.
@ELSaitam
Instance has attempted this however he did not release the feature as he felt it was not 100% working. He may try and add it again in the future.
@ferrago
He will not be porting to Sponge, he said he will stay with Spigot unless there are problems. The information about porting to Sponge is outdated and probably needs updating :P (*Cough Instance cough* :P)
@instancelabs
anything, anything better for this incredible plugin ;) . It would be nice to be shown the name of the kit chosen in the scoreboard of the lobby :D
@instancelabs
Why sponge over spigot 1.8 which will be released relatively soon, and is familiar to majority of servers, whereas sponge is new and far away from fully complete.
@DBawesomeness17
Never played super cube bros, any server I can see it on?
@ELSaitam
Good idea, I'll add that cooldown option to the scoreboard. :)
@Unitgames
Yeah that'd be indeed quite interesting, not sure yet however how hard the setup for users would be. I think for now I'll concentrate on other games first, but thanks for the idea ;)
I am your biggest fan instance you were the first to create plugin that no one could do or did and put as paid (private) no longer abuse know you're a great creator plugin would be more fun for the mini-game Dragons (mineplex) if you are trying to make even more thank you!
@instancelabs
Add cooldown in the scoreboard of the lobby and time of completed game to the game scoreboard. ;) in order to make the cooldown of the chat because it is a little annoying, in some games.
OK, I will take a photo of the sand ladders.
I think you should try to add paintball, and possibly super cube bros because they would had a very cool aspect in my opinion
@instancelabs
Thanks :D
@ELSaitam
Hm, they do for me, can you do a screenshot of your ladders before the game?
@Floodeer
Alrighty, use SkyWars 1.4.5.