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
the ladders do not regenerate
@instancelabs
Sure, but for example, I put a parkour in my foyer, players are taking falling damage. Thus he loses his life, to death and go back to spawn the server. It's a silly thing, I could even use WorldGuard, but would have to check multiple regions...
@Floodeer
Right now I don't see it as that important as you get healed afterwards.
@Vinigamer17
In far future maybe, what would you like to be used for? Showing current countdown or arena or something else?
Add suport to bukkit plugin BarAPI!?
@instancelabs
You can not remove falling damage to the lobby in the next update?
@ELSaitam
Sure, I'll add sounds and some fireworks settings, but what do you mean with your first suggestion? I think you should be able to disable the items in the config (and also achievements.yml) and still use the commands.
@EN7
Good point, minigames like turf wars would be indeed more important. Originally I didn't want to recreate known minigames though, so we'll see. Maybe I'll just post a poll for you guys to vote on which minigames to do first.
And regarding skype, what's your name on skype? May have missed it but I'm pretty sure I reply to everyone, but I didn't get the turf wars suggestions.
Add sheep quest! Please!
@instancelabs
Add option to disable items (classes, Shop, achievement) upon entering an arena, but that you can choose the commands ( /<cmd> kit <kit>, /<cmd> shop <shop> , /<cmd> achievement <achievement> )
I need it please :D
Add to go you fireworks inside the arena to the winner to avoid lag in the mainlobby, and be able to modify in the config the amount of fireworks that come out :D
and be able to modify at speed leaving the Fireworks
Add sound to the cooldown-editable and editable sounds at the end of the game
@instancelabs
Walls and Bridges are already made. Turf Wars should have higher priority, because there is no public Turf War plugin. If you have played on Mineplex or other servers, you would know what it's like, but I can explain it if you want. Also, do you still use Skype? I sent an idea a few days ago.
@instancelabs
It's ... almost. I want to have a way to send credits to the player so he can buy kits...
@mmuziek
@Junac01
Alright, added to proposed minigames list.
@Floodeer
Do you mean for setting a player's stats points?
@instancelabs
You could add a command to add coins. Example: <command> addcoins <player>
@mmuziek
The Walls would be amazing!
or the walls
@instancelabs
Have you considered about The Bridges?
@DBawesomeness17
Yep, both already on the list of proposed minigames ;) I'm still unsure about new bukkit projects, the initial plan was to wait for Sponge to come out before doing new minigames and port over MinigamesLib, but as Spigot will release their full 1.8 version soon, I should probably think about new minigames too.
@DBawesomeness17
I agree survival games is an awesome idea!
Have you considered adding one in the chamber or survival games I think that you add a great aspect to this plugin And when do you think noteblock blitz will be out for download?
@beccamo
Thanks, good to know, I'll fix that. Edit: Included in MGSnake v1.3.3.
@mmuziek
You don't need permissions to play a game, but you can set certain arenas to be vip with /<cmd> setarenavip <arena> <true/false> and then players will need "arenas.<arena>" or "arenas.*" to join that arena. Also players with said permission node can join full games which will kick out players without that permission when the game is not started yet.
@DanSpedey
the map there were flowers and grass...