Repository navigation
onlyworlds 0.9.0
Known of (keel PR 113), live in production since 2026-10-20 13:47, and folder format v0.3.10. The schema is repinned to schema-dist v0.32.1-dist.27 (only its example moved), equal to @onlyworlds/sdk 4.40.0's pin.
- Folder format v0.3.10, known-of elements (§4.4). keel hands a guest or player an element it reaches only through its own Character's sheet as a stub,
known_of: true, keepingid,type,name,description,supertype,subtype,image_url,created_at,updated_atandchange_seq(KNOWN_OF_KEEPS) and every other field unset.write_folder(and soexport_world) writes a stub as it is: its kept keys andknown_of: true, never the unset"",nulland[](folder.known_of_for_disk). Every other body is still written untouched. A stub that later arrives whole is written whole, withoutknown_of(a repeated id keeps its last body).FORMAT_VERSIONis now"0.3.10"; folders stamped"0.3.9"stay valid. is_known_of(body): true only forknown_of: true. The reader flags a stub (FolderElement.known_of) and lists them (Folder.known_of), and fills in nothing for the fields it lacks: they are unknown, not empty.- A stub is never pushed:
plan_pushleaves an element that isknown_of: truein the folder or in the baseline out of the diff and lists it inPushPlan.known_ofandPushResult.known_of, never in the membership lists, so a stub alone never makes a plan unmatched.known_ofjoinspush.NOT_SENT. - A stub is never written back:
create,upsert,patchandbulkraiseValueErrorbefore sending a body withknown_of: true(bulknames the item and sends none of the batch); stripping the marker would turn keel's 422 into a write that blanks the element for any key that may write it.known_ofjoinsREAD_ONLY_FIELDS, so any other value of it is never sent. Equal to@onlyworlds/sdk's staged half.