Tutorial
Let me explain how this plugin works.
- You setup a lot of arenas.
- You setup a match for every arena to tell the plugin that "Oh! Let's make this arena playable!"
- You setup a hub, so when your players are in it they can checkout cool stuffs like Quake shop or railgun customizer, etc.
- You edit files in the plugin folder and customize things about railgun customization.
- Done!
Great, it's not that hard, isn't it? So I will start with an example that:
- 1 arena called "Desert" and 1 match for that arena
- A hub in the world called "Quake" from (0,0,0) to (100,100,100)
- Also add a trigger (a railgun attachment) that makes the railgun shoots every 0.5 seconds, which players can buy from the hub shop.
So here's how you do it.
1. Type "/quakeadmin arena create 1 Desert".
The "1" here is the arena id, it's just an id, players won't see it; but later we will need it to setup a match. The "Desert" here is the arena name, which will be shown on join signs.
2. The plugin will tell you what to do next, Basically you need to set spawns by going to the location and type "/quakeadmin arena spawn 1".
The "1" here is the arena id, refers to step 1.
3. After you setup enough spawns, we need to initialize a match to make this arena.. works! Type "/quakeadmin match create 1-1 1".
The "1-1" here is the match id. This id will be shown to players on join signs. You can give it other names, like "Supermanb777" or what else but we use "1-1" here to make it more "professional", ha ha. The "1" here is the arena id, refers to step 1 and 2.
4. Now we can actually try it out by typing "/quake join 1-1". Test it with your friends! :)
The "1-1" here is the match id, refers to step 3.
5. Now, setup a hub. Just type "/quakeadmin hub" and you will enter the hub setup wizard, it will tell you what to do next.
6. When you enter the hub, the inventory will be switched to Quake's inventory, and the Quake statistics scoreboard will be shown up. You should see 3 items in your inventory: Shop, Customizer and Record (A book). So if you don't know what Shop and Customizer do for, play on Hypixel's Quakecraft first.
7. So how can we change items in our shop, and make it shows on the customizer GUI? We need to edit some .yml files in our plugin folder.
The items.yml define items. There's 4 items in default, and each of them belongs to different types of attachments.
Case: The material of the railgun.
Default case with id 1, which has material option set to 290 (Wooden hoe). You can also set an enchant on it by setting "case_has_enchantment" to true.
Sight: The firework color when a player get killed by the railgun.
Default sight with id 2 has a YELLOW laser_color, which means it's yellow (what?). There are 17 firework colors available in minecraft: WHITE, SILVER, GRAY, BLACK, RED, MAROON, YELLOW, OLIVE, LIME, GREEN, AQUA, TEAL, BLUE, NAVY, FUCHSIA, PURPLE, ORANGE. Why there's a 351@11 in material option? Isn't that an invalid id? Nope, the 11 is the data of the material 351 (Ink), which makes the ink yellow. Of course, you can apply this theorem to other type's material option. The material will be only shown in the shop and the customizer.
Barrel: The firework shape when a player get killed by the railgun.
You can edit the barrel_shape to other shapes. There are 5 shapes available in Minecraft: BALL, BALL_LARGE, STAR, BURST, CREEPER. The material will be only shown in the shop and the customizer. '
Trigger: How fast the cooldown time of the railgun.
The material here should be fixed to 77 (Stone button) since it looks like a trigger, but if you have better ideas you can switch it. The trigger_amount option will be shown in the shop and the customizer, so players distinguish different triggers if you set all trigger's material to stone button as Hypixel does. So what should we fill for? My recommendation is to fill in 15 if the trigger speed is 1.5 seconds, fillin 7 if the trigger speed is 0.7 seconds, etc. How to adjust trigger speed? The trigger_speed option does it. You need to multiply 20 by your preferred speed. Fill in 30 if you want the railgun fires every 1.5 seconds (1.5*20).
Wow it looks confusing. Anyway let's add a trigger item with 0.5s speed. Create a new line of the file, copy the default trigger configuration and paste it to the end of this file. Edit the trigger_amount to 5 and trigger_speed to 10. Edit the name and the lore as you like, and set a new cost of the trigger, like 500.
Here's what your items.yml should look like: http://pastebin.com/9Kj9WMKR
You can always add new items. Just copy a template and paste and edit. But remember, the items ID must be sequential and they need to be integers, just like how Minecraft is.
8. We added cool items, but we need to let players can purchase the item from shop. Open "gui.yml", you will see the first "shop_rows" option.
shop_rows: - 1,0,0,0,0,0,0,0,0 - 2,0,0,0,0,0,0,0,0 - 3,0,0,0,0,0,0,0,0 - 4,0,0,0,0,0,0,0,0 - 0,0,0,0,0,0,0,0,0 - 0,0,0,0,0,0,0,0,X
Which shows:
And we edited the 0 after the 4 to 5, our custom trigger's id.
shop_rows: - 1,0,0,0,0,0,0,0,0 - 2,0,0,0,0,0,0,0,0 - 3,0,0,0,0,0,0,0,0 - 4,5,0,0,0,0,0,0,0 - 0,0,0,0,0,0,0,0,0 - 0,0,0,0,0,0,0,0,X
Then: http://prntscr.com/397kn7
We also need to make the custom trigger appears in our customizer interface. Simply edit the "trigger_rows" to:
trigger_rows: - 4,5,0,0,0,0,0,0,0 - 0,0,0,0,0,0,0,0,X
9. Done!
To create a joinsign, simply put following lines when editing a sign.
Line 1: [Quake] Line 2: The id of match
Have any questions? Leave them below and I will answer you ASAP! :D
@Francoflorentino
You need to download the latest version: http://dev.bukkit.org/bukkit-plugins/minequake/files/5-1-3/
For first problem, you need to delete plugins that control respawning.
@TigerHix
I cant shoot with my railgun in the arena ?! Any solution??
@Francoflorentino
It's already compatible. I use the latest version on my server and it works perfectly except the railgun fireworks that I don't see when I shoot. :/
@iSacha
Have you set the config wrongly?
The Join-Signs doesn't work! Please fix this!
Line 1: [Quake] Line 2: The id of match It doesn`t work.
@Littlekocy
Yes it doesn't work!
@TigerHix
hop but it's fixed
Could there be a customizable range per railgun? lets say Wooden goes 20 blocks but is accurate, and diamond travels a max of 40 blocks but is less accurate. something like that
@niftyapple
Would like to have this aswell!
Do players get speed II (or III) if playing in the arena? Will you support BarAPI? (It would look great!) And please let us, admins, customize the language used in the arena!
Hey, i have a problem with the config.
I was trying to add 2 custom items to each category, but i have a problem with placing them in the gui.yml. I am confused on how to get that many items in sequential order like that please help me!!
Hi, is this any way for give some points / coins when a player kills another player during a game ?
Can I have an example edited items.yml?
The shop GUI in my server is different than what the shop GUI displays on this dev page. Mine is showing Pets and Armor, and the pets dont even work. I try to add a new case to the file and I am doing it exactly as i should be but it still isn't adding to the GUI.
@Midday_Fury
This means MineQuake on your server is interfering with another plugin that involves a GUI. Do you have another plugin that involves getting pets or whatnot? The code for that is definitely interfering with MineQuake. You'll have to delete one of the plugins.
I noticed that on my server, the guns don't shoot very far. Is there any way to get it like in Hypixel's server, where you can literally shoot from the other side of the arena? Right now, I find it very annoying that it's almost no different than hitting them with a sword. Is this a plugin problem or is it something that I can change in the config?
ok everything works but when i add stuff to the items.yml and gui.yml it doesn't add it to the in-game shop/customizer and i did everything you said i checked it about 3 times (deeply) and i even create a whole new document and pasted http://pastebin.com/9Kj9WMKR and just added stuff from there and on the website you said you have to do it like in a sequence not like - 1,7,8,9,10,11,12,0,0 and it didn't work and i changed the id of the items i added to the items.yml also what do i do like - 1,2.1,3.1,4.1,0,0,0,0,0 because if i make it like 1,2,3,4 on the first row for the cases it will conflict with the other ones starting with those numbers