Open questions
229 behaviors are provisional. Each one is a point where the engine had to choose and no legacy server or author has confirmed the answer yet. The engine does what the last column says. That behavior may change when the question is settled, so do not build scripts that depend on it without a test of your own. None of these is presented as legacy behavior.
Client: Frame Loop, Rendering, Input, and Sound
Section titled “Client: Frame Loop, Rendering, Input, and Sound”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-CLI-1 | Legacy key code values and key repeat | Windows virtual-key codes; repeat raises onKeyPressed |
| OQ-CLI-2 | Which objects receive input events, and in what order | Weapons and current-level NPCs, creation order |
| OQ-CLI-3 | focusx, focusy, isfocused, cameraposition, camerasize, camerabounds, $camera::movementspeed |
§5.2 |
| OQ-CLI-4 | Draw order of tile layers, layers 1 and 2, and characters | §6.1 |
| OQ-CLI-5 | Blend function of effect mode 3 (day/night) | Multiply |
| OQ-CLI-6 | Font style letters c and r outside GUI profiles |
Centered, right-aligned |
| OQ-CLI-8 | showimg2 argument order; showpoly2 projection |
Layer last; z subtracts from y on screen |
| OQ-CLI-9 | Format of gani parameters | Comma-separated list |
| OQ-CLI-10 | Which events of the playing object reach a gani’s script object | The legacy numbered events, before the object itself (§9.5); from the v6 client, not probed on a live client |
| OQ-CLI-11 | Is MIDI needed? | Not supported |
| OQ-CLI-12 | Which call plays music | §10.3 |
| OQ-CLI-13 | Offset and blending of textshadow |
One pixel down and right, same alpha |
| OQ-CLI-24 | Units and direction of speed, angle, zangle, spin, lifetime on a show image, and the unit of z |
§8.4a: per second, radians, tiles on the level layers |
| OQ-CLI-14 | Which colors does an actor use for the colors a script left unset, and does reading actor.colors[0] give a name or an index? |
The local player’s colors; reads give back what was written |
| OQ-CLI-15 | Defaults of the $pref:: settings the legacy client keeps in memory only (capture options, buddy list flags and the like) |
The defaults of the settings table (§11.1) |
| OQ-CLI-16 | Values of emoticonChar, isOpenGL, screenPixelScale, isRecordingVideo, isStreamingVideo, installedLanguages |
Empty, false, 1, false, empty, English |
| OQ-CLI-17 | Arguments and moments of onConnectingToServer, onServerLogin, onDisconnectedFromServer, onOfflineModeStarted, onOpenLogWindow, onOpenServerList, onToggleScriptedPlayerList |
No arguments; moments of §4.11 |
| OQ-CLI-18 | Names keyName gives to keys, and whether the slot of a binding is the position in the list of the action |
Usual key names; slot is the position |
| OQ-CLI-19 | Layout of setContentControl, whether mouseButtons needs the game to have the focus, who owns selectedListPlayers |
Fills the screen under the others; needs the focus; the script owns it |
| OQ-CLI-25 | Sheet layout of a mount image | 32 pixel cells, one column per direction in the first row |
| OQ-CLI-27 | Sheet layout of a horse image, where it sits against its rider, and when a mount is drawn besides the gani’s own HORSE sprite |
One column per direction (up, left, down, right) in the first row; half a tile below the rider’s position; only when the gani has no HORSE sprite |
Content File Formats
Section titled “Content File Formats”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-FMT-2 | Meaning of the optional newLayer layer link parameters |
Preserved, unused |
| OQ-FMT-3 | Chest section in GR-V1.01 |
Try to read; accept absence |
| OQ-FMT-4 | Sign character table for each binary version | Table data file per version, original bytes kept |
| OQ-FMT-5 | Behavior of extra gmap keys (MAPIMG, MINIMAPIMG, NOAUTOMAPPING, LOADFULLMAP) |
Preserved, no effect |
| OQ-FMT-6 | Does the legacy client support gani movie mode? | Parsed and preserved, not played |
| OQ-FMT-7 | Template parameter types and substitution of paramN |
§8.2 |
| OQ-FMT-8 | Complete list of GS1 event flags and command words for detection | §9.2 lists, extended from real files |
GUI legacy parity
Section titled “GUI legacy parity”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-GLY-1 | GUI styles (levels/guistyles, defaultguistyle) |
Not implemented; every control uses the profile path |
| OQ-GLY-2 | The bottom-left corner of §3.3 is clipped by comparing its width with the height | Same as legacy |
| OQ-GLY-3 | Font: Arial is not free to ship; pixel size of fontSize |
A metric-compatible free font, fontSize as pixel height |
| OQ-GLY-4 | Row icons made of drawing commands (row.icon, also on tabs); the scroll bar of a tall open list |
Not drawn; a tall open list scrolls with the wheel |
| OQ-GLY-6 | GuiMLTextCtrl and GuiMLTextEditCtrl: the legacy layout engine (MLTextLayout::render, 0x555550) did not decompile and needs a disassembly reading |
Borne’s own markup layout |
| OQ-GLY-9 | Icons of menu titles (GuiMenuSubCtrl drawing panel at title x + 1) and of context menu rows |
Not drawn; the title has no icon space |
| OQ-GLY-11 | Cursors: GuiMLTextCtrl over plain text (the legacy check reads a field of the text atom that was not identified), the mouse movement while the GUI cursor is off, and where the picture of setcursor2 shows |
Over plain text the control’s own cursor; the mouse moves as usual; the picture is kept and not drawn |
| OQ-GLY-10 | GuiAccordionCtrl: the exact rounding of the two open widths while moving, the new target given during a move, and the bitmap-array look of the open area (style type 5) |
Each open width is round((1 − distance) · free); a new target restarts the ease from the shown position; backgroundImage or the profile’s fill and border |
| OQ-GLY-8 | focusOnShow and textGradient/gradientColor of a profile (§4.7) |
focusOnShow with modal: a control that wakes takes the keyboard focus while the GUI cursor is on, verified (legacy client source, onWake then takeFocus). textGradient/gradientColor stored; the text is drawn in one color |
| OQ-GLY-5 | A text list with no columns |
One column at 0 (inferred: the legacy list draws one column per entry of its column list) |
GUI Toolkit
Section titled “GUI Toolkit”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-GUI-1 | Are control names case-insensitive, and what happens on a duplicate name? | Case-insensitive; the old control is replaced and the new one keeps its script object |
| OQ-GUI-2 | Exact argument lists of GUI events | §2.5 and §3 |
| OQ-GUI-3 | Bitmap button image suffixes | _h, _d, _i |
| OQ-GUI-4 | GuiMenuCtrl members |
Stub until confirmed |
| OQ-GUI-5 | Unknown markup tags | Shown as text |
| OQ-GUI-6 | GuiDrawingPanel parameter lists |
From the definitions database |
| OQ-GUI-7 | Copy semantics of new GuiButtonProfile("Mine") |
Starts from the built-in default of the type |
| OQ-GUI-8 | Built-in theme family names and $pref::Video::defaultguistyle values |
§5.4 |
| OQ-GUI-9 | Which script’s Ctrl.onEvent handler runs when several declare it |
The owner script’s, else any |
| OQ-GUI-10 | catchevent callback arguments |
Target control first, then the event’s arguments |
| OQ-GUI-11 | Defaults of clipchildren, cliptobounds, clipmove |
true, verified (legacy client source, GuiControl defaults); a rotation other than 0 turns cliptobounds off |
| OQ-GUI-12 | Control animations (createAnimation) and GuiFlash |
Transitions provided (gui-legacy.md§29); GuiFlash not provided |
| OQ-GUI-13 | Fields of row and node objects and the details the legacy pages leave out (getNodeByPath separator, addLines, addVars, sortControls, findText flags) |
§3.4 to §3.7 |
| OQ-GUI-14 | Which profile color and style each kind of word uses in syntax highlighting | §3.8 mapping |
| OQ-GUI-15 | Client area insets of a window; external windows | The title bar only; external windows stay in the canvas |
| OQ-GUI-16 | autoindenting and tabspaces details |
§3 table |
| OQ-GUI-17 | Receiver and arguments of the focus events and who gets onFirstResponderChanges |
§6.5: the root canvas, with the control |
| OQ-GUI-18 | Look of the flip, zoom, grow, shrink and rotate transitions | They fade (gui-legacy.md§29.3) |
| OQ-GUI-19 | What mode, rotation, color and the render hints do on controls other than a bitmap |
Kept for scripts, no drawing effect (§2.6) |
| OQ-GUI-20 | How onCursorLineChanged counts lines (wrapped lines or line breaks) |
Line breaks, from 0 |
| OQ-GUI-21 | What the close button does with closequery |
Raises onCloseQuery and nothing else (§3.10) |
| OQ-GUI-22 | Arguments of onMouseOverCell |
(id, text, index) of the row on a text list, verified (legacy client source) |
| OQ-GUI-23 | TFrameDetail: types of the members, which divider bordermovable guards, what the border members draw |
§3.14 |
| OQ-GUI-24 | When onTextEditStart and onTabComplete are raised and their arguments |
§3.13; onTabComplete(shift) gets whether Shift is held, verified (legacy client source) |
| OQ-GUI-25 | Node image, selectedimage and similar members: legacy page says int, Borne keeps the image name |
A string |
Bornescript Language Server
Section titled “Bornescript Language Server”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-LSP-1 | How long a chain legacy scripts write in practice | 16 segments, longer chains are unresolved (§3.7) |
| OQ-LSP-2 | Type of a variable assigned values of different types | The last assignment in the text wins (§3.8); no union types from chains |
| OQ-LSP-3 | Whether W-UNKNOWN-MEMBER should also use inferred types (not only annotated ones) |
No: inferred types never raise it (§3.9), because script objects accept members the database does not list |
| OQ-LSP-4 | The type of this outside GUI blocks (NPC or weapon, depending on the script kind) and of calls of script functions |
Unresolved, no members offered by chains (§3.7) |
Bornescript Language
Section titled “Bornescript Language”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-LANG-1 | Character encoding of legacy strings: are strings byte strings, and how is text displayed (UTF-8, Windows-1252)? Do .length(), .charat(), .pos() count bytes? |
Resolved by probes: byte strings ("é".length() is 2 in a UTF-8 file); display decodes UTF-8 and falls back to Windows-1252 per invalid sequence |
| OQ-LANG-2 | Is //#CLIENTSIDE matched case-insensitively and with surrounding whitespace? |
Resolved by probes: only the exact line //#CLIENTSIDE splits (§1.4); other spellings are plain comments |
| OQ-LANG-3 | Are keywords case-insensitive (Function, IF)? |
Resolved by probes: legacy keywords, prefixes, script functions, and string and array methods are exact-case; Borne now reports a compile error for the wrong case (§2.3) |
| OQ-LANG-4 | Are 5. and hex literals 0x1F valid? |
Resolved by probes: yes (5. is 5, 0x1F is 31, .5 is 0.5) |
| OQ-LANG-5 | Exact 32-bit saturation edges: negative overflow, division, literals above the limit, * |
Resolved by probes: every result clamps to ±2147483647 (§7.1); operands and literals do not |
| OQ-LANG-6 | Unknown escapes and single-quoted strings | Resolved by probes: legacy rejects unknown escapes at compile time; Borne keeps \x gives x as an extension (§14); single quotes are character literals, read as strings |
| OQ-LANG-7 | Does %= exist? |
Resolved by probes: yes |
| OQ-LANG-8 | Precedence of &, ` |
, in` |
| OQ-LANG-9 | When do top-level statements run relative to onCreated, and on each join? |
Resolved by probes: before onCreated, on each instantiation or join; a class joined at top level runs after the host’s top level (§3.7) |
| OQ-LANG-10 | Formatting of very large numbers, infinity, NaN | Resolved by probes: clamp to ±2147483647, 9 digits truncated, nines carry (§5.1); NaN prints 0 |
| OQ-LANG-11 | String-to-number rule ("42abc", "1,2" + 1, objects) |
Resolved by probes: strtod prefix (§5.2, -1 without one); objects are 0 |
| OQ-LANG-12 | List-string edge cases (",", ",a", "a,b,,", tabs, empty elements on output) |
Resolved by probes: "," is the empty list; one trailing empty element is dropped; tabs are not spaces; empty elements are written as "" (§5.5, §5.7) |
| OQ-LANG-13 | String form of an unnamed object | Resolved by probes: unknown_object (§5.8) |
| OQ-LANG-14 | Do unprefixed names resolve to global named objects, and in which order? | Resolved by probes: yes, a named object (not a TStaticVar) comes before a script-global of its name (§6.3 step 5) |
| OQ-LANG-15 | Do joined classes share the host’s script-global variables? | Resolved by probes: yes, one table per object |
| OQ-LANG-16 | Unprefixed assignments to non-built-in names inside an initializer block | Resolved by probes: ordinary writes (temp, then script-global); only this. reaches the new object (§6.5) |
| OQ-LANG-17 | Dots inside dynamic names and makevar names |
Resolved by probes: literal in (@...); makevar walks the dots (§6.8) |
| OQ-LANG-18 | Division and modulo by zero | Resolved by probes: 0, no report |
| OQ-LANG-19 | Loose equality between a number and a non-numeric string ("abc" == 0) |
Resolved by probes: the string converts by §5.2 ("abc" is -1), so "abc" == 0 is false (§7.3) |
| OQ-LANG-20 | Do && and ` |
|
| OQ-LANG-21 | Truthiness of numeric strings other than "0" ("0.0", " 0") |
Resolved by probes: false when the §5.2 value is 0 |
| OQ-LANG-22 | params on the client side |
Same as server |
| OQ-LANG-23 | Does a plain call find a function value stored in a script-global variable? | Resolved by probes: legacy reports the function as not found; Borne finds the value after built-ins as an extension (§8.4, §14) |
| OQ-LANG-24 | Lookup order between own functions and joined classes, and among classes | Resolved by probes: own first, then classes in join order, first joined first |
| OQ-LANG-25 | Visibility inside with (otherObj): is a call to a non-public function of otherObj “from outside”? |
Resolved by probes: yes; a plain call inside with looks only at the code owner (§8.4) |
| OQ-LANG-26 | with on an empty object: skip the block or run it with empty this? |
Resolved by probes: the block runs, without a report (§9.6) |
| OQ-LANG-27 | Can TStaticVar be named with new TStaticVar("Name")? |
Resolved by probes: yes |
| OQ-LANG-28 | Exact import syntax and constructor naming |
§10.2 |
| OQ-LANG-29 | Trailing comma in array literals | Resolved by probes: allowed ({1, 2,} has size 2) |
| OQ-LANG-30 | Index assignment on empty variables and list-string variables | Resolved by probes: no effect; convert to array then assign |
| OQ-LANG-31 | Are nested arrays copied deeply on assignment? | Resolved by probes: yes |
| OQ-LANG-32 | Per-kind continuation behavior of runtime errors | Resolved by probes: the §12.2 table; try/throw are Borne extensions (§14) |
| OQ-LANG-33 | Member store into an unset variable; clearvars and getdynamicvarnames on one |
Resolved by probes: the variable becomes an object (§6.13) |
| OQ-LANG-35 | unset(name) with its value used (legacy returns 0 and clears nothing) |
Borne clears the variable in both forms |
| OQ-LANG-34 | Which of the forms of §2.5 (multi-line strings) and §3.10 the legacy server accepts, and what the unprobed ones do | Accepted as the Zodiac scripts use them; probe when the RC is reachable |
Movie Clips, Stage, and Drawing Panels
Section titled “Movie Clips, Stage, and Drawing Panels”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-MC-1 | Range of alpha, red, green, blue |
0 to 1 (§5.1); getProperty(6) is a percentage |
| OQ-MC-2 | Whether frame counts from 0 or 1 |
0-based in the property, 1-based in gotoAnd* and getProperty(4) |
| OQ-MC-3 | Timeline and onEnterFrame rate |
30 ticks a second, at most four per frame step |
| OQ-MC-4 | Frame labels | Not supported; a non-number leaves the frame unchanged |
| OQ-MC-5 | Meaning of numbers other than those in §2.6 | Read as empty, write nothing |
| OQ-MC-6 | When onInitFrame is called |
Once, in the first frame step after the clip was made |
| OQ-MC-7 | What objectname and the frame count mean without an animation library |
objectname is the image file; framecount is a plain writable number |
| OQ-MC-8 | How masks clip | By the bounding rectangle of the mask clip |
| OQ-MC-9 | The key and math helper objects |
Read as empty |
| OQ-MC-10 | Whether onRelease needs the pointer over the clip |
Only when still over the clip that took the press |
| OQ-MC-11 | What objectnames and layernames list |
Distinct image files of the subtree, and child names by depth |
| OQ-MC-12 | Arguments of hitTest |
A screen point, or another clip |
| OQ-MC-13 | Where clips sit among the screen layers | §9.1 |
| OQ-MC-14 | Which objects drawObject draws |
Show images and NPCs that show an image |
| OQ-MC-15 | Blend rule of the maskImage operations |
Per channel on alpha; add and subtract limited to 0 to 255 |
| OQ-MC-16 | Palette matching and the transparent index | Nearest color by squared RGB distance; alpha-0 pixels stay |
Networking
Section titled “Networking”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-NET-1 | Does legacy replicate emitter and particle properties of public show images? | Yes, as property changes |
| OQ-NET-3 | Does a client write to player.chat replicate, and does it raise onPlayerChats? Which other own-player fields can client scripts set? |
Replicates without onPlayerChats; look and gani fields |
| OQ-NET-2 | Legacy triggerserver target types besides weapons |
"npc" targets NPCs in the interest levels |
Particle Engine
Section titled “Particle Engine”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-PART-1 | Meaning of autorotation |
Particles face their movement direction |
| OQ-PART-2 | movementvector and dimension meanings |
Velocity added per second; dimension stub |
| OQ-PART-3 | Exact triggers of dropemitter and dropwateremitter |
§3.4 |
Persistence
Section titled “Persistence”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-PERS-1 | Account name rules and case sensitivity | 3–20 of [A-Za-z0-9_], case-insensitive uniqueness |
| OQ-PERS-2 | Which right lets staff create player accounts in RC | “Change staff accounts” |
Player API
Section titled “Player API”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-PLAYER-1 | Does alpha multiply a gani’s own per-sprite opacity |
It multiplies |
| OQ-PLAYER-2 | What a mode outside 0 to 3 does |
Selects mode 0 (§3.1) |
| OQ-PLAYER-4 | The upper bounds of defaultwalkspeed, diagonalwalkspeed, freezetime and the hiding time |
2, 2, 3600 seconds and 3600 seconds |
| OQ-PLAYER-5 | How isleader is chosen |
The lowest player id in the level |
| OQ-PLAYER-7 | How long an emoticon shows and which image a key shows | 3 seconds; emoticon-<letter>.png |
| OQ-PLAYER-9 | The input units of worldx and worldy |
Logical screen pixels |
| OQ-PLAYER-10 | What putleaps, lay2 and hitobjects do |
They report R-NOT-IMPLEMENTED once and do nothing |
| OQ-PLAYER-11 | The arguments of the three mouse action events | The mouse in level tiles |
| OQ-PLAYER-14 | What getnearestplayer returns |
A player object, like findnearestplayer (§5.2) |
Remote Control (RC) and Staff Rights
Section titled “Remote Control (RC) and Staff Rights”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-RC-1 | Folder rule case sensitivity, deny rules, overlap | Case-sensitive, no deny, union |
| OQ-RC-2 | Legacy folder configuration type names | §6.1 list |
| OQ-RC-3 | How MCP tells admin onRCChat commands apart |
onRCCommandKind(cmd) returning "admin" |
| OQ-RC-4 | hasright letters, rules changed while the player is online |
All letters must be granted; rules are read at login |
Repository and Tooling
Section titled “Repository and Tooling”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-REPO-2 | Image layouts of legacy heads, bodies, swords, and shields | Taken from real legacy files during milestone 5 and written into the asset list |
Standard Library
Section titled “Standard Library”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-STD-1 | Structure of the reference definitions file: does it give owner types for members? | Phase 3 inspects it and adds owners where missing |
| OQ-STD-2 | Parameter order and results of strpos, strcmp, contains |
Resolved by probes: strcmp gives -1/0/1; contains is case-insensitive list membership; strpos is a Borne extension, legacy uses .pos (§2.1) |
| OQ-STD-3 | wraptext width unit |
Characters |
| OQ-STD-4 | Case sensitivity of .starts and .ends |
Resolved by probes: case-insensitive |
| OQ-STD-5 | format: - flag, unknown conversions |
Resolved by probes: left-justify; an unknown conversion is dropped and uses no value |
| OQ-STD-6 | tokenize: empty parts for consecutive delimiters; tabs as default delimiters |
Resolved by probes: non-space delimiters keep empty parts, space delimiters collapse; tabs are not default delimiters (§2.4) |
| OQ-STD-7 | round of halves |
Resolved by probes: legacy servers have no round (clients use Math.round); Borne keeps it as an extension, away from zero |
| OQ-STD-8 | getdir ties and getangle sign |
Resolved by probes: dy >= 0 ties give 2, so getdir(0, 0) is 2; getangle is in [0, 2π) (§3) |
| OQ-STD-9 | .remove first or all; .insert out of range |
Resolved by probes: first; append; a negative index appends |
| OQ-STD-10 | Case sensitivity of text sorts | Resolved by probes: case-insensitive text order, numbers too; lowercase first on a tie (§5.1) |
| OQ-STD-11 | sortbyvalue key and keyType |
Resolved by probes: sortbyvalue(member, type, ascending) (§5.1) |
| OQ-STD-12 | Legacy string-list functions | Resolved by probes: the first argument is the variable name as a string; deletestring(var, index), removestring(var, string) (§5.2) |
| OQ-STD-13 | isobject(name) |
Resolved by probes: a named NPC, weapon, or TStaticVar is 1, a class name or an unknown name 0 (§6.2) |
| OQ-STD-14 | Order of getstringkeys results |
Resolved by probes: sorted |
| OQ-STD-15 | savevarstoarray(true) |
Resolved by probes: true sorts by name; false keeps insertion order |
| OQ-STD-16 | JSON output of empty values | Resolved by probes: "" stays ""; a variable set to null holds 0 and is written as 0 (§7.1) |
| OQ-STD-17 | findpathinarray parameter meanings |
§9.1 |
| OQ-STD-18 | trace versus echo; toall presentation |
Resolved by probes: same as echo |
| OQ-STD-19 | Legacy calling form of loadlines, loadstring, savelines, savestring |
Both forms exist for loadlines and loadstring (verified); what the method form writes is still open |
| OQ-STD-20 | findfiles pattern syntax |
* wildcard within one folder |
| OQ-STD-21 | dbQuery, executeQuery, dbLastError |
§13.4 |
| OQ-STD-22 | TCURLRequest.quick |
Short timeout |
| OQ-STD-23 | converttimetostring and formattimestring formats |
Resolved by probes: ctime format (Tue Nov 14 22:13:20 2023) in the server’s time zone (Server Options time_zone_offset); strftime style |
| OQ-STD-24 | Growing methods on an empty variable | Create the array; a number or object receiver does not grow |
| OQ-STD-25 | .positions(sub) overlap and empty sub |
Overlapping; empty array |
| OQ-STD-26 | aes_encrypt padding, key and IV lengths |
CBC, null-byte fill to 16, key 16/24/32, IV 16 |
| OQ-STD-27 | des_encrypt mode, key use, partial block |
ECB, first 8 key bytes, partial block unchanged |
| OQ-STD-28 | Vector text: print threshold, short matrix, gimbal pole | 0.00001; identity; y angle 0 (§17.2) |
| OQ-STD-29 | convertutf8tolatin for U+2018 to U+201F and above U+00FF |
Plain quotes; low byte |
| OQ-STD-40 | Unit of getmemoryusage |
Bytes of the script heap |
| OQ-STD-43 | MRandomGenerator algorithm and range |
31-bit linear generator seeded by seed |
| OQ-STD-44 | getvarnames built-in names and getfunctions fields |
§17.4.1 |
| OQ-STD-45 | forceaboveterrain on a flat terrain |
Particles never go below height 0 |
| OQ-STD-46 | Music volume channels, note pitch scale, play3d attenuation |
Mean of both values; equal temperament; plain position, no attenuation |
| OQ-STD-47 | getplatform names, text measuring units, wraptext2 break rules |
OS name; whole pixels with built-in fonts; spaces and listed characters (§17.5) |
| OQ-STD-48 | Screenshot folder and file naming | screenshots/ in the config area, plain .png name (§17.5.4) |
| OQ-STD-49 | Where the legacy client keeps script-written files, and the loadfolder result format |
Client writes go to scriptfiles/, names without a folder (design, §12.5) |
VM and Coroutines
Section titled “VM and Coroutines”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-VM-1 | During sleep, are events other than scheduled events queued, dropped, or run? Does a setTimer during the sleep work? |
Resolved by probes: triggers and scheduled events run during the sleep; a setTimer during the sleep, or a second sleep of the object, drops the sleeping function (one timer per object, §6.1) |
| OQ-VM-2 | What does waitfor return when the event arrives? |
Resolved by probes: 1; the event is taken, so the object’s own handler does not run (§6.2) |
| OQ-VM-3 | Meaning of waitfor timeout 0 or omitted |
Resolved by probes: 0 returns 0 at once |
| OQ-VM-4 | Legacy loop limit (maxlooplimit) value and scope; should the engine also count loop iterations? |
Resolved by probes: legacy stops a run after about 10,000 loop iterations, nested loops counted together; Borne counts backward jumps with a limit of 1,000,000 per run (§8) |
Web access, file status, and network objects
Section titled “Web access, file status, and network objects”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-WEB-1 | Clock of getLastFileRequestTime, getLastFileDownloadTime, getLastWebRequestTime, getLastWebDownloadTime |
Client time since the client started (frame loop time), server timevar2 |
| OQ-WEB-2 | Does the server requesturl reuse the object of an address like the client? |
No: each call creates an object |
| OQ-WEB-3 | requesturlasgamefile with force false: when does the legacy client skip the download? |
Skips only when the same address was fetched into the same name in this session |
| OQ-WEB-4 | Exact meaning of the server fileupdateignore |
Changes of that file on the disk are not announced until fileupdate is called for it |
| OQ-WEB-5 | resolvehost on the server: blocking time and which names are allowed |
At most 500 ms wait, allowed names only, results cached 60 s |
| OQ-WEB-6 | Which objects hear onFileDownloaded, onFileChunkReceived, onLevelFileUpdated (the legacy engine raises them on the global script object) |
Every weapon and NPC of the client that defines the event |
| OQ-WEB-7 | Size limit of web answers for client scripts | 512 KiB |
| OQ-WEB-8 | Flag 2 of decompressfile (archive modification times) |
Accepted and ignored |
| OQ-WEB-9 | Argument of onReceiveData of a TSocket and the limit of unread data |
The bytes of the read; over 1 MiB of unread data the connection is closed |
| OQ-WEB-11 | Range list format of isipinranges beyond *.*.*.* |
Octet patterns (*, number, low-high) and CIDR blocks, separated by commas, semicolons or spaces |
World and Objects
Section titled “World and Objects”| ID | Question | Provisional behavior |
|---|---|---|
| OQ-WORLD-1 | Character box size and origin | Resolved (Ruan, 2026-10-26, legacy layout): the gani area is 48x48 px (3x3 tiles) from x, y; the body is 2x2 tiles at x + 0.5 .. x + 2.5, y + 1 .. y + 3 (center x + 1.5, y + 2); the walking footprint is its lower half, y + 2 .. y + 3 |
| OQ-WORLD-2 | Which tile layer gives the tile type | Highest layer with a tile |
| OQ-WORLD-3 | Does onwall include NPC shapes? |
Yes |
| OQ-WORLD-4 | noplayeronwall meaning |
Player ignores walls |
| OQ-WORLD-5 | Sides of addtiledef and addtiledef2 |
Server calls replicate; client calls are local |
| OQ-WORLD-6 | Is onLevelLoaded raised on the level’s NPCs? |
Yes |
| OQ-WORLD-7 | Player coordinates and player.level on gmaps; names of world-coordinate fields |
Sub-level relative; gmapx, gmapy |
| OQ-WORLD-8 | Script-visible type names of players and NPCs (objecttype()) |
TServerPlayer/TPlayer, TServerNPC/TClientNPC |
| OQ-WORLD-11 | Behavior of TParticleObject, TInputBuffer, TNamedObject |
Stubs until confirmed |
| OQ-WORLD-12 | Does findnpc find named level NPCs? Are names case-insensitive? |
Yes; yes |
| OQ-WORLD-13 | Receivers and client forms of addweapon, removeweapon, hasweapon |
Server, on the player in scope |
| OQ-WORLD-14 | Does selecting a weapon hide - weapons? |
Yes |
| OQ-WORLD-15 | onDestroy versus onRemoved |
§9.2 |
| OQ-WORLD-16 | Receivers and arguments of onPlayerLogin and onPlayerLogout |
Every server script (DB NPCs, level and local NPCs, weapons), with the player object (decided by the user) |
| OQ-WORLD-17 | onRCChat routing |
Unhandled / commands to DB NPCs |
| OQ-WORLD-18 | findobject and callnpc |
Any named object; event call by NPC id |
| OQ-WORLD-19 | setshape types and default blocking of NPCs with images |
Type 1 only; image size blocks |
| OQ-WORLD-20 | Does onPlayerTouchsMe repeat while touching? |
Only when contact starts again |
| OQ-WORLD-21 | move option bits, warpto limits, message versus chat |
§11.4 |
| OQ-WORLD-22 | canwarp and canwarp2 effect |
Follows a fan-made game server, not a probe |
| OQ-WORLD-23 | Projectile hit events | §12.1 |
| OQ-WORLD-25 | Walking speed, hole behavior | §13 |
| OQ-WORLD-26 | Grabbing and lifting tile objects | Not part of the engine |
| OQ-WORLD-28 | Sides and effect of loadmap |
§3.5a |
| OQ-WORLD-27 | Unstick command and its options | RC and chat command /unstickme warps to the configured place |
| OQ-WORLD-29 | What players holds outside level NPCs |
Every online player |
| OQ-WORLD-30 | Does a server NPC hold colors as a five-element array before showcharacter, and with which defaults? |
showcharacter creates it with orange, white, blue, red, black; before that an index write does nothing |
| OQ-WORLD-31 | Does reading player.colors[0] give a name or an index, and is player.colors[0] = "orange"; allowed on both sides? |
An index; names and indexes are both written, on the server and in client scripts |
| OQ-WORLD-34 | What the optional third argument of getnearestplayers(x, y, n) does |
Accepted and ignored: probes with 1 and 100 and two players on the same point gave {0, 1} both times |
| OQ-WORLD-35 | getmappartfile(col, row) of a level inside a gmap (the legacy probe level was in none) |
The name at the cell, empty off the map, fractions floored |
| OQ-WORLD-202 | Arguments of setz |
setz takes the corner heights top left, top right, bottom left, bottom right |
| OQ-WORLD-203 | What the map and tile definition functions return | getmapx and getmapy give the column and row of the level in the world map, -1 when it is not on it; removetiledefs(start) forgets the definitions and overlays whose prefix starts with start; gettilesettype is the number of the tile type table |
| OQ-WORLD-205 | Level flags | tilelayercount runs from 1 to 8 |
| OQ-WORLD-207 | Projectile list, reflectarrow, and removearrow |
Indexes are positions among the projectiles in flight in the level, in shooting order; reflecting adds half a turn to the angle; a shot of another player has no fromplayer and its fromplayerid is -1 |
| OQ-WORLD-209 | Client-side NPC fields (layer, sprite, isblockingprojectiles, save, peltwith*) and the local calls |
Local to the client and never sent; isblockingprojectiles true; peltwith* false; save ten zeros; timereverywhere, setbow, and the canbe marks are kept and not acted on |
| OQ-WORLD-210 | Tile layer style | Red, green, blue, and alpha multiply the tiles; x and y shift the layer in pixels; z is kept and not drawn; offset is the text x,y,z |
| OQ-WORLD-211 | Gani objects | player.ani reads as the gani name and compares equal to it; changes to loop, continuous, and setbackto apply to every later play on this client; movie is a flag set by the script over the file’s own answer |
| OQ-WORLD-212 | Scene variables | gravity 9.8, waterheight 0, watercolorflags 4 (six bits), preloadleveldefaulttile 0, drawallinsidenpcs false, weathereffectsenabled true, ghostsnear false; a script’s own field of the same name on an object wins over the setting; setminimap is remembered and not drawn |
Engine version 0.1.0. Built 2026-11-18.