Ruins - Rumsfield/konquest GitHub Wiki

Updated for 1.0.0

Ruins Setup

This page explains how to set up ruin territories on your server. A ruin is like a town, but it does not have a monument and does not belong to any kingdom. Ruins have the following properties:

  • Composed of claimed land chunks, which appear as gray/white on the map.
  • No player can edit blocks within ruin territory.
  • Contain any number of chests, which spawn random loot for players to take.
  • Contain any number of critical blocks, located anywhere within the ruin territory.
  • Contain any number of spawn blocks, which act as the spawn points for Ruin Golems, located anywhere within the ruin territory.
  • Spawn Ruin Golems for each spawn block when a player enters the ruin.
  • Target all Ruin Golems to players who interact with a critical block.
  • Give a favor and experience reward to all players inside the ruin when the last critical block is destroyed.
  • Reset after a configured time to be captured again.

Ruin Loot

As an admin in bypass mode, you can place any number of single or double chests inside of a Ruin. Every chest within Ruin land will provide random loot to players that open it. The loot is configurable, from the ruins section of the loot.yml config file. The default loot table is shown below.

There are two ways that players can open loot chests inside Ruins.

  1. When core.yml setting core.ruins.loot_after_capture: true, players can only open loot chests after destroying all critical blocks, during the capture cooldown period. Once the capture cooldown time is over, the loot chests reset and cannot be opened until the Ruin is captured again.
  2. When core.yml setting core.ruins.loot_after_capture: false, players can open loot chests before destroying all critical blocks, while they are capturing it. The loot chests will reset only after the Ruin has been captured and the capture cooldown timer finishes.

The probability of an entry being picked is equal to its weight divided by the sum of all entry's weights, times 100. For example, the default table has a total weight of 50, and the Mending enchanted book with weight of 2 has a 100*(2/50) = 4% chance of spawning.

Default Ruin Loot Table

Item Amount Weight
Items
Gold Block 5 5
Blaze Rod 12 4
Diamond Block 3 2
Lead 1 4
Poppy 1 6
Potions
Potion of Swiftness II 1 4
Potion of Healing II 1 6
Potion of Invisibility (Extended) 1 3
Potion of Water Breathing (Extended) 1 3
Enchanted Books
Mending 1 2
Efficiency III 1 4
Luck of the Sea III 1 3
Projectile Protection I 1 4

Once a chest has been opened, the loot will not re-generate until after the ruin has been captured by destroying all of the critical blocks. Then, once the capture cooldown timer has finished and the critical blocks regenerate, the loot chests will spawn more loot.

Ruin Golems

Ruin Golems are Iron Golem entities which have been modified by the Konquest plugin. They have the following characteristics:

  • 4x the max health of a normal Iron Golem.
  • 1.5x the starting health of a normal Iron Golem. This makes the golem appear damaged, while still having more health than a typical Iron Golem.
  • 1.5x faster than a normal Iron Golem.
  • Makes noise when targeting a player.
  • Respawns upon death after some duration (core.ruins.respawn_cooldown).
  • Targets players who interact with critical blocks.
  • Stops targeting players who leave the ruin territory.
  • Consumes other monsters in close proximity.

Configuration

The properties of ruins can be configured in the core.yml config file. See the Configuration page, in core.yml section core.ruins.*.

How to Set Up

Managing ruins is done entirely through the /k admin ruin command. You can create ruins in any world on the server, including The End and Nether. The overall steps to creating a ruin are as follows:

  1. Go to a location where you want the ruin to be placed.
  2. Create the ruin with the command.
  3. Claim land for the ruin.
  4. Build structures within the ruin.
  5. Set critical blocks.
  6. Set spawn blocks (optional).
  7. Place loot chests (optional).

1 Find a Location

  • Go to a location to place the ruin. This can be in any world. Your player location will be the center of the new ruin.

2 Create a Ruin

  • Use command /k admin ruin create (name) to create the new ruin and claim the chunk you're standing in for its territory.
  • To remove a ruin, use command /k admin ruin remove (name).
  • To view a list of all ruins, use command /k admin list ruins.
  • To teleport to ruins, use command /k admin travel (name).

3 Claim Land

  • Claim land for the new ruin as you see fit, using /k admin claim and its sub-commands.
  • Remember than no player can edit blocks within the ruin territory.
  • Also remember that ruin golems will spawn when players enter the territory.

4 Build Structures

  • Enable /k admin bypass as necessary to build within ruin land.
  • Build whatever structures you want within the ruin.
  • Place any number of critical blocks (core.ruins.critical_block) anywhere inside of the ruin land. Players must destroy all of them for a reward.

5 Set Critical Blocks

  • Once all of the critical blocks are placed, use command /k admin ruin criticals (name).
  • Click on every critical block within the ruin.
  • Click in the air when you are finished.
  • If you wish to re-set the critical blocks, use the same command again and click on the blocks you want.

6 Set Spawn Blocks (optional)

  • You may optionally set spawn locations for Ruin Golems within the ruin. Each spawn location you set will spawn a Ruin Golem. The more spawn locations, the more difficult it may be for players to fight through the ruin.
    • 1 - 2 Ruin Golem is a good match for a single attacking player.
    • 3 - 5 Ruin Golems are a good match for a small group of attacking players.
    • 6+ Ruin Golems may present a challenge for a large group of attacking players.
  • Use command /k admin ruin spawns (name) to begin selecting spawn locations.
  • Click on each spawn location you want. The Ruin Golem will spawn on the top of the block. This can be any block.
  • Click in the air when you are finished.
  • If you wish to re-set the spawn blocks, use the same command again and click on the blocks you want.
  • If you want to remove all spawns, use the same command again but then click in the air to cancel.

7 Place Loot Chests (optional)

  • Any chest (single or double) that you place within the Ruin territory will become a Ruin Loot chest. See details above.
  • Simply place chests at the desired locations, or break chests that you want to remove from the Ruin.