SurvivalGames is a Sponge Plugin which lets you play the classic Minecraft Survival Games game mode on your Sponge Server! You can run multiple survival games at once, and each game is customizable. Config files for survival games can be saved and loaded from file.
This plugin was created for the Sponge Summer Plugin Competition 2016.
NOTE: Players participating in the demo must be operators.
NOTE: Command blocks must be enabled to use all the features.
Installing the plugin on your server gives you instant access to survival games. just run /ssg demo
to have the demo worlds and config files automatically downloaded. I'm still working out bugs, so please run it on a fresh server.
Run these commands to get the server running:
/ssg demo
- Wait for all steps to be completed
- For each player:
/ssg add player demo <player>
or for yourself:/ssg join demo
/ssg start demo
Everything which can be set via a config can also be adjusted through commands. The root command is /ssg
. Other commands include:
/ssg create <game>
Creates a new survival game/ssg delete <game>
Deletes a survival game/ssg load <game> <file>
Loads a survival game from a config file/ssg save <game> <file>
Saves a survival game to a config file/ssg set <game> <property> <value>
Sets a p\config value of a survival game/ssg print <game> <property>
Prints the current value of a config property/ssg add <game> <list-propery> <value>
Adds a value to a list property. Examples include spawn points and players./ssg remove <game> <list-property> <value>
Removes a value from a list property.
Each command has its own permission, based on the structure of the command in the command tree. For example, to run /ssg add player
, you need the permission "ssg.add.player"
.
Each survival game config has the following options:
- World name
- A vector for the center of the map
- Spawn locations
- Boundaries for the game (World borders are created from this)
- An exit world and vector, for teleporting players who have perished in the games.
- Loot for spawning items in chests
- Mob spawners
You can configure a certain region to spawn mobs when a survival game is running. This is done via the /ssg add mob-spawn-area <game> <x> <y> <z> <x> <y> <z> <EntityType> <EntitysPerMinute>
SurvivalGames has its own events which are fired when game-related things happen. Not only can other players use these events, but SurvivalGames also can fire command blocks with the command /ssg event [EventName]
. This allows for mapmakers to do some really custom stuff!
For example, If a command block is set with the command /ssg event MobSpawnedEvent
, then whenever a MobSpawnedEvent occurs, the command block is executed. It is then turned into a redstone torch for 5 seconds, so surrounding blocks can be powered. (This is a temporary workaround)
You can view the Javadocs here: http://mattysweeps.github.io/SurvivalGames/docs/index.html I recommend you just look at the source code ;)
Don't forget to add the git hooks:
cp scripts/pre-commit .git/hooks