Gates Configuration

config.yml — Spawning (spawning)

Wild spawns (spawning.wild)

Weights ship with all ranks including S / SS / NATIONAL / MONARCH (rare). Omitting a key or setting weight 0 excludes that tier.

Restrictions (spawning.restrictions)

• block-near-server-spawn + server-spawn-radius
• block-near-world-spawn + world-spawn-radius
• require-surface-and-sky — land surface only for wild spawns
• apply-to-manual — apply restrictions to /gates admin spawn

Integrations

• spawning.towny — block in towns
• spawning.worldguard — block in regions
• spawning.land-claims — block in player land claims
• spawning.allowed-worlds / blocked-worlds

Player land claims (spawning.land-claims)

Keeps wild gates out of bases players have claimed. Without this a gate can paste its structure straight into someone's build, so it is on by default.

Supported providers ids: griefprevention, lands, griefdefender, residence, redprotect.

Every provider is a soft dependency bound by reflection, so leaving them all true is safe — a provider whose plugin is not installed does nothing. If a claim plugin is installed but its API cannot be bound, Gates logs a warning at startup rather than failing silently, because a hook that quietly does nothing means gates spawn inside player bases.

Towny is handled separately by spawning.towny (towns, not claims).

PlotSquared needs no hook: plot worlds are kept gate-free by leaving them out of spawning.allowed-worlds.

WorldGuard region flag

spawning.worldguard registers an optional custom region flag (default name ascension-gate-spawn, default value allow). To forbid all gate spawns inside a region — wild, admin zone/point, and manual — a region admin runs:

/rg flag <region> ascension-gate-spawn deny

Animation (animation)

gates.yml

Large file — tier timings, bosses, loot tables, instance generation, mob density, mana crystals, dungeon break, modifiers.

Key sections:

• tiers.<RANK> — charge/open/collapse seconds, entry fee
• dungeon-families — themed dungeons (mob pools, bosses, block palettes per theme)
• instances — dungeon layout, mobs, crystals, procedural generation
• bosses — per-tier fallback boss stats (themed bosses use family boss-archetype)
• loot — drop tables, custom items, armor sets / armor-models, weapon-effect dungeon weapons, treasure chests
• dungeon-break — overworld spillover settings

Themed dungeon families (dungeon-families)

When a player enters a gate, one family matching the gate tier is chosen at random. The family drives:

19 bundled families include Goblin Camp, Ant Tunnel/Nest/Colony/Kingdom, Stone Caverns, Ancient Mine, Beast Den, Drake Nest, Infernal Fortress, Necromancer's Crypt, Crystal Forest, Storm Citadel, Demon Fortress, Dragon Nest, Necropolis, Void Gate, Dragonkin Fortress, and Monarch gates.

Requires instances.mobs.spawn-wild-archetypes: true and AscensionShadows for ModelEngine wild mobs.

Full reference: Dungeon families — complete family table, loot weapons, force-theme command.

Procedural generation (instances.procedural)

style: v3 (default) is the themed generator: a long snaking main path (entry → combat rooms → guard anteroom → boss at the far end), plus branch wings, dead-end side rooms, and treasure vaults with boosted mana crystals / gemstone ores. Room shape and decorations follow the dungeon family's theme.

Higher ranks are much bigger: an E gate runs ~10 rooms in a 190-block area; a MONARCH gate runs ~35+ rooms in a 350-block area with a boss ~17 rooms deep. instances.instance-spacing (default 400) must exceed the largest footprint. clear-band-below/above limit the Y range wiped when an instance closes.

Instance mobs (instances.mobs)

Room-type spawning (instances.mobs.room-type)

v3 themed dungeons already place more spawn points in GUARD rooms (8) than COMBAT (4) / SIDE (3) / TREASURE (1). These per-type settings scale the mob count on top of that per point, and can restrict a room's mob ranks.

elite: true passes only the gate tier as the allowed mob rank (no lower-rank fill). v1 room dungeons tag rooms by type too; v2 caves treat every point as COMBAT.

Locked boss door (instances.boss-door)

When a v3 layout has a GUARD anteroom, the corridor into the boss arena is sealed with a block wall until every guard mob is cleared — a mid-run gate on the boss fight. Players are never soft-locked: the door also opens immediately if no guard mobs spawn (Shadows off / wild spawning disabled) and always opens after the failsafe timer. The seal is protected like every other dungeon block.

Boss guidance (instances.boss-guidance)

Helps hunters find the boss chamber: a floating Boss Chamber label above the seal (or boss spawn), ambient portal particles, and a periodic action-bar bearing (ahead / left / …). Disable any piece with the toggles below. The action-bar bearing yields to the Hunter Compass when that item is held.

Dungeon timers

Hunter Compass (loot.items.hunter_compass)

Sold in /ascshop (economy.shops.hunter-compass, $2,500). Hold it in a gate — the vanilla compass needle tracks the nearest wild mob or boss in that instance. Outside dungeons it does nothing.

Dungeon modifiers (dungeon-modifiers)

Each instance rolls one weighted modifier when it generates. loot-multiplier grants bonus loot rolls (mobs and boss); the mob/boss multipliers scale combat.

Bundled: Standard, Double Loot, Cursed (richer loot, deadlier foes), Swarm (60% more mobs), Elite (fewer, far stronger mobs — rich loot). The active modifier shows in the entry chat line and dungeon HUD.

