ludic/packages/ludic.devlink/README.md

ludic.devlink

An editor's live link into a running dev build: the wire protocol v1 frozen in game-editor/proposals/2026-09-29-devlink/protocol-v1.md. Uses ludic.base and nothing else.

• Transport is the DevlinkNet port (a game binds Udp.*, a test a fake). One request a frame, read from one fixed 8 KB buffer and answered into another; nothing is made per frame. Only a loopback sender is answered (DevlinkNet.loopback); the socket opens only when DevlinkWorld.enabled() says so (a game binds dev_tools), so a release build never opens it.
• Verbs are DevlinkWorld members, every default "not offered" (err unbound): ping, hello, cam_get / cam_set / cam_release, goto, map_load, time, weather, shot, pause / resume, step. map_load, shot and step answer later by id (5 s at most, one at a time). While coop() says a session is connected, everything but ping and hello is refused.
• The interface's verbs are DevlinkUi members, the same default: ui_screen answers the screen's root class and every component up; ui_model "<Class>" "<out>" and ui_tree "<out>" have the game write the first instance's model, or the whole tree, to that file (no ..) and answer ok "<out>", so a datagram stays small; ui_override "<path>" "<file>" has the interface read a template or stylesheet from that file and reload it keeping state ("" for the file clears one, "" "" clears all). All answer at once.
• Call devlink_tick once a frame from something that runs while the game is paused (not from a system the pause stops), or resume could never arrive.

Tests: ludic test packages/ludic.devlink (a fake transport, world and interface; each answer byte for byte).