Skip to content

v1.3.0 - Onboarding (import, presets, validation, help)

Choose a tag to compare

View all tags
@gjdunga gjdunga released this 16 May 18:30
· 53 commits to main since this release
v1.3.0
da3fdcd

PVE Damage Guard v1.3.0 - onboarding release. Reduces friction for new admins and Damage Control migrators.

What's new

/pdg import damagecontrol

One-shot migration from Damage Control 2.5.x. Reads oxide/config/DamageControl.json, backs up your current PDG config, and maps compatible fields:

  • Per-victim damage tables (APC, Heli, Bear, Wolf, Boar, etc.) -> PerVictimSubtypeScaling
  • Building_Grade_Multipliers -> BuildingGradeMultipliers
  • Bypasses.Heli_bypass = true -> PerAttackerStructureScaling["PatrolHelicopter"] = 1.0
  • Time.Time_Type -> TimeOfDaySource
  • Time multiplier arrays (Global, Player, NPC, Building) -> TimeOfDayMultipliers

Explicitly skipped (no equivalent): Animal/Heli/Bradley/Other time multipliers, per-piece Building protection. Each skip is reported with rationale.

/pdg preset

Four ready-to-use complete config snapshots:

Preset Use case
pvepure Block all PvP, severe NPC scaling, full base invulnerability to NPCs
pvereflect Reflect PvP, NPCs at 0.5x damage, structures at 0.5x
pvevehicleraids Block NPC->structure EXCEPT Patrol Heli and Bradley (full damage)
pvphoursevents Rule matrix on, PvP only during Bradley/Heli/Cargo events

/pdg validate

Runs validation on demand. Checks: damage type names parse, scaling values in [0, 100], TOD arrays have 24 elements, rule matrix Inherits chains have no cycles or dangling refs, all action strings parse, provider target context names exist.

Validation also runs automatically at load and on /pdg reload. Issues surface as console warnings and in the Config issues: N line of the /pdg status block.

/pdg help [subcommand]

Interactive help system. Top-level lists all subcommands; per-subcommand pages show usage and an example. Closest practical equivalent to tab completion (Rust chat doesn't support client-side completion).

Backwards compatibility

No breaking changes. All additions are new commands plus a passive validation pass. Existing v1.0.x / v1.1.x / v1.2.x configs upgrade in place.

Install

Drop PVEDamageGuard.cs (below) into oxide/plugins/. Existing admins coming from Damage Control: run /pdg import damagecontrol once after install to bring over your tuning. New admins: /pdg preset pvereflect for a sensible starting point.

License

GPL-3.0

Assets 3
Loading