Editor Tooling

Scenes and prefabs are reproducible from Editor/ builder scripts. Prefer extending a builder over hand-editing scene YAML β€” the builders are load-bearing for reproducibility.

Why builders matter

A CLI session can't create scenes or assign Inspector references, and hand-editing .unity/.prefab YAML is fragile. The Editor/ builder suite reconstructs scenes and prefabs from menu items, so the durable move is to extend a builder and then tell the owner the exact menu path to run.

Builder / setup menu reference

Menu stepDoes
BCE β–Ά Setup β–Ά 4nNetworkSyncFixer β€” adds NetworkTransform to hero + base-enemy prefabs
BCE β–Ά Setup β–Ά 4oOgreNetworkSetupBuilder β€” networks the O'gar Brute (Identity + NT + NetworkAnimator)
BCE β–Ά Setup β–Ά 6zMultiZoneSetupBuilder β€” creates _Container.unity, registers zones, adds ZoneManager
BCE β–Ά Setup β–Ά 12 β–Ά Wire Spell and Enemy AudioAudioWiringUtility β€” batch-assigns spell SFX (castSFX/hitSFX) to class prefab spellbooks via AbilityCaster, and enemy voice clips to enemy prefabs via EnemySfxProfile
BCE β–Ά Setup β–Ά 12 β–Ά Dynamic Ore Spawns β€” BuildDynamicOreSpawnerBuilder β€” builds the DynamicMineralVein network prefab and places OreSpawnVolume bounds in each non-Hub zone scene; VoidDungeon is skipped (no playable ground)
BCE β–Ά Setup β–Ά Rebuild Forge Crafting UIForgeCraftingUIBuilder β€” builds ForgeWindow.prefab and ForgeRecipeRow.prefab in Assets/Game/UI/Resources/Forge/; runs automatically on editor load when either prefab is missing or the layout is stale
BCE β–Ά Hub Setup β–Ά 8 - Add Forge, Trainer and MiningHubSceneBuilder.AddForgeAndMining β€” places prefab_forge in the Hub with a ForgeNPC component, reserves the unused male Hub NPC as "Crafting Trainer", and adds 3 Copper Ore gathering stations
BCE β–Ά Hub Setup β–Ά 9Place HangmanNPC (arena entrance)
RoD β–Ά Build Hub SceneHubSceneBuilder β€” populates Hub with environment, portals, spawn ring
BCE β–Ά Build β–Ά Spell Loadout ShrineSpellLoadoutShrineBuilder β€” places a SpellLoadoutShrine in the active scene (sphere trigger, pedestal geometry, purple point light); the shrine is an INPCInteractable that opens the spell loadout panel when a player presses E nearby
BCE β–Ά Quest ForgeQuestForgeWindow β€” author QuestDefinition assets + place quest objects (see Quests & Quest Forge)
BCE β–Ά Loot ForgeLootForgeWindow β€” create LootItemDefinition assets and assign them to drop tables (see Loot, Inventory & Crafting)
BCE β–Ά Node ForgeNodeForgeWindow β€” create GatheringNodeDefinition assets and place functional gathering nodes in scenes (see Node Forge below)
BCE β–Ά Spell Forge β–Ά SpellbookClassAbilityCasterEditorWindow β€” edit per-class AbilityCaster spellbooks with VFX browser and inline preview
BCE β–Ά Spell Forge β–Ά Projectile BuilderProjectileForgeWindow β€” wraps a travelling VFX prefab in a networked PlayerProjectile; auto-registers the result with the Mirror network manager in LoginScene
BCE β–Ά Heroes β–Ά Build Arcanist Projectile TestArcanistProjectileTestBuilder β€” creates Player_FireballProjectile prefab, wires a Fireball ability into the Arcanist spellbook and prefab, registers with the network manager
BCE β–Ά Validate β–Ά Combat BalanceCombatBalanceValidator β€” validates the versioned ability scaling JSON against each class prefab's AbilityCaster spellbook; logs a PASS/FAIL summary with per-rule error details
BCE β–Ά Enemy ForgeEnemyForgeWindow β€” data-driven enemy authoring (definitions, animation, deployment) (see Enemies, Waves & Bosses)
BCE β–Ά Patrol ForgePatrolForgeWindow β€” create patrol routes, click waypoints in Scene view, assign scene enemies; patrol runs server-side and pauses for combat (see Enemies, Waves & Bosses)
BCE β–Ά Setup β–Ά Rebuild Inventory UIInventoryUIBuilder β€” builds InventoryWindow.prefab from approved art assets in Resources/Inventory/; runs automatically on editor load

