Documentation
Documentation
It is recommended to have Multiverse-Core installed on your server !
It provides a better world managment ;)
Commands and Permissions
/hg join - hungergames.join - Join the current game.
/hg leave - hungergames.leave - Leave the current game.
/hg infos - hungergames.infos - View infos about the current game.
/hg winners <page> - hungergames.winners - View the winners.
/hg kit create <name> - hungergames.kits.create - Create a kit. Supports colors :D
/hg kit delete <name> - hungergames.kits.delete - Delete a kit. You must include the colors codes (if any).
/hg setlobby - hungergames.lobby.set - Set the lobby's spawn to your current position.
Create a kit
As of v0.5.5, you can create kits !
Use /hg kit create <name> to create a kit (supports colors). The first item of your inventory is used to be the icon. Players need to have the permission hungergames.kits.use to obtain a kit. That's all ! You can delete a kit with /hg kit delete <name>.
Example : /hg kit create &7Iron. Create a kit with the name Iron in gray. You can delete it with /hg kit delete &7Iron.
Please, if you want to give armor, do not wear it ! The plugin takes only your inventory but not your armor !
What is the file "config-data" ?
It where the plugin stores its data. You can edit it so you can add kits, rewards and random items. I have added examples, please keep the same format !
Configuration
VERSION | Leave as it ! Only for future updates. | ||||||
enable | metrics | Enable the Skyupdater. | |||||
updater | Enable MetricsLite. | ||||||
bungee | server-name | Put the Bungee server's name of this server (if any). | |||||
bugs-report | enable | If you want to enable automatics bugs reports. | |||||
your-name | Your name. By default, it is the server's name. | ||||||
your-mail | Your email. You can enter fake data if you want ;) | ||||||
maps | folder | The maps folder. | |||||
game-rules | Choose the gamerules you want to apply. | ||||||
default-time | The default world time. | ||||||
generate | enable | Generate the current map (the maps folder is useless if you set this option to "true"). | |||||
map-name | The name of the generated world (if enabled). | ||||||
borders | enable | If you want to add some borders to your world. | |||||
radius | The border radius. | ||||||
type | Can be "INVISIBLE", "SQUARE", "ROOFING", "CYLINDER" or "VOID". But you should leave "INVISIBLE" (less laggy and does not need WorldEdit. If you still want a physical border, please note that there is not any automatic protection on it). | ||||||
material | The material of your border (if you have set "Type" to "INVISIBLE" or "VOID", you can ignore this option). A list of available materials is available here. | ||||||
meta | Used to determine the data of the border block (for the wool by example. If you have set "Type" to "INVISIBLE" or "VOID", you can ignore this option). | ||||||
lobby | world | The world of the lobby. Can be an existing world but not a map where you play. | |||||
spawn | x | The X coord of the spawn. | |||||
y | The Y coord of the spawn. | ||||||
z | The Z coord of the spawn. | ||||||
countdown | time | The time when the minimum players is reached. | |||||
exp-bar-level | Displays the countdown in the exp bar of each player. | ||||||
mob-bar | Displays the countdown in the mob bar (same bar as the Enderdragon). | ||||||
protect | If you want to prevent griefing on your lobby. Useless if you have WorldGuard or something like this. | ||||||
game | dedicated-server | If you want that players auto-join the game and cannot leave it. | |||||
min-players | The requiered players to begin. | ||||||
max-players | The maximum players who can play (but if you enable spectators, they still able to join the game as spectators). | ||||||
spawn-distance | The random distance (generated from the spawn). | ||||||
auto-sneak | Enable auto sneaking (hide players names). | ||||||
compass-nearest-player | The compass will locate the nearest player if this option is enabled. | ||||||
death-name-sky | Show the name of dead players in the sky. Requires Effectlib. | ||||||
random-items | delay | The maximum delay between two items spawns. Please note the delay itself is random. | |||||
chests | Spawn items in chests. | ||||||
distance | The random distance (generated from the spawn). | ||||||
thundering | Strike a lightning effect on the random location. | ||||||
motd-change | If you want to change the motd (messages are in the configuration messages.yml). | ||||||
countdown | time | Before enable damages. | |||||
exp-bar-level | Displays the countdown in the exp bar of each player. | ||||||
mob-bar | Displays the countdown in the mob bar (same bar as the Enderdragon). | ||||||
death-sound | sound | The sound that is played (you have a list here.) | |||||
volume | The volume of the sound (between 0 and 1). | ||||||
pitch | The pitch of the sound (between 0 and 1). | ||||||
enable | Used to enable (or disable) rewards. | ||||||
blood | players | Enable blood on players. | |||||
mobs | Enable blood on mobs. | ||||||
spectators | enable | Enable the spectators. | |||||
mode | If "GHOST_FACTORY" does not work, set the value to "INVISIBLE_POTION". | ||||||
permissions | chat | If spectators can chat. | |||||
pickup-items | If spectators can pickup items on the floor. | ||||||
interact | If spectators can interact. | ||||||
kits | selector | name | The name of the kits selector (and the inventory). | ||||
material | The material of the kits selector. Use the same format than others materials. | ||||||
permissions | Enable individual permission for each kit. The permission will be hungergames.kits.<kit-name> (colors codes are stripped). | ||||||
logs | console | If you want to log actions on the console. | |||||
file | enable | Log actions into a file. | |||||
directory | The log directory. Only if enabled. |
Error reports
How they work ?
From v0.5.3 to v0.6, when the plugin catch an error, it sends the stacktrace on a website called Skyost Pastes and, after that, sends it by e-mail to me. That's all. No others data are collected. You can disable those reports in the configuration.
As of v0.7, the plugin connects to the Project HungerGames' website and post the error log. I receive it in a dedicated mailbox (it avoids spam on my main mailbox).
Examples
config.yml
Watch it here.
messages.yml
Watch it here.
Hi, excellent plugin, Great work. By the way, I can't figure out how to set up specific spawnpoint for players. It keep randomize them. Thanks
Can you add more lines for Kits ? :/ Beacsue i have more than 30 Kits and i can't choose them because we don't have lines...:(
LINKS ARE BROKEN!
The pastings were possibly set to expire?
Examples
config.yml
Watch it here.
messages.yml
Watch it here.