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 step | Does |
|---|---|
| BCE βΆ Setup βΆ 4n | NetworkSyncFixer β adds NetworkTransform to hero + base-enemy prefabs |
| BCE βΆ Setup βΆ 4o | OgreNetworkSetupBuilder β networks the O'gar Brute (Identity + NT + NetworkAnimator) |
| BCE βΆ Setup βΆ 6z | MultiZoneSetupBuilder β creates _Container.unity, registers zones, adds ZoneManager |
| BCE βΆ Setup βΆ 12 βΆ Wire Spell and Enemy Audio | AudioWiringUtility β 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 β Build | DynamicOreSpawnerBuilder β 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 UI | ForgeCraftingUIBuilder β 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 Mining | HubSceneBuilder.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 βΆ 9 | Place HangmanNPC (arena entrance) |
| RoD βΆ Build Hub Scene | HubSceneBuilder β populates Hub with environment, portals, spawn ring |
| BCE βΆ Build βΆ Spell Loadout Shrine | SpellLoadoutShrineBuilder β 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 Forge | QuestForgeWindow β author QuestDefinition assets + place quest objects (see Quests & Quest Forge) |
| BCE βΆ Loot Forge | LootForgeWindow β create LootItemDefinition assets and assign them to drop tables (see Loot, Inventory & Crafting) |
| BCE βΆ Node Forge | NodeForgeWindow β create GatheringNodeDefinition assets and place functional gathering nodes in scenes (see Node Forge below) |
| BCE βΆ Spell Forge βΆ Spellbook | ClassAbilityCasterEditorWindow β edit per-class AbilityCaster spellbooks with VFX browser and inline preview |
| BCE βΆ Spell Forge βΆ Projectile Builder | ProjectileForgeWindow β 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 Test | ArcanistProjectileTestBuilder β creates Player_FireballProjectile prefab, wires a Fireball ability into the Arcanist spellbook and prefab, registers with the network manager |
| BCE βΆ Validate βΆ Combat Balance | CombatBalanceValidator β 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 Forge | EnemyForgeWindow β data-driven enemy authoring (definitions, animation, deployment) (see Enemies, Waves & Bosses) |
| BCE βΆ Patrol Forge | PatrolForgeWindow β 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 UI | InventoryUIBuilder β 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 viaBCE βΆ Spell Forge βΆ Spellbook. Edits theAbilityCasterspellbook 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 viaSpellVFXPreviewPanel).
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,useFixedRangetoggle, rect width, indicator size, and target tag. - TIMING & COST β
instantCasttoggle (labeled "Cast On Bind Press (No Click)"),cooldown, andmanaCost. - ARCANIST COMBUSTION β (ArcanistAbilityCaster abilities only)
combustionPoints(Combustion awarded when the ability's projectile deals health damage; critical hits double the award) andspendCombustion(when true, clears all Combustion on cast commit and guarantees a Combustion Meteor proc if Combustion was above zero). - PROJECTILE DELIVERY β
launchProjectiletoggle; when enabled:Projectile VFX Prefab(must havePlayerProjectileandNetworkIdentityon its root β validated with an error when these are missing) andprojectileSpeed. - DAMAGE & CHARGE β
damage,damageDelay,secondaryDamage,secondaryDamageDelay, chargeable settings. - HEALING & DEFENSE β
shieldAbsorb,shieldDuration,healAmount,healingDelay, HoT fields (hotTickAmount,hotTicks,hotInterval),usePulseHealingtoggle. - CROWD CONTROL β
crowdControlType(None, Pull, or KnockUp). When Pull is selected: exposespullDestination,pullDuration,pullSpeed, andpullStopDistance. When KnockUp is selected: exposesknockUpHeightandknockUpDuration. - 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 adefinition(model, animation clips, stats, behaviour). As of the 2026-07-26 update, its animation picker (EnemyForgeAnimationLibrary.BrowseForClip) was relaxed to accept any imported.fbxin the project that contains anAnimationClipβ the old rule forcing clips to live in a model-familyAnimation/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 anEnemySfxProfilecomponent added to the built prefab. The cast-attack picker includes Elemental Lightning as an option (see Enemies, Waves & Bosses). Enemies using Elemental Lightning carry anElementalLightningVFXProfileScriptableObject 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 blankElementalLightningVFXProfileasset, 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 viaEnemyForgeBuilder.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 viaQuestPersistenceService. The Delete Open Quest action removes the asset, strips all associated scene and prefab components, and records a deletion tombstone inQuestDeletionManifestso 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 viaBCE βΆ Loot Forge. Creates and managesLootItemDefinitionassets stored inAssets/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
databaseItemTypeofWeaponmay 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 byLootForgeAttachmentDefaultsusing 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 viaBCE βΆ Node Forge. Creates and managesGatheringNodeDefinitionassets (ScriptableObject) stored inAssets/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 functionalGatheringNodeInstanceobjects carryingAfkGatheringStation,GatheringNodeNetworkState(MirrorNetworkBehaviour),NetworkIdentity, andBoxCollider.
Definition fields:
| Group | Field | Notes |
|---|---|---|
| Identity | nodeId | 1β64 lowercase letters, numbers, underscores, or hyphens. Auto-lowercased on save. |
| Identity | displayName | Human-readable name shown in prompts. Required. |
| Identity | category | GatheringNodeCategory: Mining, Fishing, Woodcutting, Herbalism, Salvaging, Other. |
| Profession | professionId | 0 = Woodcutting, 1 = Fishing, 2 = Mining. Currently validated at 0β2. |
| Profession | minimumLevel | Minimum player profession level to interact (β₯ 1). |
| Yield | lootTable | Optional GatheringLootTable. When assigned, the dedicated server rolls rewards from this weighted table rather than the bare itemId/itemQuantity. See Loot, Inventory & Crafting. |
| Yield | yieldItem | Loot Forge item reference; its itemId is written to itemId on save. |
| Yield | itemId | Database item ID. Use when the item has no Loot Forge definition. |
| Yield | itemQuantity | Items awarded per yield tick (β₯ 1). |
| Yield | secondsPerYield | Tick interval in seconds (β₯ 0.1). |
| Yield | experiencePerYield | XP per yield tick. |
| Yield | bonusYieldLevel | Level at which a 20% double-yield chance applies. |
| Depletion & Respawn | minimumAwardsPerSpawn | Minimum yields before the node depletes (β₯ 1). |
| Depletion & Respawn | maximumAwardsPerSpawn | Maximum yields before depletion (β₯ minimumAwardsPerSpawn). |
| Depletion & Respawn | respawnSeconds | Seconds until a depleted node respawns. Default and recommended live value: 900 (15 minutes). |
| Interaction | interactionRange | Radius in units at which the player can interact (β₯ 0.5). |
| Interaction | cancelRadius | Radius at which gathering auto-cancels. Must be β₯ interactionRange. |
| Interaction | promptHeight | World-space height of the floating interaction prompt above the node root. Default: 2.4. |
| Interaction | interactionVerb | Optional verb shown in the prompt (e.g. "harvesting"). Leave empty for profession defaults. |
| Interaction | gatheringAnimationBool | Animator bool parameter name for the gathering animation. |
| Visual | visualPrefab | Prefab instantiated as a child of the node root. When null, a placeholder shape is used. |
| Visual | visualLocalPosition, visualLocalEulerAngles, visualLocalScale | Transform of the visual child. |
| Visual | yieldVFXPrefab | Particle prefab played at the node on each yield tick. |
| Collider | colliderCenter, colliderSize | BoxCollider settings applied to the interaction trigger. |
| Placeholder | fallbackShape | Shape when no visual prefab is assigned: Rock β Cube, Tree β Cylinder, FishingSpot β Quad. |
| Placeholder | fallbackColor | Material 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) β createsEnemyPatrolRouteobjects 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 (groupFormationPatrolon the route +preserveFormationandformationOffseton 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.
| Script | Type | Active when | Effect |
|---|---|---|---|
DedicatedServerSceneFilter (Editor/DedicatedServerSceneFilter.cs) | IProcessSceneWithReport (callbackOrder β1000) | Player build targeting StandaloneBuildSubtarget.Server | Removes 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. |
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.
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.
*.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