Zone

🧊 Zones

Zones define specific areas in the game world with unique properties, effects, and behaviors. They are essential for creating immersive environments and gameplay experiences. Zones are common for radiation areas, toxic zones, or even safe havens.

---

📂 Folder Structure

.minecraft/
├── content-pack/
 └── misc/
  └── zones/
   └── your_zone.json

---

🧾 Example JSON

{
    "fogs": {
        "START": {
            "valueToReach": 0,
            "activationRadius": 12
        },
        "END": {
            "valueToReach": 55,
            "activationRadius": 12
        }
    },
    "fogsColor": {
        "valueToReach": {
            "x": 20,
            "y": 20,
            "z": 0
        },
        "activationRadius": 12
    },

    "sound": {
        "sound": "item.irradiated",
        "path": "",
        "variants": 1,
        "volume": 1,
        "pitch": 1,
        "chance": 0.1,
        "activationRadius": 12
    },

    "spawnFireflies": false,
    "particles": {
        "ashParticles": true,
        "whiteAshParticles": true,
        "activationRadius": 12,
        "passes": [
            {
                "chance": 0.118093334,
                "radius": 8
            },
            {
                "chance": 0.118093334,
                "radius": 16
            }
        ]
    },

    "sourceType": "NEUTRAL",
    "color": {
        "x": 0,
        "y": 255,
        "z": 0
    },

    "damages": 2,
    "ignoreArmorsForDamages": false,
    "noDamages": false,
    "dontDamageIfWearing": { // The player will not take damages if he is wearing both items
        "name": "niwer_engine:gas_mask",
        "and": { "name": "hazmat_vest" }
    }
}

---

⚙️ Available Parameters

• fogs : Map<EnumFogDistance, FogZoneConfig> — Defines the fog settings for the zone.

• fogsColor : FogColorZoneConfig — Set the color of the fog in the zone.

• spawnFireflies : Boolean — Defines whether fireflies should spawn in this zone.

• particles : ParticleZoneConfig — Spawn particle effects in the zone.

• sound : SoundZoneConfig — Play sounds for the zone.

• sourceType : Defines how the block affects nearby players. Can be:

  • NEUTRAL — No effect.
  • COOL — Cools the player.
  • HEAT — Heats the player.

• color : Vector3 — The color tint applied to the zone.

• damages : Integer — The amount of damage dealt to players within the zone per second.

• dontDamageIfWearing : ItemStackConfig — The player will not take damages if he is wearing both items.

• damages : Integer — The amount of damage dealt to players within the zone per second.

• ignoreArmorsForDamages : Boolean — If true, the zone will ignore armor when calculating damage.

• noDamages : Boolean — If true, the zone will not deal any damage to players. (Very useful for safe zones)

---