-
Notifications
You must be signed in to change notification settings - Fork 7
Setup
This guide will walk you through all the steps required to run the HungerGames plugin and create a game.
For the video tutorial visit Youtube
Download the plugin from Modrinth or SpigotMC and drag it to the plugins folder of your server. If you don't have experience installing plugins before, watch this tutorial.
Before you can setup a map of your choosing, you have to first set up world files. To do that, first install the plugin, run the server once and then close it. After that choose a world you would like to have as your lobby, you could have the default world that's generated by Minecraft, create your own or download one online. The lobby is the place where the players will visit when they join the server and be teleported to before and after games. Once you're done, keep a note of the name of the world and set the lobby-world key in the plugin config.yml file to the name of your lobby world, ensure there are no spaces in the world name. If your world name has spaces, you have to either replace them with underscores or just remove them.
Download a world from anywhere you wish, make your own world or use a plain world. It's recommended to download a Hunger Games specific world. You can find maps almost anywhere but one of the best places to look for maps is PlanetMC. A map I would recommend, which I personally use, is SeaCliff SG by Berserker Builds. To go to the map from the lobby, run the command /hg map <world_name>, replacing <world_name> with the name of your world. Be sure to also set server settings to your liking such as difficulty. It's recommended to disable mob spawns and set the game mode to adventure since this plugin doesn’t restore the map after a game. Also give yourself operator and creative mode to run the required commands to set up the plugin. Note that this plugin supports multiple maps so you don't have to stop at just one.
The next step would be setting up the arena. The arena selection is responsible for refilling chests and placing Supply Drops. While selecting the arena, you have to make sure that all blocks in the map are in the arena selection. To select the arena, run the command /hg select. This will give you an Arena Selector. Now go to one corner of the map and locate the lowest block. Left click that block with the Arena Selector. Then go to the opposite corner and go to the highest block, make sure this is the highest block on the map, if not, place a block there higher than that, an easy way to do that is using the /hg setblock command. For the second corner, right click the block. If you're not happy with the block you selected, you can just left click to select the first position and right click for the second. Once you're happy with your selection, you can run /hg create and this will create a cubic arena based on the two positions that have been selected.
Once you have the Arena set up, you have to set up the border. The border will start shrinking after a certain amount of time so you want the border to be exactly the size or slightly bigger than the world so the whole area is accessible. To that, use the /hg border num_blocks center_x center_z command, replace num_blocks with the number of blocks you want your border to be and center_x and center_z with the x and z coordinates of the center of your map. Note that num_blocks represents the total length and width of your border, not the distance from the center to one of the edges. An example of this command would be /hg border 700 0 10. Here, 700 is the length of the border, 0 is the x coodinate and 10 is the z coordinate of the center of the border. The border will start to shrink after the game has started, damaging players outside the border. If you wish to disable border shrinking or change the rate of border shrinking, visit the Config Wiki
If you already downloaded a map online, it might already have chests. You can edit all the chests you want but keep in mind that there are different tiers of chests, with different tiers of loot. There is the regular chest, trapped chest and a barrel. By default, the regular chests have the worst loot and the barrels have the best loot. If you want to change the loot tables for the chests, you can visit the Items Wiki. Ensure that all the chests in the map are the ones you want. Some maps will have Ender Chests which can't be refilled by the plugin due to them using a different inventory type or Shulker Boxes which are reserved for Supply Drops. In case of that you can manually break and replace them, or use a plugin like Worldedit to replace all the Ender Chests with barrels for example. I personally play with having trapped chests (medium loot) in the middle of the arena and barrels and chests scattered throughout the map. Once you're happy with the different types of chests in your arena, you can run the command /hg scanarena. This command will scan the whole arena for chests and save the coordinates to a different file. This command can take up to 30 seconds to execute depending on your server specs, so it's normal for the server to be unresponsive during that time. Please note that if you change the position of chests or replace chests, you need to run the /hg scanarea command again.
Once you've set up chests in the map, you can start setting up Spawnpoints. Spawnpoints for this plugin are the locations you want the players to start the game from after joining for the lobby. We'll create the lobby later. In most Hungergames maps, near the center, there are blocks in the center that represent starting points. To set spawn points, run the command /hg setspawn. This will give you a spawnselector, to use it just left click the block. This plugin supports up to 24 spawnpoints, and every block you click will be set as one of the spawnpoints. If you misclick or are not happy with the spawnpoints, you can run the command /hg setspawn again and this will reset the spawnpoints. While selecting spawnpoints, ensure that the arena is accessible from those spawnpoints.
Once the worlds have been set up, return to the lobby using the hg lobby command. Once there, place signs equal to the number of worlds on the wall on the same y level. Then go to the leftmost sign and run the command /hg setsign. This will change the text content of the signs to the name of the worlds along with some other detail. Now to go to any of the worlds, players can click on the signs or use the /hg join <world_name> command.
Finally, once you have mulitple players in the spawnpoints, you can run the command /hg start and this will start a timer of 20 seconds and start the game after this. To learn more about the how the game works, visit gameplay Gameplay Wiki. To change settings for the game including time, supply drop rate, number of chest items visit the Config Wiki. Have a fun game!
This plugin supports a team mode where players are randomly put into teams of players based on the config.yml. To enable it change the key players-per-team in the config.yml file to however many players per team you want in the plugin.