Skip to content

Running an events server

This guide puts the event plugins together on one Paper server: ShottyEvents runs the events, and ShottyGames, ShottyDeathSwap and ShottyMace are the games. Players vote on what to play, the winning game starts once enough players are waiting, and the winners are paid for every player they beat.

Plugin Why
ShottyEvents Runs everything.
ShottyGames, ShottyDeathSwap, ShottyMace The games. Install the ones you want.
Multiverse-Core Loads worlds; ShottyEvents uses it for create-worlds.
Multiverse-Inventories Keeps each game’s items out of the hub.
ShottyCore companion Optional: network parties, and prizes through /gamewin (announced to the network, paid on your economy server).

Build or load a hub in the main world and point hub: at it:

hub:
world: world
location: "world;0.5;101;8.5;180;0" # where players stand: world;x;y;z;yaw;pitch
sign-location: "world;0.5;108.6;0.5" # the floating "Now playing" sign
on-join: true
void-rescue: true
locator-bar: false

Then choose where the plugin builds its own structures, away from the hub:

  • lobbies.x/y/z and spacing: the waiting rooms, one per event with lobby: true, in a row.
  • vote.platform: the vote platform. Stand where you want it and run /event platform here.

A structure that is already there is left as it is, so you can decorate the rooms and the platform.

Each game plays in worlds of its own. Give them Multiverse-Inventories groups that share everything, so nothing from a game reaches the hub and nothing from the hub reaches a game:

plugins/Multiverse-Inventories/groups.yml
groups:
default:
worlds: [world, world_nether, world_the_end]
shares: [all]
minigames:
worlds: [blockshuffle, itemrace, itemrace_nether, murdermystery, survivalgames, spleef, sumo, snowball,
buildbattle, uhc, uhc_nether, manhunt, manhunt_nether, manhunt_the_end, manhunt_infection,
manhunt_infection_nether, manhunt_infection_the_end, manhunt_assassin, manhunt_assassin_nether,
manhunt_assassin_the_end, tntrun_game, hideandseek, bingo_game, bingo_game_nether, parkour]
shares: [all]
deathswap:
worlds: [deathswap, deathswap_nether, deathswap_the_end]
shares: [all]
mace:
worlds: [shottymace]
shares: [all]

Private lobbies play copies. An event with instances: true played in a private lobby uses copies of its worlds named with the lobby’s slot: sumo_p1, deathswap_p2, and for a Nether or End the slot goes before the suffix, manhunt_p1_nether, manhunt_p1_the_end. Add the copies, up to private-lobbies.max, to the same groups as the originals. The private lobbies’ own worlds (plobby_1 …) only hold the lobby’s room and voting platform; ShottyEvents hands out the hub items there itself.

Each game is an entry under events: in ShottyEvents’ config.yml. The shipped file has entries for every Shotty game. One for a ShottyGames game looks like this:

events:
survivalgames:
name: "<gold><bold>Survival Games</bold></gold>"
description: "Loot the chests, last one alive wins"
min-players: 2
twists: [speed, one-heart, random-items]
worlds: [survivalgames]
instances: true
lobby: true
join:
commands: ["player: games join survivalgames {instance}"]
leave: ["player: games leave"]
start: ["console: games start survivalgames {instance}"]
stop: ["console: games stop survivalgames {instance}"]
reset: []

Add the event ids you want offered to vote.pool. An event can be left out of private lobbies with private: false.

A game names its winners from the console, and ShottyEvents pays:

game ends → event win <winners> --players <n> --event <id> (the game's win-commands)
→ ShottyEvents works out the prize per winner
→ rewards.command, e.g. gamewin <event> <player> <amount> <label>
→ ShottyCore announces the win and pays it on your economy server

The prize is rewards.per-opponent for each player the winner beat, plus the streak bonus, the daily bonus and the champion’s multiplier, never more than rewards.max. A round where nobody was beaten pays nothing and doesn’t count towards stats.

Without ShottyCore, set rewards.command to your economy’s own command, such as eco give {player} {amount}.

With ShottyCore, set rewards.money-server on the proxy to the server that holds your economy. See Game wins and prize money.

With vote.auto: true (or /event auto on) the server runs itself:

  1. Nothing is on and vote.min-players are online: after vote.idle-seconds a vote opens with vote.options events that suit the player count.
  2. Everyone in the main lobby is taken to the vote platform and walks into a wedge to vote.
  3. The winner is set, and with vote.join-after-vote everyone goes straight into its waiting room.
  4. The game starts once min-players are waiting, after vote.start-countdown.
  5. A round with a winner closes the event after vote.after-win-seconds, and the next vote opens.

Staff can still set, start and stop events by hand at any time.

With the ShottyCore companion installed, ShottyEvents knows each player’s party:

  • A party leader who joins an event brings the party along.
  • With parties: together on an event, a player picked at random brings their party, so a party is never split between the runners and the hunters.
  • party-teams: lines give each party a team of its own (Bingo plays a party as one team).
  • Private lobbies can be limited to the host’s party or friends.
  • /event list shows every event; /setevent <id> then /event start runs one by hand.
  • /games worldtest <game> builds a game’s world, reports what it found and removes it again.
  • /deathswap worldtest does the same for Death Swap.
  • /event who lists who is in the event; /event stats shows that wins are counted.