Hunger Games Network
Hunger Games Network (Version 1.5)
The contents of this document can also be found on our website in a much nicer-looking format
The best way to demonstrate this plugin is to try it out yourself. Click here and join a server from the Server list to try it out!
The plugin was on the front page of r/Minecraft. You can view the thread by clicking here.
<br /><br />
<br /><br />
What this plugin does
Are you frustrated with the lack of dedicated hunger games server plugins? Ones that run like the bigger servers do with custom maps, or randomly-generated maps? We were too, so we did something about it.
This self-contained plugin is simple and can be set up very quickly. Once you have set it up, you won't need to touch it; rounds will begin automatically after short periods of time, and cleanup will happen automatically.
The plugin allows two game modes: one "classic" experience and the other with custom maps. In the classic experience, you are given a short amount of time and a few starting items depending on the "kit" you choose before PvP is enabled, at which point the last person standing wins. In custom map mode, you can either use a bundled map or make one of your own with a very easy-to-use plugin called MapLoaderSetup. You'll drop the resulting .zip file inside of the plugin folder, and you'll be all set.
<br /><br />
<br /><br />
Why you should choose this plugin
-
We are one of the few groups distributing high-quality Hunger Games plugins, whereas other well-known “Survival Games” servers keep their plugins to themselves.
-
This plugin is 100% free, as are all future updates.
-
There are two main modes in this plugin, one offering a “classic” experience in randomly-generated maps and one in which you use custom maps.
-
In classic mode, players are given a short period of time to acquire resources in a couple minutes of invulnerability. They start out with a few items according to whatever “class” they choose.
-
In custom mode the server owner drops in a map bundle, such as Vareide‘s Survival Games maps (all three of which are included in the plugin download), and players fight to the death. Map bundles can be easily made, and instructions can be found on our homepage
-
We include stat tracking, which will be improved over time
-
Classes (for use in "classic" mode) can be unlocked through normal gameplay at a more-than-reasonable rate, and credits can be purchased online for a very reasonable price.
-
Credits purchases go toward keeping the Central Server service online, and any excess funds are donated to the EFF, who fight for our Internet freedoms
-
When running the plugin, you’ll automatically be added to the Server List
-
Anti cheat functionality; currently only anti-xray. More features will be added and refined over time.
<br /><br />
<br /><br />
Installation
- Classic mode
- Custom mode
- Changing server address
- Removing your server from the server list
- Changing the plugin language
<br />
-
<a id=classic>Classic mode</a>
- Drop the plugin jar into the server plugins/ directory.
- Run the server once (it’ll automatically shut down) to create the config file
- If you've run custom mode before, make sure that plugins/Hungergames/map/ is empty.
- If you have a custom server address, go to Section 3.
- If you don't want your server to appear on the server list, go to Section 4
- If you want to use French, German, Chinese, or Dutch localization, go to Section 5
- Start up your server and play
-
(Optional): Modify the standby world to your heart's content (you have to be OP to do this))
-
<a id=custom>Custom mode</a>
-
Drop the plugin jar into the server plugins/ directory.
- Run the server once (it’ll automatically shut down) to create the config file
- Drop any number of bundled map zip files (such as the ones included with the plugin) into plugins/HungerGames/map/ . If you want to create your own bundle, see Making Custom Maps
- If you have a custom server address, go to Section 3.
- If you don't want your server to appear on the server list, go to Section 4
- If you want to use French, German, Chinese, or Dutch localization, go to Section 5
- Start up your server and play
- (For OPs: do /map to switch maps)
-
(Optional: Modify the standby world to your heart's content (you have to be OP to do this))
-
<a id=address>Changing server address</a>
-
Open the Hunger Games config file (plugins/HungerGames/config.yml)
-
Change the text after “override-query: “ to your custom server address (such as “play.myserver.com”)
-
<a id=serverlist>Removing your server from the server list</a>
-
Open the Hunger Games config file (plugins/HungerGames/config.yml)
-
Change the text after "server-listed: " from "true" to "false"
-
<a id=localization>Changing the plugin language</a>
-
Open the Hunger Games config file (plugins/HungerGames/config.yml)
- Change the text after "locale: " to deDE, frFR, zhCN, or nlNL
<br /><br />
<br /><br />
Changelog (1.5)
- Added a setting for time before a round begins (minutes-before-start in the config)
- Fixed issues relating to invisible players
- Dead players appear as red in the player list now
- Dead players have red names in chat (replaces the ugly "[SPEC]" tag)
- OP players have gray names
- Corrected player count on the central server list
- Fixed many crash bugs related to the server list
- Fixed spectating players appearing on the Server List as legitimate players remaining
- Prevented conflict between MapLoaderSetup and HungerGames (HungerGames will remain enabled; MapLoaderSetup will go away)
- Fixed a major game-crashing Exception in Classic mode
- Fixed many spectator-related Exceptions
- Fixed erroneous messages being sent to spectators about their command usage
- The kick screen after the round ends displays who won
- The server list now shows the "Game in progress" message even in custom map mode
- The Minecraft server list now properly displays players remaining after the round has started
- Fixed localization on /list
- Endermen no longer pick up nor place blocks
- Fixed a bug related to kills with arrows
- Fixed an issue related to chat
- Fixed the display of max players for custom maps
- Shortened logout time to 15 seconds
- Made a workaround to overriding /help
- Fixed a situation in which alive players would be able to see spectators
- Rounds now end after 25 minutes (with notices in-game)
- Spectators are now reminded of /help
- Added a message to /rewards about offline/cracked servers
- Duplicate server list entries will automatically be removed
- Fixed player counts in server list entries
- /stats <playername> for simple stats
- Changed /rewards to /shop
- Packets are handled on a synchronized task (hopefully no more spontaneous NullPointerExceptions)
- Players can no longer run off their pedestal during lag and open chests (custom map mode)
- Fixed /who and /players
- (MapLoaderSetup) Added confirmation to removal of spawnpoints
- (MapLoaderSetup) Added /breakable [add|remove] all
I like the Plug-in but I have some suggestions:
- Slightly more in-depth config. - Chest Auto Stock and Auto Re-Stock upon every morning. - Don't kick players upon death but just send them directly to spectator (Could be enabled/disabled in the config file) - Configurable Messages. (Custom MOTD, Death Messages, Cornucopia Restocks, Broadcasts etc.) - Voting system for maps - A block-break shortcut like the Green one that allows all blocks to be broken. - Configurable time and player count for the game to start. (Like when there is x amount of players are in-game, a countdown of x seconds will begin, then a notification that the game will begin at x seconds.)
I haven't completely gone through the plug-in so I don't know if this is implemented, but make it so you can set a official spawn, then when the countdown reaches 0, teleport them to it.
I've been looking for ANYTHING that will do map-rotation so this plug-in getting some of these updates would mean a lot considering this is one of the only plug-ins that support it.
Thanks, John.
@TheFluffey
That would totally screw the whole network thing over.
@joshwenke
Write us a email. Maybe we can work out something (-;
@ConnorNJames
If you want to allow for customization, add the command for giving credits already! This way our servers can survive by gaining atleast some donations.
@Hurashii
Hello, You need java 7 for the plugin. It can be found here: http://java.com/de/download/index.jsp
German: Hallo, Du brauchst java 7 fürs plugin. Dies kannst du hier runterladen: http://java.com/de/download/index.jsp
Gruß, Paul
Hei Hello! :)
Im from Germany so sry for my bad english ;o
Here is my Problem...
Why i got this Error? I only put the HungerGames.jar into my plugins folder. And when I started the server, I got this error.
Can you help me?
@ConnorNJames
Well I can tell you that I'm completely satisfied until the kit idea comes into play. Everything else works great, and I'd start up my highly-anticipated Hunger Games server right now if it weren't for the kit barrier.
Adding a few lines of kit customization, or even a seperate kit.yml wouldn't be too advanced for most people. I'd rather have the ability to customize more than to be limited by less.
I don't want to make it sound like this plugin is a bad plugin. I can see it rising in popularity and many people using it once that barrier is removed. It's great, and I love your philosophy behind it. But unfortunately I'm sticking with Survival Games until I see some improvement here.
Also, I'm sure that people (myelf included) would be fine with donating to replace the removal of your kit purchasing restriction.
One last question, would I have your permission to go into the plugin and customize it further to fit my needs, or is that not allowed. Thanks.
@TheFluffey
@joshwenke
The thing is that we *don't* get money from it. We haven't gotten a single penny. If we did care about getting money from it, we wouldn't allow people to earn credits in-game and we'd just host a ton of our own servers (and subsequently not even release the plugin for everyone to use).
The lack of customization options is to make this plugin easy to set up compared to the others with ten billion configuration options that you don't need yet you're going to spend time configuring anyway.
Furthermore, though we don't have a lot of servers running the plugin, it seems that all but one specifically opted out of the server list for whatever reason. As we continuously get good feedback on IRC, through email, or in-game, we know they're satisfied with the simplicity and functionality of the plugin, and that there are things that we need to improve on (which we will). Making it configuration-heavy is not one of those things.
@TheFluffey
Ditto. I mean, it's nice to donate to the developer, but I have no control over my kits which just makes this plugin useless. Sure it's got a nice philosophy but the other Survival Games plugin works a bit better and allows me to make income on my own server as well, not just the plugin developer.
@Schokopudding
Wondering why this plugin is failing? Because people don't like the fact that you get money from it...
@Csanko
unlocked classes are synced to every server running the plugin so there isn't a way for a server owner to manually unlock classes. You can unlock classes with /rewards :-)
How do i unlock kits for normal users??
@jelle12345
I can give you the translation table, so you can add dutch, so we can release it with the next update. PM if you want.
Can i have the code to change the English kitname's in Dutch kitname's?
@StevasaurousREX
No, that's your IP. I gave him the IP/Port on IRC, so I didnt reply on here.
@hephwins
I think you will have to do both http://automation.whatismyip.com/n09230945.asp 174.252.99.8
The first is just text of the second which i believe is their server (unconfirmed but its what I found)
I have my server hosted on a dedicated box, and I have configured the firewall to be extremely restrictive.
I am unable to contact the "central server".
I need to know the hostname of the "central server" and the port(s) used for communication so I can open them up in my firewall. Thank you!
@arcen1k
MC version?
On starting up throws a FileNotFoundException with the path for the HungerGames.jar, it still works, but it is just odd.
the commando for unlocking (/rewards) wont work by me can u help me pls?