Boss party scaling (bosses.scaling)

Boss stats scale with the group entering: each party member beyond the first adds health-per-extra-player (default +35% HP) and damage-per-extra-player (default +10% damage). Solo hunters keep the base fight.

Boss phases (bosses.phases)

One add-wave and one enrage fire once as the boss's HP crosses a threshold — for both themed and vanilla-fallback bosses.

Each phase triggers only once (a heal back above the threshold won't re-fire it). Toggle globally with bosses.phases.enabled or per phase with minions.enabled / enrage.enabled.

Combat & boss VFX (vfx)

Data-driven particle effects for dungeon mobs and bosses, played through the shared VFX engine. The master on/off (vfx.enabled) and global density (vfx.density) live in AscensionCore config.yml; the keys below (in gates.yml) control the gate-specific combat effects and hold the effect catalog itself.

vfx.weapon.* / vfx.tool.* / vfx.mob.* / vfx.boss.* are the effect catalog — one entry per effect with particle layers (particle, count, offset, shape, dust-color, …) and an optional sound. Editing counts/colors there re-themes an effect without touching code. Element colors come from the shared palette (frost, void, storm, demon, crystal, undead, soul, dragon, earth, rift, arcane, nature), so the same element looks identical whether a shadow, a weapon, or a mob produced it.

Speed-clear bonus (rewards.speed-clear)

The boss-clear deadline normally only punishes slow runs; this rewards fast ones with bonus clear XP. Thresholds are fractions of that deadline (instances.*clear-deadline); when the deadline system is off there is no bonus.

Negative config values are clamped to zero — a bad value never penalises the clear.

Armor sets & 3D worn pieces (loot.armor-sets / loot.armor-models)

Full-set potion bonuses live under loot.armor-sets. Dragon Monarch helmet + chestplate use real cube item models shown via ItemDisplays while worn (loot.armor-models → pieces, scale: 1.0). The helmet display is hidden from the wearer (FPV-safe). Rebuild with python tools/build_dragon_monarch_3d_armor.py. See Armor Sets.

Dungeon loot weapons (loot.items)

Items with weapon-effect apply server-side on-hit effects (ice slow, bleed, cleave, etc.). AoE splash and bleed ticks are secondary damage and do not re-trigger the weapon effect. Custom models use custom-model-data in the merged Ascension resource pack.

Charged use-ability items. An item with a uses value becomes a right-click ability item with a durability bar showing remaining charges; it breaks when the last charge is spent. Configure with:

The Shadow Ring (shadow_ring) uses this: right-click to trigger Shadow Veil — the wielder turns invisible to both players and mobs for 30 seconds (mobs cannot target them for the duration), with 3 uses before the ring is consumed.

Dungeon loot chests (loot.chests)

Rare treasure chests (Dungeon Caches) that spawn inside every dungeon. Each chest rolls a handful of common loot (vanilla materials + custom materials) and has a small, tier-scaled chance to also contain a single legendary weapon or tool. Chests are placed on valid floor tiles (preferring TREASURE rooms) and are wiped automatically when the instance closes — they cannot be broken by players. Every non-exam dungeon always gets at least one filled cache (min-per-dungeon is clamped to ≥1; empty inventories are refilled with staple loot as a safety net).

Legendaries are gated by rank: low-rank gates (E–B) roll no special gear, gear can appear at A but is extremely rare (~1.5% per chest), and the strongest blades/pickaxes only appear in S/SS and above. Because there are only 1–2 chests per run and the roll is a low percentage, legendary finds stay rare. Everything is data-driven — set enabled: false to turn chests off entirely, adjust min/max-per-dungeon, edit the common[] pool, or tune legendary-chance and the per-tier legendary[] pool to add/remove items and change drop rarity. Changes reload with /asc reload.

Mining & sell prices (instances.* / loot.items)

monarch_artifact (Monarch's Artifact) drops only from MONARCH-rank bosses/mobs. Right-click Monarch's Dominion (90s cooldown): pull foes in, slam them outward, then Strength/Speed/Resistance/Absorption. Monarch-Rank only to activate; anyone may sell it ($50,000). S guaranteed boss loot: mana_crystal_core + dragon_scale.

Red gates (red-gates)

A high-risk / high-reward variant rolled per gate at spawn. A red gate seals the entry — the entry-room exit portal is never placed, so the only way out is to defeat the boss (or die, which respawns you outside). Rewards are boosted and a broadcast announces the spawn.

Crash safety: hunters who log in inside a dungeon world that no longer has a live instance are returned to spawn automatically.

World events (world-events)

Config-driven scheduled boss gates. When an event fires, a boss gate of the configured tier spawns either near players (wild) or in a spawn zone, and the first guild to clear earns a broadcast and bonus guild XP.

world-events:
  enabled: false
  events:
    s-rank-surge:
      schedule: "SAT 20:00"          # "DAY HH:mm" (server timezone) or "every 6h" / "every 90m"
      tier: S
      announce-minutes-before: [30, 5]
      reward-multiplier: 2.0         # stacks on the clear reward path
      guild-xp-bonus: 500            # first guild to clear
      location: wild                 # or zone:<zone-id>

Next-fire times persist to world-event-state.yml, so a restart between an announcement and the spawn never double-spawns. Fires missed while the server was offline are rescheduled to the next occurrence rather than firing late.