Creating Arenas - SugarCaney/CrystalQuest GitHub Wiki
← Configuration and Classes | Table of Contents | Commands and Permissions →
The CrystalQuest-game is played in an arena and can be played in multiple arenas at the same time. This page will teach you how to set up the arena properly. Please mind that you do not forget to protect the arena with the CQ-protection. Some game-mechanics need this protection.
- Step 1: Making the lobby and the arena
- Step 2: Creating your arena
- Step 3: Team Setup
- Step 4: Player limits
- Step 5: Spawns
- Step 6: Lobby Signs
- Step 7: Protection and Double Jump
The lobby is the place where all games start. Here do people come together to join the arena they'd like. Make sure there is enough room for either the players and the signs to join the arenas. After you have done that, you simple set the lobbyspawn using the /cq setlobby-command. This is the place all players get teleported to if they use the lobby command or if they left the game.
You also should make an arena to your likings. Make sure the arena already has special spawnpoints for the crystals if you want them to have some decoration around it (for example a block surrounded with stairs, like a pedestal for the crystal). Also places for the teams to spawn pre-game (teamlobbies) are handy to have made on forehand.
To register a new arena, you have to use the /cq createarena [name]-command. After executing, it created a new arena and showed you the ID of the arena with optionally a given name. If you did not give it a name in the first place, you have to use the /cq setname <ID> <name> command afterward. To let players be able to join the arena, you have to give them the crystalquest.arena.<name> permission where the name is case sensitive. After you have set the arena, you can use the arena name in the commands instead of the ID. You can use /cq check <arena> at any time to see the status of your arena-setup.
It is not possible to initially specify the arena name in v1.3.x and earlier. Use /cq createarena followed by /cq setname <arena> <name> instead.
Use the /cq setteams <arena> [teams..] command to specify which teams (and thus also the amount of teams) compete in the arena. Here is arena the name or the numerical ID of the arena, and is teams a space separated list of all available team colours. You can specify at most 8 teams. Also make sure that you do not enter duplicate team names.
The available colours are: black, blue, brown, darkblue, darkgreen, green, orange, pink, purple, red, white, and yellow.
An example usage is /cq setteams Debug blue green red to specify that there will be a blue, a red, and a green team in arena Debug.
To set the amount of teams the game is played in, you use /cq setteams <arena> <teamamount> where arena is the arena-name/id and the team amount is the amount of teams the game is played in. 4 means that you're playing with 4 teams. There is a maximum of 8 teams (Green (1), Orange (2), Yellow (3), Red (4), Blue (5), Magenta (6), White (7), Black (8)).
To set up the place the teams gather before the game starts you use the /cq teamlobby <arena> <team> command where the arena is the arena-name or the arena-ID and the team is the team colour (or id in v1.3 and earlier). You have to set all lobbies of all teams to let the arena work (4 teams means 4 lobbies). Just hop from lobby to lobby and use the command. If you want to have all teamlobby-spawns at the same place, just spam the command at the same place for all teams.
After you have done that, you have to hang up some signs letting the players choose their class. Just make a sign and write down [cq] at the first line and the rest will happen automaticly. The sign can be made out of any kind of wood.
If you want to let every team have their own spawnpoint(s), you have to use /cq teamspawn <arena> <team> [clear] where team is the team colour (or team id in v1.3 and earlier) as mentioned before. If you add the keyword 'clear', the plugin will remove all spawns for that perticular team. Please keep in mind that if you want to choose for this set up, you do not have to set the player spawns. If you want to re-activate the playerspawns, you have to clear all teamspawns. Note that this step is optional.
Now it's time to set the minimum amount of players. When an arena hits the minimum amount of players, the countdown will start. To achieve this, use: /cq minplayers <arena> <minplayers>.
After you have done that, you have to set the maximum players. More players than the max can't join the arena anymore. Use: /cq maxplayers <arena> <maxplayers>.
To set the player spawns (the locations Players can spawn upon when the game starts or after they died) use /cq spawn <arena>. The plugin will automaticly add the spawn to the list of spawns. You can clear all spawns using /cq spawn <arena> clear. Please note that when you chose for setting up teamspawns, you don't have to use this step. You can do it as a backup if you'd like. v1.4 and later: if you want to remove the most recently added spawn, use /cq spawn <arena> undo.
If you'd rather want team-specific spawns, you use /cq teamspawn <arena> <team> [clear] to set the spawns. Once you have set up 1 team-spawn all normal spawns will be overwritten and people can only spawn on their team-spawns. To disable team-specific spawns, clear all the teamspawns using the 'clear'-keyword (see also Step 3).
To set the crystal spawns (the locations the Crystals can spawn upon during the game) use /cq crystalspawn <arena>. The plugin will automaticly add the crystal-spawn to the list of crystal-spawns. The Crystals will spawn a little lower than you set the location to so the bedrock part can be underground and not visible. You can clear all crystal-spawns using /cq crystalspawn <arena> clear. v1.4 and later: if you want to remove the most recently added crystal spawn, use /cq crystalspawn <arena> undo.
If you want a crystal to be team-specific (you can't break your own crystals), just place a block of wool underneath it corresponding to the team's colour. That's all.
To set the item-spawns (the locations Power-ups can spawn upon during the game) use /cq itemspawn <arena>. The plugin will automaticly add the item-spawn to the list of item-spawns. You can clear all item-spawns using /cq itemspawn <arena> clear. v1.4 and later: if you want to remove the most recently added itemspawn, use /cq itemspawn <arena> undo. Tip: make sure to have plenty of item spots, because items make the game fun. 15 spawns for a smaller sized arena is decent.
Note: [cq] can also be replaced by [CrystalQuest]. Also note that with signs other than join-signs the keyword is required on the 3rd line!
Now the arena is finished, but you still need to have a way to let your players join the arena.
Go to your lobby and place signs containing [cq] at line 1 and the name of the arena at line 2.
If you want more signs, you have to repeat the process until you have all Signs you want. If you used WorldEdit or QuickSign (or other plugins to ease the way of sign-management) you have to register the sign by right-clicking on it. Doing this will cause the plugin to update the sign when the game starts etc. (make it a dynamic sign).
If you want to make a sign which lets a player choose a random arena, just put [cq] at line 1 and Random at line 3.
To place a shop-sign, put [cq] at line 1 and Shop at line 3.
If you want to make a sign connecting to the CQ-lobby or to leave an arena. Make a sign with [cq] at the first line and lobby at line 3.
To make a sign to open the spectate-menu, you have to put down a sign with [cq] on the first line and spectate at line 3.
Protecting your arena will prevent it from being griefed by others, to make it so that all entities will behave as normal (and will be removed at the end of the game) and to make sure spectators can't fly away. You use the /cq protect <arena> [remove] command when you have set position 1 and 2. You can use the /cq wand to set the positions or you can just use /cq pos <1|2> to set the position to your current location. If you want to remove the protection, you should include the 'remove'-keyword in the protect command. Whenever a player gets outside of the protected area they will automatically be killed.
It is advisable to protect a region that is slightly bigger than the arena itself. For example, the anvil item spawns anvils in a radius around the player. If the anvils lands outside of the protected region, they won't despawn.
Initially, double jumps are disabled for the created arena. If you want to enable double-jumps, you use /cq doublejump <arena>. If double jumps were off, they should be turned on and vice versa.