Area Forge

Build and tune individual effect areas while the live map, side profile, performance estimate, and validation engine update with every change.

Included areas00 excluded from export

Planning load0Estimated world particle positions

Validation0No problems found

Coverage0mLargest configured radius

Area editor

Select an area or create a new one.

✦

No area selected

Create a fresh area, add a preset, or import an existing cfgeffectarea file to begin.

A Identity & trigger

AreaName must be unique A clear project name makes duplicate and validation issues easier to find.

Editor color not exported

Type The attached sample uses SpookyArea. Custom values remain allowed.

TriggerType 11 reference values EffectTrigger is the trigger used by every area in the attached test JSON.

Include in export

Exclude drafts without deleting them

Lock area

Protect from bulk edits and patterns

⌖ Position & trigger volume

Paste coordinates X Y Z or X, Y, Z

X East / west coordinate.

Y / height World elevation.

Z North / south coordinate.

Radius Horizontal size of the area.

PosHeight Vertical reach above Y.

NegHeight Vertical reach below Y.

Preview map Uses terrain tiles, towns, POIs, and matching bounds.

◎ Ring geometry & vertical layers

InnerRingCount Number of inner particle rings.

InnerPartDist Lower values create denser rings.

OuterRingToggle Turns the outside ring on or off.

OuterPartDist Spacing along the outside ring.

OuterOffset Experimental shift for the outside ring.

VerticalLayers Additional stacked layers above the base.

VerticalOffset Spacing between stacked layers.

✺ World particle & player effects

Data.ParticleName world / ring particle

The exported value is normalized to graphics/particles/<name>.

PlayerData.AroundPartName

Larger effect attached around the player inside the trigger.

PlayerData.TinyPartName

Close player particle used by feet-style effects.

PlayerData.PPERequesterType 28 reference values

Controls the screen overlay while the player is inside the area.

✎ Project notes & quick actions

Private notes not exported

Quick particle combinations

Changes autosave locally. Export only includes areas with “Include in export” enabled.

Interactive map preview

Pan, zoom, select, or place the active area directly on the grid.

X 0 • Z 0

SELECT MODE

active included excluded Mouse wheel: zoom • drag: pan

Height profile

Visualizes Y, PosHeight, NegHeight, radius, and stacked layers.

Active area analysis

Planning estimate only; actual in-game behavior still needs testing.

Estimated positions0No area selected

Load class—Waiting for an area

Vertical span0mPosHeight + NegHeight

Map position—Preview bounds

Top validation findings

Pattern Lab

Generate lines, circles, grids, gate pairs, and spirals of effect areas from one template. Preview the result before adding anything to the project.

Pattern generator

Locked areas are never modified. Generated names are made unique automatically.

Pattern type

Base template

Particle sequence

Name prefix

Center X

Center Y

Center Z

Count

Rows

Columns

Spacing

Angle / rotationDegrees used by lines, grids, and gate pairs.

Circle / start radius

Spiral turns

Line uses Count + Spacing. Circle uses Count + Radius. Grid uses Rows + Columns + Spacing. Gate creates two mirrored areas. Spiral uses Count + Radius + Turns.

Generated preview

0 areas ready

Preset Vault

A larger collection of player effects, smoke zones, gates, markers, mist, fire, and experimental combinations built from the attached reference names and test JSON.

Reference Library

Search every TriggerType, ParticleName, and PPERequesterType from the attached reference file. Sample usage counts show which values appear in the provided test configuration.

JSON Studio

Import, edit, validate, clean, copy, and export a final Areas-only cfgeffectarea file. SafePositions from imports are detected but intentionally omitted.

Generated cfgEffectArea JSON

0 included areas • pretty format

Final export always uses {"Areas":[...]}. Imported SafePositions are never written back into the finished file.

Import or restore

Supports normal JSON and Stella project backups.

Drop a JSON file hereor click to choose a file
Existing cfgeffectarea.json • Stella project backup

Export toolbox

Additional files for backups and review.

JSON filename

Validation report

No validation run yet.

Build small, test one effect, then scale with confidence.

The forge separates the world particle, the larger player surround particle, and the tiny close-player particle so you can understand exactly which slot is producing an effect. The supplied sample contains 17 areas and 55 SafePositions; this tool imports the areas and removes the SafePositions from every final export.

1 • Start with a preset

Pick flare feet, flame feet, smoke, mist, or a gate preset. Apply it to the active area or add it as a new area, then replace the coordinates.

2 • Test a small radius

Use a small trigger first. Large radii, very low particle spacing, several inner rings, and many vertical layers can create a much heavier setup.

3 • Use the planning estimate

The estimate approximates ring positions from radius and spacing. It is deliberately labeled as planning guidance because the game engine remains the final test.

4 • Validate before export

Fix duplicate names, missing values, unknown reference names, impossible geometry, map-bound warnings, and unusually heavy area estimates.

5 • Back up the original

Download a Stella project backup and keep your server’s original cfgeffectarea file before replacing anything.

6 • Restart and verify

Upload the final Areas-only JSON, restart the server, enter the trigger, and record which world, around-player, tiny-player, and PPE parts actually render.

Field dictionary

Every standard field exposed by this studio.

AreaName	Friendly identifier for the area. Use a unique name for every entry.
Type	Effect-area class. The attached examples use SpookyArea.
TriggerType	Trigger class. The attached examples use EffectTrigger; the library includes every supplied reference name.
Data.Pos	Three-number world position: X, Y/elevation, Z.
Radius	Horizontal radius of the trigger and ring layout.
PosHeight / NegHeight	Vertical reach above and below the configured Y position.
InnerRingCount	Number of inner particle rings.
InnerPartDist	Spacing between positions on inner rings. Lower spacing generally means more positions.
OuterRingToggle	1 enables the outside particle ring; 0 disables it.
OuterPartDist	Spacing between positions around the outside ring.
OuterOffset	Additional outer-ring offset retained for experimentation.
VerticalLayers	Number of extra particle layers stacked vertically.
VerticalOffset	Spacing between vertical layers.
ParticleName	World / ring particle stored under Data.
AroundPartName	Larger particle attached around a player while inside the trigger.
TinyPartName	Close player particle commonly used for feet-style combinations.
PPERequesterType	Player screen overlay applied while inside the effect area.