Content authoring suites

Four larger data-driven authoring windows sit alongside the setup builders:

  • Spell Forge (Editor/ClassAbilityCasterEditorWindow.cs, Editor/SpellVFXPreviewPanel.cs) β€” opened via BCE β–Ά Spell Forge β–Ά Spellbook. Edits the AbilityCaster spellbook on each class prefab (Arcanist, Marauder, Templar, Night Hunter, Cleric). The header shows a class portrait and dropdown; each ability expands into three tabs β€” Logistics (identity, targeting, timing, cost, damage, charge, healing, status effects, crowd control, advanced effects), Animation (cast clip and playback speed), and VFX & Preview (real-time effect playback via SpellVFXPreviewPanel).

The Logistics tab includes:

  • IDENTITY & TARGETING β€” ability name, description (multi-line TextArea, shown in the Spellbook and action-bar tooltip), variant visibility, icon, category, shape, range, cone angle, useFixedRange toggle, rect width, indicator size, and target tag.
  • TIMING & COST β€” instantCast toggle (labeled "Cast On Bind Press (No Click)"), cooldown, and manaCost.
  • ARCANIST COMBUSTION β€” (ArcanistAbilityCaster abilities only) combustionPoints (Combustion awarded when the ability's projectile deals health damage; critical hits double the award) and spendCombustion (when true, clears all Combustion on cast commit and guarantees a Combustion Meteor proc if Combustion was above zero).
  • PROJECTILE DELIVERY β€” launchProjectile toggle; when enabled: Projectile VFX Prefab (must have PlayerProjectile and NetworkIdentity on its root β€” validated with an error when these are missing) and projectileSpeed.
  • DAMAGE & CHARGE β€” damage, damageDelay, secondaryDamage, secondaryDamageDelay, chargeable settings.
  • HEALING & DEFENSE β€” shieldAbsorb, shieldDuration, healAmount, healingDelay, HoT fields (hotTickAmount, hotTicks, hotInterval), usePulseHealing toggle.
  • CROWD CONTROL β€” crowdControlType (None, Pull, or KnockUp). When Pull is selected: exposes pullDestination, pullDuration, pullSpeed, and pullStopDistance. When KnockUp is selected: exposes knockUpHeight and knockUpDuration.
  • ADVANCED EFFECTS β€” shown when any crowd control type is active: chain fields (chainTargets, chainDamageFalloff, chainRadius) and active duration.
  • PULSE DAMAGE β€” always shown for all ability types: usePulseDamage, pulseDamageIsDoT, pulseCount, pulseInterval, pulseRadius, pulseDamage. See Ability Atlas and Synergies for field descriptions.
  • Other groups: STATUS EFFECTS.

The Animation tab exposes a CAST group: castTime, marauderCastAnimation (clip picker filtered to the active class's animation folder), and animationPlaybackSpeed (0.1–3Γ—, default 1).

The VFX & Preview tab includes a VFX Browser sidebar. Pick a prefab and one-click-assign it as: Casting VFX (looping VFX on the caster while aiming), Cast VFX (spawned at release), Hit VFX (spawned at targets), β†’ Projectile (assigns the selected prefab as the networked projectile prefab; validates that the prefab has PlayerProjectile and NetworkIdentity on its root, and opens ProjectileForgeWindow if not), Heal VFX (played on each ally on heal or HoT tick), Shield VFX (persistent VFX attached to the shielded target; managed by ShieldVFXLifetime), or Deployable. Additional VFX toggles: castVFXAtCaster (spawn cast VFX at caster instead of destination) and hitVFXFollowsTarget (attach hit VFX to the target's transform). The chain VFX slot (chainVFX) is also assignable here.

When launchProjectile is true and a projectilePrefab is assigned, the tab shows an embedded PROJECTILE PREFAB editor below the VFX browser: displays the assigned prefab name and asset path; provides Select in Project, Open Prefab, and Create Replacement buttons. Editable prefab-defaults that save directly to the prefab asset without rebuilding: Lifetime, Hit VFX, Hit VFX Lifetime, Collider Radius.

The preview summary line shows all VFX slots: Casting: <name> Cast: <name> Hit: <name> Chain: <name> Heal: <name> Shield: <name> Projectile: <name> Deploy: <name>.

The ability list has a Core / Variants / All filter toolbar: abilities with variantOnly = true are hidden from the player loadout and shown with a VARIANT badge; the Add button labels itself "Add Core Ability" or "Add Variant Ability" based on the active view. Changes must be saved explicitly with the Save button.

  • Enemy Forge (Editor/EnemyForge/) β€” builds networked enemies from a definition (model, animation clips, stats, behaviour). As of the 2026-07-26 update, its animation picker (EnemyForgeAnimationLibrary.BrowseForClip) was relaxed to accept any imported .fbx in the project that contains an AnimationClip β€” the old rule forcing clips to live in a model-family Animation/ folder was dropped, and the redundant folder-picker UI removed. This makes it easy to reuse a clip from anywhere (e.g. a shared locomotion FBX) instead of duplicating it per enemy. Definitions also support per-enemy animation playback speeds (idle, chase, attack 1–4, get-hit, death), applied as Animator float parameters at runtime. A dedicated SFX section lets you assign audio clips for aggro, up to four attack variants, attack impact, get-hit, and death, with volume, pitch variation, and spatial audio distance controls; these are stored on an EnemySfxProfile component added to the built prefab. The cast-attack picker includes Elemental Lightning as an option (see Enemies, Waves & Bosses). Enemies using Elemental Lightning carry an ElementalLightningVFXProfile ScriptableObject that configures four independent VFX layers: Cast Effect (plays at the origin from cast start to impact), Hand Effect (follows the caster's attack origin), Spell Effect (bolt spawned at impact), and Hit Effect (impact flash at the target). Each layer exposes Scale and Thickness controls; the Hand Effect additionally has an Appearance Timing slider (βˆ’3 s to +3 s) that offsets when it becomes visible relative to impact β€” negative values delay it past impact, positive values advance it before. Profile management is via three buttons: New Spell Profile creates a blank ElementalLightningVFXProfile asset, Duplicate Spell Profile creates an independent variant so edits do not cascade to other enemies, and Save Profile writes changes without rebuilding. The animation preview window's Update Configuration button also hot-patches the runtime configuration of any already-built forged prefab via EnemyForgeBuilder.UpdateBuiltPrefabConfiguration.

The Vitals section of the definition now exposes two additional fields:

  • Enemy Display Name (enemyDisplayName) β€” optional name shown in the enemy hover tooltip. When blank, the hover UI formats the prefab or scene object name instead.
  • Enemy Level (enemyLevel) β€” integer level used for kill XP calculation and shown in the enemy hover tooltip. Must be at least 1; the validator rejects values below 1.

Both fields are written to Health.ConfigureEnemyHoverIdentity at build time and imported back from an existing prefab when a definition is populated from scene.

The Rewards section of the definition exposes a rewardCategory field (EnemyController.RewardCategory: Grunt, Brute, Elite, Boss) that sets the XP multiplier tier applied by the account server on kill. Enemy Forge archetype defaults: Ranged and Melee β†’ Grunt; Elite β†’ Elite. Boss must be set manually. The validator rejects an unrecognised category value.

Loot pickup authoring: The worldItemPrefab field in the Enemy Forge window accepts either a ready WorldItem pickup prefab or any ordinary visual prefab (loot bag, chest, sword, item model). When a visual prefab is assigned, EnemyForgeLootPrefabUtility.ResolveNetworkReadyPickup creates and saves a reusable network-ready WorldItem wrapper at Assets/Game/Resources/EnemyForge/Loot/ the first time the enemy is built or updated; subsequent builds reuse the generated asset. The generated pickup has a NetworkIdentity, WorldItem, and a SphereCollider trigger sized to the visual's renderer bounds. Validation rules: assigning a Drop Table without a Loot Visual is an error; the generated pickup must have WorldItem, NetworkIdentity, and a trigger collider, and must be registered with Mirror before building. At deployment (EnemyForgeDeployment), the loot pickup is added to Mirror's network registration list alongside the enemy's projectile, so clients can resolve the spawn message at runtime. RodNetworkManager.OnStartClient also registers all prefabs in Resources/EnemyForge/Loot/ as a fallback.

NPC archetype: Setting archetype to NPC (EnemyForgeArchetype.NPC) produces a non-combat character using ForgedNpcController (Characters/Scripts/ForgedNpcController.cs). No Health, attack animations, XP rewards, or drop table components are added to the built prefab. The root tag is forced to NPC and cannot be changed independently while the NPC archetype is active. Movement is server-authoritative via NavMeshAgent; position and animation are replicated to clients through NetworkTransformUnreliable (server→client) and NetworkAnimator. Configurable definition fields: enemyDisplayName (NPC name), enableRoaming (toggle), roamingRadius (metres from spawn), roamingMinWait and roamingMaxWait (seconds idle between moves). Only Idle and Chase/Movement animations are used; attack clips are ignored. Importing from an existing ForgedNpcController prefab populates these fields automatically.

  • Quest Forge (Editor/QuestForge/) β€” authors quest content. Quest definition assets and scene objects are committed to the repo; deployed server builds synchronize per-player quest state with the database via QuestPersistenceService. The Delete Open Quest action removes the asset, strips all associated scene and prefab components, and records a deletion tombstone in QuestDeletionManifest so the server removes stale database entries on the next deployment. The Configure Object and Configure Area actions guard against attaching quest data to persistent prefab assets β€” selecting a prefab asset (not a scene instance) shows a dialog and exits without changes. See Quests & Quest Forge.
  • Loot Forge (Editor/LootForge/LootForgeWindow.cs) β€” opened via BCE β–Ά Loot Forge. Creates and manages LootItemDefinition assets stored in Assets/Game/Resources/LootForge/Items/. Each definition captures: database item ID, display name, database item type (LootDatabaseItemType), rarity, sell value, crafted flag, stackable flag (default: true), maximum stack size (default: 99, shown only when stackable is enabled), inventory icon sprite, inventory icon rotation (inventoryIconEulerAngles, default 12/βˆ’28/βˆ’8 degrees β€” applied when photographing the prefab for its icon), inventory icon zoom (inventoryIconZoom, β‰₯0.5, default 1; below 1 zooms in, above 1 adds space around the item), and world visual prefab (optional β€” leave empty for inventory-only items such as tickets, materials, or consumables; the enemy's assigned pickup prefab is used as the world representation; when assigned, must be a prefab asset from the Project window).

Equipment slot authoring:

  • When the MainHand slot is selected, a Two Handed Weapon toggle appears.
  • Items with databaseItemType of Weapon may be assigned to either the MainHand or OffHand slot. All other equipment types are validated against their default slot.
  • An attachment profile is required for all equipment slots except Ring and Trinket. The window displays a validation error if no profile is assigned.
  • The Apply Recommended Attachment Profile button auto-assigns a shared default profile from Assets/Game/Resources/LootForge/Attachment Profiles/Defaults/. Default profiles are created on demand by LootForgeAttachmentDefaults using slot-aware socket names: RightHandSocket (one-handed main hand), TwoHandSocket (two-handed), LeftHandSocket (off-hand), HeadSocket, ChestSocket, HandsSocket, LegsSocket, FeetSocket. Clicking the button on an item with a custom (non-default) profile replaces it with the default; the Undo system records the change.

The window also provides a Drop Table Assignment panel: select an existing DropTable, set weight and quantity range, and click Save and Assign to Drop Table to add or update a single entry without disturbing other table entries. Definitions saved here are automatically synced to the live items database when a server build containing them is deployed (via LootPersistenceService).

Validation rules: item ID must be 1–64 lowercase letters/numbers/underscores/hyphens; display name is required (max 128 chars); inventory icon is required; world visual prefab is optional (when assigned, must be a prefab asset); maximum stack size must be at least 1 when stackable is enabled; IDs must be unique across all definitions; equipment (except Ring and Trinket) must have an attachment profile. See Loot, Inventory & Crafting.

Equipment Preview (Editor/LootForge/LootForgeEquipmentPreviewWindow.cs) β€” embedded in Loot Forge for visualising how a weapon or armor item looks on a character. Supported preview characters: Marauder, Templar, Night Hunter, Cleric, Arcanist, Necromancer (prefab: Assets/Game/Game_Prefabs/Necromancer.prefab). Skinned armor prefabs (containing a SkinnedMeshRenderer) are automatically detected; the preview remaps their bones to the selected character's skeleton for accurate in-editor preview.

  • Node Forge (Editor/NodeForge/NodeForgeWindow.cs) β€” opened via BCE β–Ά Node Forge. Creates and manages GatheringNodeDefinition assets (ScriptableObject) stored in Assets/Game/Resources/NodeForge/Definitions/. Each definition is a reusable template for one type of gathering node β€” profession, yield, depletion, and visual β€” that can be stamped into scenes as functional GatheringNodeInstance objects carrying AfkGatheringStation, GatheringNodeNetworkState (Mirror NetworkBehaviour), NetworkIdentity, and BoxCollider.

Definition fields:

GroupFieldNotes
IdentitynodeId1–64 lowercase letters, numbers, underscores, or hyphens. Auto-lowercased on save.
IdentitydisplayNameHuman-readable name shown in prompts. Required.
IdentitycategoryGatheringNodeCategory: Mining, Fishing, Woodcutting, Herbalism, Salvaging, Other.
ProfessionprofessionId0 = Woodcutting, 1 = Fishing, 2 = Mining. Currently validated at 0–2.
ProfessionminimumLevelMinimum player profession level to interact (β‰₯ 1).
YieldlootTableOptional GatheringLootTable. When assigned, the dedicated server rolls rewards from this weighted table rather than the bare itemId/itemQuantity. See Loot, Inventory & Crafting.
YieldyieldItemLoot Forge item reference; its itemId is written to itemId on save.
YielditemIdDatabase item ID. Use when the item has no Loot Forge definition.
YielditemQuantityItems awarded per yield tick (β‰₯ 1).
YieldsecondsPerYieldTick interval in seconds (β‰₯ 0.1).
YieldexperiencePerYieldXP per yield tick.
YieldbonusYieldLevelLevel at which a 20% double-yield chance applies.
Depletion & RespawnminimumAwardsPerSpawnMinimum yields before the node depletes (β‰₯ 1).
Depletion & RespawnmaximumAwardsPerSpawnMaximum yields before depletion (β‰₯ minimumAwardsPerSpawn).
Depletion & RespawnrespawnSecondsSeconds until a depleted node respawns. Default and recommended live value: 900 (15 minutes).
InteractioninteractionRangeRadius in units at which the player can interact (β‰₯ 0.5).
InteractioncancelRadiusRadius at which gathering auto-cancels. Must be β‰₯ interactionRange.
InteractionpromptHeightWorld-space height of the floating interaction prompt above the node root. Default: 2.4.
InteractioninteractionVerbOptional verb shown in the prompt (e.g. "harvesting"). Leave empty for profession defaults.
InteractiongatheringAnimationBoolAnimator bool parameter name for the gathering animation.
VisualvisualPrefabPrefab instantiated as a child of the node root. When null, a placeholder shape is used.
VisualvisualLocalPosition, visualLocalEulerAngles, visualLocalScaleTransform of the visual child.
VisualyieldVFXPrefabParticle prefab played at the node on each yield tick.
CollidercolliderCenter, colliderSizeBoxCollider settings applied to the interaction trigger.
PlaceholderfallbackShapeShape when no visual prefab is assigned: Rock β†’ Cube, Tree β†’ Cylinder, FishingSpot β†’ Quad.
PlaceholderfallbackColorMaterial color of the placeholder.

Scene placement: Four modes β€” Place at Scene View Target, Place in Front of View, Place at Selected Position, and Click Location in Scene (click a surface in the Scene view; Esc cancels). The Snap Down to Ground toggle casts a downward ray from 1,000 units above the target; the Surface Offset field adjusts the final height.

Placed node maintenance: The window reports how many instances of the open definition exist in open scenes. Update Selected Node From Open Definition refreshes one selected node; Update Every Placed Instance of This Definition refreshes all matching nodes. Upgrade Every Gathering Node in Open Scenes scans for AfkGatheringStation objects missing a GatheringNodeNetworkState or NetworkIdentity and adds them (also runs automatically on editor load and on play-mode exit).

Validation (blockers β€” must be resolved before placement):

  • nodeId must match ^[a-z0-9_-]{1,64}$.
  • displayName is required.
  • A Loot Forge Item or an existing database Item ID must be assigned.
  • professionId must be 0, 1, or 2.
  • cancelRadius β‰₯ interactionRange.
  • minimumAwardsPerSpawn β‰₯ 1 and maximumAwardsPerSpawn β‰₯ minimumAwardsPerSpawn.
  • respawnSeconds β‰₯ 1.

Shipped definitions (in Assets/Game/Resources/NodeForge/Definitions/): bronze_vein, copper_vein, gold_vein, hell_vein, iron_vein, moon_vein, oak_tree, river_fishing_spot, silver_vein, steel_vein, tin_vein.

  • Patrol Forge (Editor/PatrolForgeWindow.cs) β€” creates EnemyPatrolRoute objects in the active scene, lets you click walkable ground to place waypoints, and assigns those routes to one or more scene enemies or models. A "stagger starting waypoints" option distributes multiple mobs evenly across the route. Group formation mode (groupFormationPatrol on the route + preserveFormation and formationOffset on each agent) keeps the authored spacing between members continuously while in motion β€” members adjust their NavMesh speed between 0.78Γ— and 1.35Γ— base to stay in formation rather than stopping at waypoints to wait for the group. On combat exit, GetSharedResumeWaypoint() picks the waypoint nearest the group's average position. See Enemies, Waves & Bosses.

Build pipeline hooks

These scripts run automatically during the Unity build process and require no menu interaction.

ScriptTypeActive whenEffect
DedicatedServerSceneFilter (Editor/DedicatedServerSceneFilter.cs)IProcessSceneWithReport (callbackOrder βˆ’1000)Player build targeting StandaloneBuildSubtarget.ServerRemoves all GameObjects named QuestMarker and all GatheringNodeInstance and AfkGatheringStation components from each processed scene before the server binary is written. GatheringNodeNetworkState and NetworkIdentity remain on gathering nodes and continue to own shared depletion state.
πŸ“ Forge enemies and the player class named Templar

Enemy Forge output (Templar, Wizard, Chaos Weaver, Devastator, Pummeler, Instigator, …) are enemies authored as data β€” unrelated to the five player classes. Note that player class index 1 is also named Templar as of 2026-07-31. The Forge-built Templar zone enemy and the player-class Templar are distinct entities.

⚠️ GUID churn trap

Moving assets from outside Unity regenerates .meta GUIDs and dangles every reference (\"Missing Prefab\" / \"corrupt variant\" / scene-open errors). One commit regenerated 124 metas at once. Fix: restore the historical GUID (tools/guid_restore.py). Prevention: move assets from inside the Unity Project window, or move the .meta alongside the file.

πŸ›‘ LFS + prefab merge trap

*.prefab tracked by LFS can bake merge-conflict markers into the binary pointer, producing null prefabs / \"classPrefabs doesn't exist\" after a merge. Recover from the local LFS cache; the durable fix is untracking *.prefab from LFS. .gitattributes is now case-insensitive.


Related: Build & Deploy Β· Zones, Scenes & Multi-Zone Β· Quests & Quest Forge Β· Enemies, Waves & Bosses