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. :)
where do i find the play permissions. and the vip permissions and the other permissions?
i can only find the setup start and stop permissions
@beccamo
What was the problem?
I solved xD
@instancelabs
4 spawnplayers
@DanSpedey
Yes, the map is flat.
@beccamo
How many spawns did you set?
@mmuziek
Yeah I'll continue with this version as spigot is updating, but still, if literally everyone will keep moving over to Sponge, I'll follow. Let's just see how both projects evolve ;)
@beccamo
Is your map flat? Do you have any carpets or snow laying on the surface of the map?
@mmuziek
The current plan is to stay with Spigot with 1.8, there were plans to port to Sponge however Instance has scrapped that and is staying with Spigot.
sorry that i have to ask. but i use spigot and spigot is gonna update in this or next month according to the news post its an estimate but i have faith.
will you keep updating this plugin. or abbandon this project completely into sponge?
thanks in advance
@instancelabs
No more crashes. Thank you for having solved. But I wanted to ask you something, why MgSnake does not work? When players are playing out right away and they lost out.
I'm sorry but I don't speak English well
@instancelabs
Yes, 1.9.4 has corrected the errors for me too!
Thanks, the version 1.9.4 has fixed the game crashes. :)
Alright the crash should be fixed as of v1.9.4, it was caused by the fakebed effect when having the mainlobby in a different world than the arena. Commit
If you still get crashes in 1.9.4, disable effects in config and let me know if it works then.
Here is the crash log. Crash Log
@Skippaddin
Do you think you can paste your crash log at www.pastebin.com and then link it here please?
I tested the new version and I still get crashes. It crashes everytime when I get teleported to the main lobby after a game.
Uploaded MinigamesLib 1.9.3 and removed scoreboard temporary, let me know if you still get crashes.
@instancelabs
I have both bungeecord and spigot 1.7.9. Unfortunately, now if I use the 1.9.0 MgSnake and MgMobEscape not work.
I have the same problem like beccamo. When a game ends the client of every player who played this game crashes. I have this problem with every Minigame which uses MinigamesLib. I use CraftBukkit version git-Spigot-1496 (MC: 1.7.9) (Implementing API version 1.7.9-R0.3-SNAPSHOT). So it can´t be that the problem is caused by 1.8. If i use the the MinigamesLib version 1.9.0 everything goes fine. Here are the configs of the games I use on my Server: Link Removed: http://www.mediafire.com/download/8kpkc855h5h495l/MinigamesLib_Configs.rar
@beccamo
Yeah, many people have been reporting that in 1.9.1 and 1.9.2. I don't know what's causing it and I can't reproduce it, so for now I can't fix it. Just use 1.9.0 for now, it should work there.
It would really help me out if you could send me all your configs of MGSkyWars in a zip file or something and what server software you're running (Bungeecord and spigot with 1.8 support?), maybe I can reproduce and fix it then.
Edit: It looks like it has something to do with 1.8, maybe scoreboard changed thus people using the latest spigot patches might have problems.
hello @istancelabs,
I have a problem, I updated the version of MinigamesLib to 1.9.2, when I play a minigame that uses any Minigameslib crash the client of any player who plays that game. Can you help me? If I put the previous version of the minigames Snake and MobEscape no longer work.
Why not create a minigame Chamber?