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
Add sound to the cooldown-editable and editable sounds at the end of the game
@instancelabs
and be able to modify at speed leaving the Fireworks
@instancelabs
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
@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
@TheL0w3R
Curse stopped the approvals at the day I uploaded 1.9.1 because of some incident where people could exploit the approval system and get through malicious code. They said they'd get a fix done in the next days and then start approving again.
Where's the download Link of MinigamesLib 1.9.1?
@instancelabs
Because spectators are being pushed to the side?
The high is normal and the fall don't kill them normally. The Spawn point is at y=61 I use the latest version of MG-Lib and MG-SkyWars and there is nothing in the console.
I notice that this glitch frequently happens when the player wins last round.
@antoinefunloup
I guess you're setting the spawn too high on Skywars and they fall too far down. If there's nothing in console, it must be something wrong with your setup or you're running an old version of MGLib.
I encounter a big problem in all mini-games, especially in MG-SkyWars. Sometimes, the player die when the games starts, without raisons. I've checked the bedrock level and all the other settings : i don't find.
@Bimmr
My server,but it is Chinese server.
Does anyone have a server with a bunch of these minigames on it? I would really like to see exactly how they work(Thinking about making a minigame using this API)
@DBawesomeness17
Well I'm still continueing right now, but I had planned to port everything to Sponge when it's out. After the Spigot news (they're doing full 1.8 release) I'm not sure though, I'll see which one of these platforms will be the main one and then move to it (or just stay if it's spigot).
Both have their downfalls: Spigot needs their patching which means more work and many server owners (especially kids) won't do that work. Sponge has their dependency on Forge and MCP which I'd say means a huge bummer for their update times. So we'll just see which of these evolves to be the main one. :)
Hey I was wondering if you were going to keep developing these plugins, or not because of the bukkit shutdown?
Ok, thank you!
@themindstorm
I see what you mean, yeah. Well there's actually something like score already implemented, if you look into your stats.yml of any game you'll see that you get points for winning and kills. I could transfer that to a global one for MinigamesLib and add an option to use these score points instead of money to buy kits, sure.
@iinstancelabs
i actually mean the scoreboard in the MGSkyward shows credits and then the number if credits. I am fine with the scoring system but what i am asking is, of all the minigames in your library, can it be such that the credits are same for all. Like i earn 40 credits in splegg. Then i want to buy a class/kit in skywars. Can i have it that i can spend thise 40 credits i earnt from splegg to buy a skywars kit. I think it is better to have score system which is common for all minigames Thanks for making all these minigames! Their awsome
@instancelabs Do you mean these plugins use the economy essentials?
@themindstorm
Well that's not possible as of now, right now you can only use economy for kits. I might think of adding an optional points system, but first off I'll need to finish the current features.
@cedric0911
Check config.yml, you can set it to lose below the bedrock level.
MobEscape
I have a problem please help me when I jump to a lower platform I lose the game the low bounds are correctly and the hight bounds are also correct
I´m german my English is not so good I hope I receive nevertheless help