Differences from legacy GS2
This engine knowingly differs from legacy GS2 in the places below. Turn on legacy_warnings to find the ones a script can reach. Behaviors that are not confirmed yet are listed in open questions.
Behavior that differs
Section titled “Behavior that differs”- String literals convert to lists. In legacy GS2,
"b" in "a,b,c"is false andfor (x : "a,b,c")runs zero times. Here a string literal behaves like the same text held in a variable: the test is true and the loop runs three times. Warning:W-LEGACY-DIFF-LITERAL-LIST. floor,ceil, androundgive correct results on the server. Legacy GS2 returned0there.- Draw order of show images on one layer is always the same, by index. It is not random.
formatfractionhas no trailing space, andformatpricekeeps the decimal part.- Ternary with
!.x ? y : !zworks without parentheses. - Frame rate. The client runs at up to 60 frames a second, not 20. The shortest timer is one frame on the client (about 0.0167 seconds) and one tick on the server (0.02 seconds at the default rate), not 0.05 seconds.
- Timer accuracy. The slack of the older scheduler is not reproduced.
setTimer(0.1)andscheduleevent(0.1)run as close to the requested delay as a tick or frame allows. - Limits and checks that older servers did not have. A
requestsqlruns one statement, so a script that sendsA; Bgetsmultiple statements are not allowed. File paths that contain..or start at the root are refused even when harmless, and so are Windows device names and names that end in a dot or a space. There are caps on pending SQL and web requests for each object. PlainVACUUMis not available in SQL. Scripts only reach the folders and hosts the server lists. - GS1 code is never run. Old character property codes (
setcharprop) are not supported and are reported in the RC chat. - Accepted where legacy GS2 rejects (verified on a legacy server). Legacy scripts never use these, so they cost no compatibility:
- keywords in any case (
IF,Function) and built-in function names in any case (Abs(-2); legacy finds onlyabs, andechoin any case); - unknown escapes such as
\q; - object names in any case:
isobject("ruannpc")and the plain nameruannpcfind the NPCRuanNPC(legacy: exact case only); - a plain call of a function value held in a script-global variable;
- an initializer block on a
newwhose result is assigned (temp.o = new T() { ... }); try/catch/finally/throw,strpos(legacy:.pos), androundon the server (legacy:Math.roundon the client only).
- keywords in any case (
- Loop limit. Legacy GS2 stops a run after about 10,000 loop iterations (nested loops counted together). The limit here is 1,000,000 for each uninterrupted run. Change it with the Server Option
script_loop_limit. - No built-in stats.
hearts,maxhearts,rupees,gralats,bombs,arrows,apandmpdo not exist, and nothing shows hearts over a player. Keep your own numbers inplayer.flags or your own variables and draw them with GUI controls (see the default systems page of the admin guide).
What the engine adds
Section titled “What the engine adds”These names cannot collide with older scripts, and each is listed in the API reference:
===and!==,typeof;try,catch,finally,throw;asyncandawait;- regular expressions and JavaScript-style array methods;
- native A* path finding;
formatpriceandformatfraction;- the event
onJoinedClassUpdatedand the frame eventonFixedUpdate; - the
recursiveoption ofsavejsontostring; - parameter binding for SQL and the
columnsfield of SQL requests; - the optional type annotations of the editor (type annotations);
- the engine has no built-in stats, combat, items, or HUD, so legacy switches for them do not exist (default game systems).
What did not change
Section titled “What did not change”Names, grammar, and run-time behavior that older scripts rely on are kept, including the quirks in compatibility quirks. When a rule here says “verified”, it was checked against a running older server. When it says provisional, see open questions.
Engine version 0.1.0. Built 2026-11-18.