feat(scripting): Phase 4 — ergonomics (file-watcher auto-reload, handle methods, tooling) #197

New issue

Open

opened 2026-07-24 19:01:28 +02:00 by marco · 0 comments

marco commented

2026-07-24 19:01:28 +02:00

Owner

Follow-up to #183. DX niceties on top of the working spine.

Scope

File-watcher auto-reload (dev-only): debounced, cross-platform-safe, atomic-save-race-safe — edit .lua → auto /reloadscripts.
Lua handle wrappers: expose methods on the Mobile/Player handles (e.g. npc:say(...), player:getFlag(...)) so npc. autocompletes members, in addition to the free verbs. Generated into api.d.lua.
Authoring/debug tooling as needed (e.g. a /scripts listing, reload feedback).

Definition of Done (delta)

Editing a committed script auto-reloads in dev without a manual command (documented as dev-only).
Handle methods work at runtime and appear in api.d.lua (autocomplete on npc: / npc.), drift-check green.
docs/scripting.md + src/IsoMmo.Scripting/README.md updated. Base DoD + multi-platform hold.

Note: scripting spells stays deferred (casting/mana/pacing is authority- and timing-critical) — a separate future decision, not part of this.

Follow-up to #183. DX niceties on top of the working spine. ## Scope - **File-watcher auto-reload** (dev-only): debounced, cross-platform-safe, atomic-save-race-safe — edit `.lua` → auto `/reloadscripts`. - **Lua handle wrappers**: expose methods on the `Mobile`/`Player` handles (e.g. `npc:say(...)`, `player:getFlag(...)`) so `npc.` autocompletes members, in addition to the free verbs. Generated into `api.d.lua`. - Authoring/debug tooling as needed (e.g. a `/scripts` listing, reload feedback). ## Definition of Done (delta) - Editing a committed script auto-reloads in dev without a manual command (documented as dev-only). - Handle methods work at runtime and appear in `api.d.lua` (autocomplete on `npc:` / `npc.`), drift-check green. - `docs/scripting.md` + `src/IsoMmo.Scripting/README.md` updated. Base DoD + multi-platform hold. _Note: scripting **spells** stays deferred (casting/mana/pacing is authority- and timing-critical) — a separate future decision, not part of this._

marco referenced this issue

2026-07-24 19:01:45 +02:00

feat(scripting): Lua (MoonSharp) content-scripting layer for NPCs & quests — design + phase 1 #183

marco referenced this issue

2026-07-25 03:23:51 +02:00

feat(scripting): Phase 2 (onTick/onDeath) + Phase 3 (usable items) #203

marco referenced this issue from a commit

2026-07-25 09:20:31 +02:00

feat(scripting): Phase 2 (onTick/onDeath) + Phase 3 (usable items) (#203)