-
-
Notifications
You must be signed in to change notification settings - Fork 1
[Config/Runtime] Define runtime reload and config change event semantics #76
Copy link
Copy link
Open
Labels
area:guest-sdkGuest authoring SDK, macros, builders, modder ergonomics, high-level API.Guest authoring SDK, macros, builders, modder ergonomics, high-level API.area:runtimeRuntime behavior, lifecycle, ticking, session behavior, execution flow.Runtime behavior, lifecycle, ticking, session behavior, execution flow.component:docsDocumentation, guides, READMEs, architecture docs, examples docs.Documentation, guides, READMEs, architecture docs, examples docs.future-foundationLong-term foundation, not necessarily blocking rc10.Long-term foundation, not necessarily blocking rc10.priority:p3Low priority. Nice-to-have, backlog, polish, or distant follow-up.Low priority. Nice-to-have, backlog, polish, or distant follow-up.status:confirmedConfirmed bug/request. Reproduced, accepted, or clearly valid.Confirmed bug/request. Reproduced, accepted, or clearly valid.transport:cross-transportShared semantic work that must align across builtin/wasm/native/external.Shared semantic work that must align across builtin/wasm/native/external.type:architectureLong-term structural / contract / system design work, not just isolated implementation.Long-term structural / contract / system design work, not just isolated implementation.
Metadata
Metadata
Assignees
Labels
area:guest-sdkGuest authoring SDK, macros, builders, modder ergonomics, high-level API.Guest authoring SDK, macros, builders, modder ergonomics, high-level API.area:runtimeRuntime behavior, lifecycle, ticking, session behavior, execution flow.Runtime behavior, lifecycle, ticking, session behavior, execution flow.component:docsDocumentation, guides, READMEs, architecture docs, examples docs.Documentation, guides, READMEs, architecture docs, examples docs.future-foundationLong-term foundation, not necessarily blocking rc10.Long-term foundation, not necessarily blocking rc10.priority:p3Low priority. Nice-to-have, backlog, polish, or distant follow-up.Low priority. Nice-to-have, backlog, polish, or distant follow-up.status:confirmedConfirmed bug/request. Reproduced, accepted, or clearly valid.Confirmed bug/request. Reproduced, accepted, or clearly valid.transport:cross-transportShared semantic work that must align across builtin/wasm/native/external.Shared semantic work that must align across builtin/wasm/native/external.type:architectureLong-term structural / contract / system design work, not just isolated implementation.Long-term structural / contract / system design work, not just isolated implementation.
Type
Fields
Give feedbackNo fields configured for Task.
Goal
Define how config changes behave after a runtime/session has already started.
#60 introduced public config schema metadata including reload policy:
runtimeworld_restartreconnectrestartToday that metadata is useful for validation, docs, and future tooling, but the runtime does not yet define a full live config update contract.
Motivation
Some settings can safely change while running, while others must be fixed at startup or world creation.
Examples:
The runtime needs one coherent model instead of ad hoc mod-specific behavior.
Scope
Define:
Possible design directions
Option A: no live callback initially
runtimemeans tooling may allow change while runningOption B: explicit config-change callback
This issue should decide the long-term contract before implementation.
Non-goals
Acceptance criteria