Skip to content

Darkzone darkzone

Darkzone is a feature meant to act as a manager for a darkzone area in your server.

A 'darkzone' is a feature most modern factions servers have. It involves an area where command usage is limited, e.g. no /home, /warp, etc. PVP is enabled and players kill mobs that drop high value items. To enter, players generally go through an entrance 'portal' placed somewhere at spawn or in the warzone. To exit, players generally go through an exit 'portal' placed somewhere in darkzone which places you in the overworld warzone.

Another less common feature of darkzone is known as the 'gulag'. Sometimes a darkzone area is a sort of skyblock like island where falling off is a real possibility. If a player falls off, they get teleported to a small arena (generally smaller than 32x32) where they must fight to get out.

Config

allowed-commands-in-dz

A list of commands (supporting regex) that are allowed in darkzone.

darkzone-region

The region that darkzone covers. Generally this should cover EVERYWHERE in your darkzone area/world.

spawner-format

Defines the custom spawner item format.

bypass-command-block-permission

The permission that lets players bypass command restrictions. This is provided as some staff members must be able to bypass commands, but shouldn't be able to spawn new spawners in.

entrance-portals exit-portals gulag-portals Sections

A section of portals for entrance. You can add as many as you want i.e.: 

  entrance-portals:
    pt2:
      point-one: -50:75:-50:spawn
      point-two: -55:76:-55:spawn
      exit-locations:
        - 0:75:0:darkzone
    pt1:
      point-one: 50:75:50:spawn
      point-two: 55:76:55:spawn
      exit-locations:
      - 0:75:0:darkzone
The list of locations under exit-locations define the possible locations of exit. These are randomly selected.

item-table Section

A section defining available custom items that mobs can drop. These items follow the simple FactionsKore ItemBuilder format. See here for an example.

entity-table Section

Defines custom 'darkzone' entities which spawn from custom spawners. These custom entities have custom drops and or different health. In the lane of different drops, a recommendation would be to add a custom armor/weapon set dropped rarely from these mobs.

Here's an example: 

    void-zombie:
      max-near-spawner:
        amount: 5
        radius: 16
      entity-type: ZOMBIE
      custom-name: '&0&lVoid Zombie'
      health: 50-60
      damage: 10-20
      kb-resistance: 0.1
      speed: 0.2-0.25
      entity-equipment:
        boots:
          type: LEATHER_BOOTS
          color: "000000"
        leggings:
          type: LEATHER_LEGGINGS
          color: "000000"
        chestplate:
          type: LEATHER_CHESTPLATE
          color: "000000"
        hand:
          type: DIAMOND_SWORD
          enchants:
            DAMAGE_ALL: 6
            DURABILITY: 10
            LOOT_BONUS_MOBS: 5
      drop-table:
        plain-netherstar: 100
        void-bow: 0.1

max-near-spawner

The maximum amount of this type of entity near a spawner.

entity-type

The base type of entity.

custom-name

The custom display name of the entity.

health

A range of potential health values.

damage

A range of potential damage values.

kb-resistance

A range of potential kb resistance value.

speed

A range of potential entity speed values.

equipment

An optional section defining the equipment the entity spawns with.

drop-table

A table defining the drops and chances of them for this entity. In this example, it has a 100% chance to drop a plain netherstar and a 0.1% chance to drop a 'void bow'. Both of these types are defined under the item-table section.

events Section

This section defines the custom events that can occur in the darkzone area.

try-event-every-seconds

How often a new event should try to be started, in seconds.

only-announce-messages-to-world

If the event's messages should be limited to the darkzone world.

TREASURE

This event type changes the chances of drops for certain mobs. Allowing you to buff the chances of rare drops or simply give more of the same item. 

    TREASURE:
      chance-to-activate: 20.0
      length: 180
      deactivate-message: '&7&lDark&8&lZone &0>> &bThe treasure bonus event has ended!
        Extra treasure will no longer drop!'
      activate-message: '&7&lDark&8&lZone &0>> &bA treasure bonus event has begun!
        Void Bugs now have a chance of dropping extra loot!'
      drop-table:
        void-zombie:
          void-bow: 0.1
          void-helmet: 0.1
          void-sword: 0.1

chance-to-activate

The chance for this event to activate.

length

The lifespan of this event, in seconds.

drop-table

The modified drop table of the custom entities.

FIREBALLS

Spawns fireballs over the arena that damage and knockback players. 

    FIREBALLS:
      chance-to-activate: 10.0
      length: 120
      spawn-fireballs:
        region:
          point-one: -150:250:-150:darkzone
          point-two: 150:255:150:darkzone
        fireballs: 5
        every-seconds: 1
      damage: 20.0
      velocity: 2.0
      deactivate-message: '&7&lDark&8&lZone &0>> &bRain of fire has deactivated! Fireballs
        will stop!'
      activate-message: '&7&lDark&8&lZone &0>> &bRain of fire has activated! Fireballs
        will rain from the sky and deal damage to players!'

spawn-fireballs

The region in which the fireballs should spawn.

damage

The damage the fireballs should deal.

velocity

A modifier for how fast the fireballs move.

BOOST_KNOCKBACK

A boost of knockback for all players in the darkzone region.

boost-rate

The modifier for knockback.

BOOST_DAMAGE

A boost of damage for all players in the darkzone region.

boost-rate

The modifier for damage.

BOOST_SPAWNS

A boost of spawn rates for all spawners in the darkzone region.

boost-rate

The modifier for spawn rates.

Command

  • /darkzone getspawner (type) - Gets a custom entity spawner.

Permissions

  • Base Level - Nothing.
  • Admin Level - Admin commands.