DOMINATION CONTOURS — LOCAL APPEARANCE SETTINGS
Included in Domination 0.10.20 for ReSkate 2.1.2.

Start with Quiet. It is a thin, dim, stationary boundary with a 30m draw range.
The outlines use native visual meshes with no physics or grind components.
They follow sampled map surfaces and use native depth/occlusion. They are
opaque emissive geometry, not a transparent projected decal or filled area.

PLAYER CONTROLS
Open Domination's existing menu. SPOT CONTOUR cycles Off and nine styles;
CONTOUR GLOW cycles Dim, Normal and Bright. The existing OUTLINES switch
remains the master switch for outlines, rings and direction arrows.
These settings are local: changing them does not alter another player's view,
spot bounds, scoring, ownership, lobby rules or network messages.

On runtimes supporting unbound actions, ReSkate's Settings > Binds also offers
"Toggle spot contours" and "Next contour style". Both are unbound initially:
choose your own key or pad combination. On older builds, use the menu or console.
The next-style action cycles to the next preset and enables it. These actions
work while the game has input, not while a menu or console has input.

On some Linux/Wine installations, keyboard reads can take several milliseconds.
The menu and park editor divide expensive reads across ticks when detected. A
slow scan waits 80–350ms between slices; completing several slow slices can take
longer. Drawing, mouse, gamepad and the F8/F9/F10 action shortcuts are independent.

QUICK CONSOLE EXAMPLES
  dom3 rails preset quiet
  dom3 rails color owner
  dom3 rails on
  dom3 rails off
  dom3 rails status
  dom3 rails presets
  dom3 rails preset dashed
  dom3 rails brightness dim
  dom3 rails width 0.04
  dom3 rails gap 0.8
  dom3 rails reset

Selecting a preset resets local visual tuning, retaining local on/off and color.
It does not implicitly turn an off contour on; use "dom3 rails on" if needed.
The menu's style picker selects AND enables the chosen style.
"reset" removes every local contour override. "reset width" removes just the
width override. "inherit" is an alias for reset. These do not reset gameplay.

PRESETS
  quiet     Thin, shallow, dim; recommended starting point.
  fine      Very thin continuous line with normal glow.
  balanced  Medium continuous line with normal glow.
  classic   Original glow: liked 7cm proportions and blue normal emission250.
  dashed    1.2m dashes with 0.65m gaps; fixed spacing around the perimeter.
  markers   25cm marks with 1.75m gaps; minimal coverage, less explicit boundary.
  double    Two thin dim lines, 16cm apart; shorter range for their higher cost.
  ribbon    13cm wide and 1.2cm tall; dim, opaque low strip.
  clear     Thicker bright line; optional stronger readability and more glare.

ADVANCED CONTROLS
Use "dom3 rails <setting> <value>". Dimensions are in meters.
  color       owner, blue, cyan, red, green, yellow, purple, pink, orange,
              teal, tan, white
  brightness  dim, normal, bright
  pattern     solid, dashes, markers, double
  width       0.015–0.18
  height      0.005–0.12
  lift        0.02–0.20 above sampled collision height
  range       10–60 horizontal meters from the skater
  budget      48–384 pieces, whole number
  dash        0.10–4 length of each visible dash/marker
  gap         0.10–4 spacing between dashes/markers
  separation  0.06–0.30 distance between the two lines in double mode

Owner mode uses white for unowned spots, red/blue for teams, and eight distinct
player colors in free-for-all. A fixed color overrides those cosmetic colors
locally. Dim/Normal/Bright select private material variants. Emission differs
by tint to reduce glare: changing color does not mean equal raw shader values.
There is no opacity or softness slider: those properties were not established
for this native material. Width, height and emission are different controls.

More range, dense patterns and twin lines can exceed the piece budget. Nearest
pieces win; distant portions may be omitted. The status command reports active,
pending and omitted counts, fallback, placement failures and peak Lua work.
Peak Lua time is not GPU cost or a frame-rate benchmark. Surface fitting is
incremental; an outline can refine during the first few seconds near a spot.
Collision meshes do not always exactly match rendered geometry. Vertical walls,
overhangs and stacked surfaces need visual review; a downward height ray cannot
describe every possible surface. The renderer does not change spot gameplay bounds.

ADMIN / PACKAGE DEFAULTS AND PERSISTENCE
Edit plugin/contour_defaults.lua to set this installation's defaults, then reload
the plugin. Values are validated and bounded just like console settings.

Precedence:
1. Built-in defaults and the selected named preset.
2. Valid packaged defaults in contour_defaults.lua.
3. This player's explicit saved overrides.

When a player chooses a different preset, its visual dimensions/spacing/glow
replace the packaged preset's tuning. Packaged enabled/color/lift/budget still
apply unless overridden locally. Selecting the packaged preset uses its tuning.
"dom3 rails reset" returns to the current packaged defaults. No session authority
or network-wide cosmetic enforcement has been added; an admin controls defaults
for the installation they distribute, not remote clients' saved preferences.

Preferences use ReSkate plugin storage, key native_rails_v2, schema2, overrides.
Existing native_rails preferences migrate: on/off, supported tint/glow, dimensions,
lift and range are retained with Classic as the starting preset. A new install
without prior preferences starts at Quiet/owner. Invalid values are ignored with
a warning; a failed save leaves the previous effective configuration unchanged.

If a requested private native asset is unavailable, enabled contours temporarily
fall back to Domination's original overlay and retry. Explicit Off stays off.
The legacy fallback retains its original screen-space limitations; it is not
proof that native rendering succeeded. Check status for fallback=true.
