Note: this is a draft!
Updated: sep 27, 2026
- New icons
fbfcc87da8 - Custom logo for quest package export
13030cb8a1 - Custom title music for quest package export
705d14b31d - SCC for 'Trigger Combo Copycat', allows triggering a triggers-tab copycat index
bcf7b98cee - Slidy Ice for the Player
a923d5c425 - 'Toggle Darkness' trigger flag (toggles current room being a dark room)
ff6c8151e9 - 'Req. Darkness' / 'Req. No Darkness' trigger flags; act as conditionals on a room being dark or not
dae41c8c72 - Trigger flags relating to LItems (map,compass,etc)
42b835781f - Trigger options relating to tinting the palette
4917cea2d2 - Trigger options relating to changing palette and wavy/quake vfx
9220affe4a - Trigger options relating to status effects and 'Push->' timing
3ee3da8573 - Add Cure Shield Jinx to bottles
1846747289 - Add shield effect for jinxes, update Whisp Ring
97688da502Jinx enemies (aka Bubbles) can now impact shields, and whisp rings now correctly apply to temporary jinxes.
See
docs/enemies.txtfor how to configure Jinx enemies. - Add shield jinx removal as refill effect
977e72321f - Add Shield Jinx trigger
985904538f - Expand palette from 6-bit to 8-bit color
4fccd75658The RGB channels for colors have been increased to full RGB color range of 0-255, rather than 0-63. This increases the number of possible colors that palettes can use by 64x.
This also impacts how colors are declared in ZScript, such as for
Graphics->Tint,Graphics->MonochromeHueandcombodata::TrigTintR/G/B. A script compat QR is added for existing quests that use 6-bit colors.A minor side effect of this change that applies for all quests is that palette effects, such as the fade in/out screen transitions and the death animation, are now smoother as there are more possible colors to animate through.
- Add configurable weapon sfx to enemies
e71f8dc99eThis can also be configured in ZScript with
npc->WeaponSFXandnpcdata->WeaponSFX. - Fully configurable enemy weapons
36f92c7bfcThe enemy editor now allows you to configure additional things for the weapon that the enemy fires. These used to be hardcoded based on the weapon type, but now all these are configurable per-enemy:
- damage
- speed
- block flags (ignores player defense / shields / reflectable)
- movement flags (gravity / pitfalls / drownable)
- tile size and hit / draw offsets
- burning sprites and light radius
- Make the special sfx of enemy weapons configurable too
9fd9f4a3dfSome weapon types, like boomerangs and bombs, have a secondary sfx that was hardcoded. You can now configure them in the enemy editor.
- Add enemy types to zinfo
d2ed2627e0 - Lift glove flag to drop objects when hit
73ceca28c5 - 'Cycle to Screen Undercombo' combo animation flag
577e115bdd - Add Misc SFX when the Hero lands on the ground
57c43d98d6 - Attribute 10 now used for hop height for vires/polsvoice
6ffb117532 - Per-combo player landing sfx
29e5a0e08cThe MiscSFX landing SFX plays if none is set.
- Pushblocks can drown (on a QR)
f3ffe8e741 - Combo-specific falling/drowning sprites/sfx for pushblocks
b8a2c17e91 - Trigger flag 'Apply Discount', allows wealth medal discount to apply to trigger counter costs
7ffb361135 - 'Light Wave' effect for dark room lights
b46b96c183Makes the lights increase and decrease radius in a sine wave pattern, with a specified rate and size. Lantern items have a checkbox to ignore this effect.
- Z3 scrolling regions
6b5e98dd70Regions are a collection of screens that are stitched together to become one playing area that the player can move around in, with the viewport moving to track the player. All mechanics of ZC have been updated to support that there can now be multiple active screens. Additionally, there is a new DMap option to reclaim 160 more pixels in height for the visible playing field (making the passive subscreen draw over it). There is also scripting support for configuring regions and the viewport.
Here is a guide covering what quest makers need to know about regions.
- Pushblocks can "fall" in sideview gravity
89adebef37 - Add 'Layer' property to FFCs (ignored for 'Overhead' ffcs)
5e270db775 - Add "screen load" combo trigger
4e750bc071 - Lifted combos specify glow shape / radius
e74cc26d8a - Special subscreen counters for button item costs
3b90a03303 - New subscreen widget, 'Counter Percentage Bar'
64bc639c72Draws a rectangle of two colors, based on the percentage of a specified counter. Useful for a life/magic meter that doesn't change size as the max changes, but instead gets denser.
- Subscreen minimap compass can point to any LItem instead of just McGuffin
963e0a4ba7 - Subscreen widget conditionals
474322fb17 - Add 3 custom LItems
5b8bc576ad - Allow any item to grant LItems on pickup (for any level)
2ee9dac5c7 - 'Level Keys' can be for a specific level
db256905e5 - multiple triggers per combo
56e9081285- Each combo can have anywhere between 0-255 combo triggers. Only the used triggers take up space (in memory or qst).
- The triggers are checked in order, so if the same combo has multiple triggers with the same cause, they will run in the specified order.
- If in such a case, the combo is changed while there are still triggers remaining, the extra triggers will NOT be executed - the execution halts when the combo is altered.
- Editable string Label for each trigger, used in the display name in the combo editor list
- Script access. The old access should all still work, accessing the combo's first trigger. Access for new triggers uses the new
combotriggerdatatype. Screen->TriggerCombo()can specify trigger index- The 'Only Gen Triggers' flag is now part of combos instead of triggers, so has separate access (
combodata->OnlyGenTriggers) combodata->GetTrigger()to get a specific trigger by its label (invalid names safely return a null value)
- Swords use second item editor sound for beam sound
4c63cff50d - Editable MoveFlags for items/lweapons in Item Editor
7cefc064b9 - A bunch of new combo trigger stuff
2f114cb239- longer timer triggers
- triggers can be conditional on LevelStates and GlobalStates in either direction
- triggers can un-set an ExState or ExDoor
- triggers can use "special counters" (like the subscreen, most importantly the "Any Keys")
- Triggers can play strings. Also they can do a different string (and different button prompt) if their "conditions" currently fail.
- The "screen load" trigger is now recursive- so if a "screen load" trigger changes the combo to another combo with a "screen load" trigger that will trigger too.
- The ability to make the player jump. (Or well, to set the player's Jump value, so it could work for like, a fan slowly blowing you into the air, or to shove you down towards the ground with negatives)
- The conditional to only trigger if the player is "standing", or "not standing" (works for sideview as well)
- The conditional to only trigger if the player's Z value is
>=or<a set value. - GUI re-organization and cleanup for the trigger GUI
- Allow an 'active shield' to have a specified button that activates it
726205f97f - Set bottle contents in Init Data / Cheat Menu
7bf318ba0f - Conveyor flag to affect airborne entities
11f8b8704aWorks exactly like the screen flag "Combos affect Midair Hero", but specified on the conveyor itself.
- "Only Visible In Editor" combo flag
629ba74509 - Even more combo trigger features
89c5876ef2- hero facing direction conditional
- counter "percentage" / "gradual" flags
- copycat "no cause" flag
- "Land Here->"/"Land Anywhere->" causes
- Move (teleport) Player effects
- Player position / jump speed conditionals
- combo type specific causes (currently only pitfalls/liquid)
- "Load Level Palette" effect can now use "-2" to load the current screen's "Editor F4 Palette"
- Standardized 'weapon data' settings for items/enemies/lifting
b43e006d74 - "No Collision When Still" weapon flag
edb610c735Useful for weapons that lay on the ground and can be lifted/thrown
- QR to allow autorotated weapons to use right-facing sprite params
d3859e27b9 - Weapon pierce count
9fbc37a01c - QR for "Weapons Cannot Stunlock Enemies (ignore)"
3a70ecb2afLike the existing no stunlock rule, stops stunned enemies from being hit. Unlike the existing rule, enemies IGNORE instead of BLOCK the weapon. The existing QR was renamed adding "(block)" to the end to differentiate.
- Allow 'walk on top' for all combos, not just Switch Block combos
e92a4899f8 - Combo Trigger force ice physics / set player facing dir effects
eb4dd3928d - 'Enemies->Stay Dead' screen flag
3b12dcca93 - Expand 'noreset'/'nocarryover' to all screen states
aa38836b1f - Exstate carryover/reset options
e95b860ec6 - Expand mirror capabilities with reflect flags
0ce825dc2eMirrors can now reflect many more weapon types. Player shields can also now reflect LW and EW wind.
- 'Cutscene Effects' combo
0b4b32dd4dA combo designed to interface with triggers to allow a variety of special effects useful for cutscenes. Ex. 'Player Walk' mode forces the player to walk directly to the specified point (ignoring collision).
- Gravity Boots
960e00c524Coming in 3 varieties, these boots alter the Player's gravity and terminal velocity!
- 'Gravity Boots' just change them passively (can optionally be sideview-only)
- 'Gravity Up Boots' change it when holding 'Up' in sideview
- 'Gravity Down Boots' change it when holding 'Down' in sideview
- Roc's feather can subtract from player's jump after released
1b758c9f76 - Improved player jump/fall animation QR
ccc7c0e60e - Per-item cooldowns
00c21339e9 - Subscreen Widget - 'Gauge Piece: Item Cooldown' for visual display of cooldowns
f6e1e5a29c - 'Cooldown Ring' item type to modify all item cooldowns
67dbdacc3b - Subscreen Widget - 'Item Cooldown Text' for a simple text of the cooldown time
31d4772950 - Per-screen and per-DMap custom gravity
e2f856083a - Combo trigger to change screen's gravity
fbf9b65af8 - QR for armos/grave combos working on layers > 0
ffb8b92752 - Expand litems from 8 to 16, add zinfo for litems
3bc63dabcf - Set LevelStates in Init Data
4e356be6f5 - Combo flag "Step 'in front' in sideview"
198768b290Allows 'walking'/'standing'/'landing on' effects to occur when behind the player instead of under the player in sideview. Useful for, ex., a stream of running water (as background combos behind you) having walking/landing sfx for splashes.
- Add some customizable values related to timeout items
234085a7dacan customize the timeout duration, flicker duration on spawning, and the speed. can also customize a new feature, the duration it flickers before disappearing.
- Allow "dive under" solids, QR for player to draw under layer 1 while diving
d80084a4de - Add many new SCCs
c4ff8de1a0- CollectItem
- Delay
- ForceDelay
- KillHero
- Counter
- MaxCounter
- GoIfAnyScreenState
- GoIfGlobalState
- GoIfLevelItem
- GoIfLevelState
- GoIfScreenState
- GoIfSecrets
- GoIfScreenExState
- GoIfAnyScreenExState
- SetGlobalState
- SetLevelItem
- SetLevelState
- SetScreenExState
- SetAnyScreenExState
See https://docs.zquestclassic.com/tutorials/message_strings for details.
- Add SCCs for bottles and changing the portrait
7225481551- ChangeBottle
- GoIfBottle
- Portrait
- 'Map Subscreens'
753a530fffIf a Map Subscreen is assigned to a DMap, it will replace the map button map for that DMap.
- QR for map button closing the active subscreen
2eb04c2ad8 - Per-subscreen-page configurable buttons to change pages
2cee82f22bGives better control over how pages are cycled through.
- DMap 'Floor' value, floor conditional for subscreen widgets
0c95310f71DMaps now have a 'Floor' value (0-255). Subscreen widgets can have a list of floors set as a conditional, only appearing if the current floor is on the list.
- Counter/ButtonCounter subscreen widgets can show max value / fraction of max
67f34833f9 - More subscreen widget conditionals
530b991d5d - 'Visited' screen state no longer cares about DMap view map flag
f4472416e1Compat rule for old behavior
- Subscreen page transition mode for "current screen"
ac05d4e285Used on it's own, can create visual effects of transitioning to a copy of the current page. Used with 'Swap Map Subscreen', can go to whatever page the other subscreen type was previously on.
- Customizable save menus
92641e6231 - Trigger requirements for screen state/exstate (including other screens)
ae5ef3317c - Allow mirrors/prisms to work on FFCs
4076d99239NOTE: Does NOT work for light beams!
- New music system
25814a1e7fCombine enhanced music and MIDI into a single object, such that the enhanced music will be played if possible, falling back to the MIDI if the enhanced is blank or fails to load. Replaces enhanced music on DMaps, and MIDIs on DMaps, Screens, and SaveMenus. Adds Combo Trigger and SCC access to play music from these new objects, and similar access to change the MusicRefresh value (modifying when the engine will change the music back on you).
Overall, this should allow much better control of music, and much easier use of enhanced music. Common scripts like "Boss Music" can now be accomplished with a couple combos with the right triggers set up.
- remove combo 'attribytes' and 'attrishorts', expand 'attributes'
88ca703ab0- attribytes 0-7 are now attributes 8-15
- attrishorts 0-7 are now attributes 16-23
- attributes 0-3 are still 0-3, 4-7 are new
This will allow larger / negative / including-decimal-part values in some cases that would not allow them before.
- Increase max MIDIs to 512
b48e524bfdAlso increased MIDI title max length
- Upgrade to Allegro5 audio for sfx, bump max sfx to 1024
58486c3f4aThis changes the entire system for sfx playing on the backend; most importantly, this allows loading OGG sound effects.
- Increase Max Items (256 -> 1024)
1f397dc208Items can be added / deleted / re-ordered via the item editor list. Currently nothing will be updated for you when re-ordering (including deleting from the middle of the list), so take care when doing so.
- Enable native file dialog by default
ea0d20f1b3 - Minimap can draw visited rooms
6a8767682d - Expand max Sprite Data (256 -> 8192)
786f85b17c - Add new SCC: SetCurrentScreenD
5e8f9ad07f - Customizable player hitbox for item collection
a4f619394dAlso includes fix for item hitboxes being weird in general, so now modifying the size of item hitboxes should work MUCH cleaner.
- Dropdowns show more options at once
ce12c14ffe - Clicking the thin border of rclick menus no longer closes them
c3e81bc842This means opening an RClick menu and then instantly lclicking will no longer 'click off' of the menu, nor will it select an option.
- Spinning Tiles support '->ComboType Effects' and 'Only Gen Triggers'
b42be7c9e2 - Bouncing LWeapons
8a0c9938ffSet the bounce values in Weapon Data to allow a weapon to bounce when it lands on the ground.
- Weapons can ride conveyors (new flag)
d4e81a410fWeapons will move along conveyors similarly to items. 'Stunned While Moving' conveyors will zero the step speed of weapons.
- Add copy-to-clipboard button to window title bar
4cce0baab4 - Light Offsets
7f0cdccd8cAnything that casts light in new darkrooms can now have an offset applied. Offsets can be positive or negative, with positive moving the source of the light that many pixels in the direction the light is "facing". Offsets perpendicular to the facing direction are not currently supported.
- 'Block (Same Layer)' / 'Block (Any Layer)' triggers
27a04f1046These trigger when a pushblock is pushed onto the combo. 'Same Layer' version requires the block be on the same layer. These triggers both occur during the last moment BEFORE the block clicks into place (as a trigger on the same layer as the block would be deleted by the block clicking into place).
- Trigger conditions 'On Screen' / 'Off Screen'
13eddda591Conditions built specifically for regions, for detecting if the combo is within the viewport boundaries or not.
Comes with a 'Viewport Range' setting, allowing you to expand (or contract) the rectangle of the viewport used for the condition; ex. with a '16' range, something is only 'Off Screen' if it is >= 16 pixels out from the edge. With '-16', it would be 'Off Screen' even while it is still within 16px of the screen's edge.
- 'Chance' trigger condition
c832de843fSet a combo to have an N in M chance of its trigger actually happening. Useful to actually have randomness in trigger setups!
- Advanced SFX combo triggers
00003c0c2bAllow manipulating the specific Pan, Frequency, and Volume of played sfx, as well as looping SFX, stopping SFX, and not restarting an sfx (so, play it if it isn't already playing / change the pan/freq/vol values of it without restarting it)
- Absolute Combo/CSet change triggers
7ca5f23397Specify a specific combo or CSet, instead of only a relative change.
Swim->/Swim-> (Sensitive)triggers203fd3c6a3Exactly identical to
Step->/Step-> (Sensitive), except only triggers if you are currently 'swimming'.- 'Enemy Ambush' itemclass
e0a43f2e36When this item type either spawns, or is collected (based on a flag), it will spawn a specified number of enemies from a list (either randomly selected from the list, or exactly in order)
- Enemy flag for disabling enemy contact damage
fbeb93a5ca - Better Unsafe Ground flagging
bdf81beffb"Unsafe Ground" is renamed "Unsafe Ground (Sens)", as it is very sensitive
New flag "Unsafe Ground" is added, which is much less sensitive.
- Forced Hazard Respawn Points (triggers + scripts)
6f2adb1fab'Respawn Here' trigger sets the Hazard Respawn to the combo's position, and prevents it from being updated to safe ground automatically. 'Reset Respawn' trigger allows safe ground to automatically update it again. 'Hero->ForcedHazardRespawn' allows scripts to read/write the forced state.
- 'Screen Unload->' trigger
5aa4b4721fTriggers when the screen unloads; after warp effects for warps, but before scrolling for scrolls.
- Improved proximity triggers
3c2ad1e13f"Use S. Hitbox" option makes combo proximity use the center of the player's 'solidity hitbox' instead of their 'damage hitbox'. This centers it better on the player's feet for things like floor switches.
"Square Area" option makes the proximity be a square instead of a circle (checking each axis separately, rather than using a diagonal distance check)
Partial Consumecombo trigger for counters80d0b60228Allows the
Consume Amountto occur even if you don't have enough of it. Useful with...Is Percentfor ex.Consume 100%to empty a counter.- Improved Minimap Widget features
eccbe4e206Can now specify the Room BG and Unvisited colors per-widget. (Leaving these colors as the
Defaultcolor will use the misc colors as previously) Can now specify that room colors will draw even when a DMap-specific map tile is provided. Can also specify that the background will not draw at all (allowing drawing just the room colors, which can be used to place a transparent-bg minimap widget on top of some other graphic or something) - Add Camera cutscene effect to pan the camera
3f488fd008Adds a new "Camera" sub-effect to the Cutscene Effect combo type. When triggered via '->ComboType Effects', the camera smoothly pans to a target position, then fires 'ComboType Causes->' once it finishes.
Configurable options:
- Subtype: how the target position is interpreted
- Relative to Combo: offset from the combo's center
- Relative to Hero: offset from the Hero's position at trigger time
- Relative to Viewport: offset from the current viewport center
- Absolute: fixed coordinate in the region
- Return To Hero: no position; immediately returns to the Hero
- X/Y Position: the target offset or coordinate (per Subtype)
- Speed (px/frame): how fast the camera travels
- Idle time: frames to pause at the target before finishing
- Interpolation curve (Linear, EaseIn/Out/InOut, Smoothstep, Smootherstep, EaseOutCubic, EaseOutBack)
- Freeze: halt the game while the camera moves
- Return to Hero: pan back to the Hero after reaching the target
- Causes Mode: when 'ComboType Causes->' fires relative to the effect
- On Finish: after the entire effect ends
- Before Return: after idle frames, before the return pan
- Before Idle: after the pan arrives, before idle frames
'ComboType Causes->' is only fired if the combo hasn't changed since the effect started (guards against mid-effect edits). Camera movements can be chained by triggering another Camera combo from the causes trigger. Only has a visible effect inside scrolling regions large enough for the viewport to move.
If a script modifies the viewport target sprite, that sprite is used in place of the Hero for 'Relative to Hero' and 'Return to Hero'.
- Subtype: how the target position is interpreted
- 'Overhead' flag on all combos
9c8ade84ac - Add viewport suspend/despawn sprite variables
a25f1a55f1Sprites have a new
ViewportSuspendRangevariable controlling how far past the viewport edge they keep running scripts and movement before being suspended. Previously this was a hardcoded 48px (3-tile) buffer for eweapons and npcs, and 0 for everything else. Set it to 0 to disable suspending entirely (the sprite always stays active). Configurable on enemies, weapons, items and FFCs via the editor's new "Suspend Range" field, or on any sprite via script.Sprites also have a new
ViewportDespawnRangevariable (default 0, disabled) that, when set, removes the sprite once it travels that many pixels past the viewport edge. Configurable in the editor's new "Despawn Range" field, and on any sprite via scripts. When left at 0, each sprite type's normal off-screen handling still applies (weapons clip at the screen edge, enemies are killed when out of bounds, items are removed once well outside the region). - Trigger condition for exdoors
616a0a2797 - per-position states
3643d5c261This allows specific combo positions to remember changes between screen transitions. Each combo position and each ffc gets 8 states (0-7). The memory usage of this feature may add up if used excessively.
- FFC Flag for solidity based on the combo being solid or not
d460b968ddThe whole ffc will be either solid or not, based on if the combo has at least some solidity. Useful for FFCs changing via triggers.
- Summoner Improvements
a959db9840Enemies that Summon:
- now have consistent configurations for summon count between Walking and Wizzrobe types
- now allow configuring max enemy count
- now count specifically enemies that they have summoned when checking against max enemy count
- have a new flag to kill summoned enemies when they die (targeted ringleader effect)
Scripts now have '->SummonMinion()' and '->SummonMinionFromLayer()' to make an enemy summon other enemies. Scripts also have '->ParentSummoner' to set which enemy is considered the summoner of other enemies.
- Support passing args to RunFrozenGenericScript SCC
57591e2966DiscordThe "Run Frozen Generic Script" SCC can now pass up to 8 optional InitD arguments to the script it runs. The string editor exposes these on a new "Args" tab, labelled using the selected script's metadata.
- 'Large Combos' + large lifting
d9c1387490New General tab combo editor flags allow 'Large Combos', combining combos on the same layer that connect via these directions for certain features. Lifting can make use of this feature, allowing lifting groups of combos as single large objects.
- 'Large Combo' copycat triggers
96a121e6a6Allows combo triggers to interact with all combos in the same 'Large Combo' grouping as the combo being triggered. This allows ex. bombing one corner of a large rock to crack the entire thing.
- Weapon flag for carrying across screens
3065337e22weapons with this flag can be carried by the player across screen boundaries, even when QRs are set preventing carrying across screens normally.
- String flag 'No Freeze', makes a string NOT freeze action
0f28899d85 - Byrna invincibility
6f7f728c82 - Handle armos/graves with 'Large Combos' flags
fd10f657a5 - Allow decimal values for some SCC arguments
06dbd7afa3DiscordThis allows the full range of values for
Screen->D[]andInitD[]parameters. - Configure message more sprite per-string
07298c33d3each string can now have it's own 'more' sprite, and the 'more' sprite can be positioned relative to multiple points on the message box (ex. bottom-right) to allow better positioning options.
- Configure the delay before strings allow you to advance the text
75e800e54aConfigured once for all strings, default 50 frames.
- Message Strings can now scroll when too large for the box
17199000f7Scroll Up and Scroll Down icons can be configured per-string, similar to the 'More' icon.
By default, scrolling is 'freeform'- the textbox scrolls as more text is added, and when the text pauses waiting for player input, the player can press up/down to scroll through the text.
'Messages Scroll In Segments' QR changes this to instead scroll in segments. This breaks single large strings up into message-box-height tall segments that the player has to press to advance past each of, and scrolling back up through the segments scrolls segment-by-segment in chunks.
- More sfx configuration for strings
bd8f072734set sfx for menu choice changing, menu closing, and advancing to 'more' text.
- QR to disable F6 entirely
8292cc5ff5No popups, warnings, or anything else; F6 will just do nothing with this on. The 'End Game' menu option is also greyed out by this.
- Publish a universal mac app supporting Apple Silicon and Intel
fc1cb83cc2The mac release is now a single universal dmg, named
{version}-mac-universal.dmginstead of{version}-mac.dmg(which was Intel-only). Apple Silicon users no longer run under Rosetta, which also means ZScript runs on the native JIT backend instead of a translated x86 one.
- New logo and song to file select screen
ee916ab45b - Add option to disable title music
9256d13d97 - Optimize ZASM scripts
16da940b1fFirst thing when loading a quest the ZASM scripts will undergo optimizations. Most optimization passes apply improvements similar to that which have been implemented in the ZScript compiler, but are not present in older quest scripts. Others are novel and improve even modern ZScript compiler output.
Savings for a few quests:
- Stellar Seas - 163762 ops (5%)
- Yuurad - 604668 ops (4%)
- Umbral Cloud - 105994 ops (8%)
The optimizations done currently are:
- Removing unreachable blocks of code
- Replace many PUSH/POP with equivalent single PUSHARGSR/POPARGS
- Reduce ops used for conditionals (COMPARER)
This is on by default, but can be disabled with
[ZScript] optimize_zasm = 0inzc.cfg. - Add ZASM optimize_setv_pushr
f2dd0314e7 - Optimize comparison commands in ZASM
419aac8040 - Optimize scripts just before use, instead of all upfront
bf32e9105e - In optimizer, consider the null D5 register when combining commands like POP
0c5bc072b3 - Optimize old scripts LOADI to LOADD
1d7fa6a48dThis removes ~8% of commands from Yuurand, ~12% from Nargad, and ~14% from Stellar Seas.
- Optimize useless stack push/pops in old scripts
a273d27c3aThis saves 15% of instructions for Yuurand.
- Add simple titlescreen, and remove music from save select screen
a593e75715This also reintroduces the
skip_titleoption in the launcher. - Continue ZASM comparison reduction even on LOAD D2
e20f62d4d4At some point this was necessary, but not anymore.
- Improve inference in optimizer simulator, and handle POP better
0a7117ba26 - Improve ZASM comparison when subsequent block reuses D2
cac709f3d0 - Optimize SETR PUSHR to just PUSHR
4429211711 - Optimize ZASM pass converting to new function calls
d40c0d6344Replaces older GOTO/GOTOR and GOTO/RETURN with more succinct CALLFUNC/RETURNFUNC.
This saved ~2.5% of instructions in Yuurand, ~4% in Nargads Trail.
- Optimize ZASM by inlining functions
86edb55fbf - Optimize old scripts STOREI to STORED
da7113489f - Optimize LOADD/STORED to new LOAD/STORE to remove divisions
d8a7872c8b - Optimize ZASM by removing intermediate registers
dddd96cf11- For example,
SETR D3 LINKX ; TRACER D3becomesTRACER LINKX - Also attempts to avoid pushing value to stack just to pop later, but only if the value of the register is unmodified in the original code between pushing and popping from the stack
- Only occurs if the register is read once. If read twice, the overhead
of calling
get_registeris too great so it would be worse to call multiple times. Data registers are much faster to access.
- For example,
- 'Toggle Lights' cheat works on new dark rooms
1f74bdc0a2 - Show bottom 8 pixels by default for most quests made prior to 2.55.9
86b88dff9c - Enable ZASM optimizer
119445961bScript heavy quests are known to run 2x more efficiently with this enabled.
- Add -frame-timings CLI switch to log expensive frames
543415d80c - Revamp drawing code
3ee61b001c- ffcs and script draws can be negative-layered
- sprite Z-sort and optional Y-sort
- z-thresholds for each layer, allowing sprites to "jump through" layers as their Z increases
- weapon animation code is no longer done during weapon drawing (also fixes weapon shadow draw timing)
- generally cleaner code
- some minor graphical fixes
- Update volume dialog
45c0e73328 - "Temp Ignore Solids" weapon flag
cd73a16070Causes a weapon to ignore solids for the 'Break on Solid' / 'Stop on Solid' flags. Un-sets itself as soon as the weapon is NOT touching a solid. Using this flag on a solid shooter combo will prevent the shooter itself from killing its shots.
- Minimap 'visited' rooms use visited state instead of charted
e21f55a9fbMinimaps will use the Visited screen state (saved per-screen) rather than the Charted state (saved per DMap) to determine if the room has been visited now. QR for the old behavior will be enabled for old quests.
- (QR) allow jumping while charging charge attacks
855e635a2e - Improve map view screen state and trigger handling
d42ecd9653Discord- The map view now correctly applies all screen state changes, including switches and screen load triggers.
- Added new trigger conditions: "Map View Only" and "Map View Never", allowing triggers to run exclusively in the map view or be excluded from it.
- Add CRT display filters
41ac56899dTwo optional display filters that recreate the look of a CRT screen, under
Settings > Options > CRT Filter:- Flat (crt-easymode): Lanczos sampling, brightness-adaptive scanlines, and an RGB aperture grille.
- Curved (crt-geom): barrel distortion, rounded corners, beam-profile scanlines, and a dot mask. Mouse input for gameplay is warped to match, so clicking on the curved image hits what it looks like it hits.
Both are ports of shaders distributed by the libretro project (GPL, like ZQuest Classic). The filter applies only to the game layer - menus, dialogs, and the pause-dimming overlay stay crisp and work as before. On the web version the game renders at full device resolution while a filter is active, so scanlines stay even instead of dissolving into moire.
Also, the text overlay (fps, game time, PAUSED) now scales with the game area, so it reads the same size at any window size.
- Give the title screen an animated sword intro
ca9cc641aaThe logo crawls up over a blue background instead of black, without its sword; the sword then thrusts in from the left with a rising woosh and slots home through the letters with a white flash and sfx on impact.
- Find a save file's quest by its contents when the path fails
3386fefa9aSave files now record a fingerprint of their quest file. If the recorded path no longer resolves - even after searching by file name - the quest directory is searched for a file with the same contents, so the quest can be found even after being renamed. A content match is preferred over a file name match, since a different quest file could share the name.
- New song to ambient music menu
47c8bf62ae - Save backup when qst was last saved in a different version of ZC
d9a81183a4 - 'Adv. Paste' string editor rclick option
bd40c292c6 - Advanced Paste for Item Editor
138b58626e - 'Warp Back' rclick option to reverse after following a warp
8dd981f272 - Assign 'notes' per-screen (just for editor use)
Relevant changes:
- feat(zq): 'Set Default' button to set default editbox colors
e9e8b112de - feat(zq): 'Goto' button in 'Browse Notes' to go to a notes' screen
9bd560f937
- feat(zq): 'Set Default' button to set default editbox colors
- Add help text to the FFC editor
a4030cac36 - Zoom out to edit many screens at the same time
6fd217ecb0It is now possible to zoom out when editing map screens, up to the size of the entire map (although 4x4 screens is roughly the last usable zoom level).
Ctrl/Cmd + -/+is the shortcut to zoom out and in. Note that this replaces an existing shortcut for modifying the screen palette by 16 - that is nowShift + Ctrl/Cmd + -/+.Arrow keys change the current screen as usual (and so updates all the screen-specific UI, like enemies/warps/the Screen menu). If you move beyond the current viewport, the viewport moves along with you.
Clicking on any visible screen will also set the current screen.
Should be able to perform any action as expected on screens when zoomed out: copying, pasting, ffcs, moving items, warp squares, all drawing modes, flood fill, editing layers, etc.
The undo/redo system works as well.
There are a few new options related to this feature, under the View menu.
- Check/Uncheck/Toggle All buttons for checklist dialogs (ex. adv paste)
6d35395d3b - Add 'Alphabetized' checkbox to basic listers (item,enemy,sfx,midi,subscrwidget)
0a10202e22 - Add '(000)' after '(None)' in some lists, allowing typing '0' to skip to it
94fa4ce00f - Add descriptive labels and dropdowns to walker type attributes in enemy editor
e5cf4d4dab - 'Drag Squares From Center' option, for FFCs/warp squares/etc
4028184ffd Tools->FixTools->GreenArrival Square Fixe07947d77cAllows you to clear out all the green arrival squares in your quest (and optionally turn them into blue squares)
- Add
quests/examples/trigger_example.qst2e886e3e14 - 'default level palette' for each map / 'Quest->Map Settings'
2aaeb01862 - Combo trigger 'Summarize' button
1c1e78608bDescribes the details of a combo trigger in a short summary, so you don't need to look through every tab just to figure out what it does.
- Support updating existing SCCs in string editor
ca3cd72fa1 - Show warnings in string editor
023f961c75 - Subscreen wizard for 'Tile Map Grid'
379598106ePlaces a set of Tile Block widgets, designed to help make custom Maps. The different Tile Blocks can have different conditionals, so that some appear when you have the dungeon map, and others appear only when you've visited the appropriate screens.
- Render screen editor in multiple palettes, higher resolution
d7438d4f3bThe screen editor can now render multiple screens in different palettes at the same time. It also renders at a much higher resolution. This makes the zoom out feature much better.
In case there are any regressions, this can be disabled via in the View menu: just uncheck "High Quality Screen Rendering".
- Add history navigation for viewed screens
7b0e5333d2You can now navigate recently viewed screens by using the side buttons on the mouse, or configuring the "Go back/forward" hotkeys.
- Ffc placement / rclick improvements
21c410715f - Upgrade 'Layers' dialog
c0ab222c73 - Upgrade "Freeform Combos" dialog
7132bc16de - QR 'Weapons Better Screen Edge Hitbox'
f7aad5f501causes weapons to not die from reaching the edge of the screen until the weapon is actually off-screen.
- Subscreen editor grid can now draw lines instead of dots
646aa2b7d6also upgraded the dialog for editing the subscreen grid
- 'Open Tile Page' directly from combos/ffcs onscreen
f386d05ead - 'Copy Info' button
1debd3b39eCopy Info from any info popup directly to your clipboard
- 'Compare QR String' button
6d820c1757Using a QR string copied from a quest, easily see what QRs your quest has set differently.
- Update 'Help' dialog
ece0ae1c6a - Combo trigger copy/paste uses system clipboard + json
fcd5ac70ce - Improve string preview; scrolling + portraits + positioning
799705d09fThe string editor preview now previews the positioning and portrait of the string. Portrait change SCCs are not previewed. Scrolling strings can preview the scroll via scrollwheel and a new scrollbar.
- Improve misalign arrows
64e84f625eThe arrows drawn by 'Show Misaligns' now act smarter; they will no longer show misaligns within regions, or for screen edges with a non-scrolling type sidewarp set. Scrolling-type sidewarps will show arrows based on the warp destination screen. Invalid (blued-out) screens now act as "fully solid" for misalign arrows- so solid boundaries preventing you from entering invalid screens no longer draw arrows, and open walkways into invalid sceens now draw arrows.
- Warn in the enemy editor when "Hardcoded BS Patras" QR is enabled
c525a0e74bDiscordWhen editing a Patra with the 'Hardcoded BS Patras' compat QR enabled, the enemy editor now shows a warning that 2x2 Patras will be hardcoded, ignoring most editor settings (including all firing attributes and inner eye placement).
- Ctrl+Click Color Swatches uses previous color
d076e3e217This mimics how Ctrl+Click works for Tile/Combo swatches, but now for colors. Should be especially useful when setting up the same color repeatedly in places such as Save Menus.
- Convert newlines to
\Newline\when pasting into string editorc97712f911DiscordPasting multi-line text into the string editor used to insert raw newline characters, which display as
^in the text field. Now newlines become\Newline\commands and carriage returns are stripped.
- Allow mathematical range expressions [A,B) etc
61c5ccc923 - Range loops (
loop(int q : 0=..10))Relevant changes:
- feat(zscript): range loops can contain variables in ranges/increment, and negative increments
cb583e1c41 - feat(zscript): range loops have '@NoOverflow()' annotation, docs
ded10db593
- feat(zscript): range loops can contain variables in ranges/increment, and negative increments
- Allow multiple comma-delimited increment statements in for loops
ab8232c783 - Allow enums of non-int pre-existing types (ex.
long)9ca034ea19 - Add networking via websockets
41c3622a43WebSockets allow for scripts to communicate with an external WebSocket server. This introduces an official way to use the network in ZScript.
The following example script communicates to a freely hosted WebSocket server, which simply responds back with the messages it receives.
To make your own WebSocket server, Python is a good option. Some example libraries:
#include "std.zh" generic script WebSocketScript { void run() { printf("Connecting to websocket.\n"); websocket ws = Game->LoadWebSocket("ws://ws.ifelse.io"); ws->Own(); bool hasSentMessage = false; while (true) { if (ws->State == WEBSOCKET_STATE_CONNECTING) { Waitframe(); continue; } else if (ws->State == WEBSOCKET_STATE_CLOSED) { char32 error[0]; ws->GetError(error); printf("Failed to connect: %s\n", error); break; } if (ws->State != WEBSOCKET_STATE_OPEN) { printf("Failed to connect: %l\n", ws->State); break; } if (!hasSentMessage) { printf("Connected!\n"); ws->Send("hello world!"); ws->Send("domo arigato!", WEBSOCKET_MESSAGE_TYPE_BINARY); hasSentMessage = true; } while (ws->HasMessage) { int message_ptr = ws->Receive(); int type = ws->MessageType; if (type == WEBSOCKET_MESSAGE_TYPE_TEXT) printf("got text message: %s\n", message_ptr); else if (type == WEBSOCKET_MESSAGE_TYPE_BINARY) { int len = SizeOfArray(message_ptr); printf("got binary message of length: %d\n", len); for (int i = 0; i < len; ++i) printf("%d: %l\n", i, message_ptr[i]); } else printf("got message, but with unknown type: %l\n", type); } Waitframe(); } } }
- 'atol' (string to long)
475cac6ce3 - Add template types to some internal functions
633d754718The following internal functions have switched from using
untypedto template types:void ArrayPushBack(T[] arr, T val) void ArrayPushFront(T[] arr, T val) void ArrayPushAt(T[] arr, T val, int index) T ArrayPopBack(T[] arr) T ArrayPopFront(T[] arr) T ArrayPopAt(T[] arr) void ArrayCopy(T[] dest, T[] src) int SizeOfArray(T[] arr) void ResizeArray(T[] arr, int sz) void OwnArray(T[] arr) void DestroyArray(T[] arr) void printfa(str* format, T[] args) void sprintfa(str* buf, str* format, T[] args) T Min(T arg1, T arg2, ...T rest) T Max(T arg1, T arg2, ...T rest) T Choose(T arg1, ...T rest)
This means that the type
Tmust match other occurrences ofTthroughout the entire signature, given the types of the parameters used by the callsite. For example, this code no longer compiles:printfa("hello %d", 1) // Second param is not an array Object objects[] = {new Object()}; ArrayPushBack(objects, 1) // Second param is not an Object int v = ArrayPopBack(objects) // Cannot convert Object to int
Note: for now,
SizeOfArrayandResizeArraystill allowchar32for their array parameters, since that is common for string operations and we don't have a formal string type yet. - Add garbage collector for automatic memory management
d4bc547f8eObjects created by scripts are now automatically deleted when they are no longer reachable from any script.
This removes needing to manually delete objects you create (either with the
deleteoperator orFree()), and mostly removes any reason to ever callOwn().See the new "Object Memory Management" section in ZScript_Additions.txt for further details.
- Arrays now are separately typed from non-arrays
cf2769fe95Array types can be declared by adding
[]. - Option 'OLD_ARRAY_TYPECASTING' to use old array type handling
d7555bf9e8 - Add LEGACY_ARRAYS option as more lenient approach to array syntax
caeb933574This replaces the
OLD_ARRAY_TYPECASTINGoption withLEGACY_ARRAYS. It can be set toon,off, orwarn, and defaults towarn. This option supports usage of deprecated syntax for arrays. This will continue to work:int arr = {1, 2}; Trace(arr[0]);- by default, this will warn that
int[] arris the preferred syntax - legacy arrays syntax is currently not allowed for objects that must be
free'd, such as custom classes or
bitmap(but, for example,lweaponis fine)
Additionally but independent of this option, parameter types are cast to/from arrays when resolving a function call. There was an existing feature that selects the function that required the fewest type casts, and this taps into that. For example, this code works:
void fnArray(int[] arr) {} void fnLegacyArray(int arr) {} ... int legacy_arr = {1}; fnArray(arr); // arr is cast to int[] int arr = {1}; fnLegacyArray(arr); // arr is cast to int - by default, this will warn that
- 'TileBlit' and 'ComboBlit', for drawing parts of tiles/combos
c874bc20ed - Webapp for exploring and sharing ZScript
ae2a67e77a - Add bottle cure shield jinx flag (
BTF_CURESHIELDJINX)63d0dba0c5 - Add
Game->Exit(), which closes the programaf90766952 - Add base
spriteclass9304859284The following classes now all share a common base class:
- eweapon
- lweapon
- ffc
- itemsprite
- npc
- player
All of these classes can now be assigned to variables of the type
sprite. Thespriteclass contains 40 properties that were duplicated across these classes. Some properties do not work for all classes (likeffcandplayer), but more support may come later. - Show source code context with error messages
fb4dbc83fe - Add
RepairShieldfunction to npcef15f9019c - Support setting
Hero->ScriptTileto draw larger than 1x17b8530979bInternally, the Hero sprite resets its
Extendproperty every frame, which prevented usingScriptTilein combination withTileWidthandTileHeight. Now,Extendis only reset ifScriptTileis not in use. @Incrementannotation for enums43003ca8c0Allows manually setting a value for the enum to increment by for each value
- Add
@Bitflagsenum annotationc089b2af15This annotation turns an enum into a bitflags enum:
- Auto-incrementing values starting at 1 and doubling the previous for each new enum member
- For type safety, bitwise operations on enum bitflags are only allowed with the same type
For example:
@Bitflags("int") // "long" is also supported enum SomeBitflags { Fast, Big, Loud, }; @Bitflags("int") enum OtherBitflags { Combo, Enemy, Weapon, }; auto x = Fast | Big; // inferred type is SomeBitflags if (x & Enemy) // Errors, scripter accidentally used the wrong enum. // ... - Add
sprite::SpawnScreenc9fbd48d7bThis is the screen that the sprite spawned on. In a non-scrolling region, this is the same as
Game->CurScreen. - Support expression in default parameters
d2dd3eebf5The default for optional parameters no longer need to be constant. For example, this is now valid:
void debug(int num, int x = Player->X, int y = Player->Y - 10) { // draw num at x, y ... } - Persist all reachable objects to save file
8cc79d2490GlobalObjectis no longer necessary to persist a custom object to save files. It is now enough to assign it to a global variable or array - as long as it uses the custom object type (rather thanintoruntyped).This includes all nested objects, and any object reachable from an object that was globalized via
GlobalObject.https://discord.com/channels/876899628556091432/1377446615178281190
Screen->ComboData[]to directly read thecombodatapointers of the positions on the screena69021df5d- Support
Game->LoadBitmapID(RT_*)134545e1bfThe render target constants
RT_*(except forRT_CURRENT) now work viaGame->LoadBitmapID(). Also mostly all drawing functions now accept bitmaps loaded in this way as parameters. - Automatic array/string management; improved internal arrays
4b40449cc8- arrays (which includes strings) are automatically freed by garbage collector when no longer used (if appropriately typed as an array)
- removed constraints for local arrays (no more
Temporary literals cannot be stored!). Can now return local arrays (and strings) from functions - internal arrays (like
Screen->D[]) can be used like any other array: assign to another variable, get the length withSizeOfArray, use w/forloops, etc. - arrays assigned to a global variable or otherwise reachable from a saved object always persist to the save file
- references to internal arrays expire when their engine object is
destroyed (ex, when a lweapon is destroyed, or when a new screen is
loaded); they also don't persist to the sav file (will just load as
NULL)
- Enable JIT script compilation by default
9f80b3d303This makes scripts much more efficient: between 2 - 10x.
Note: windows 32-bit is not supported.
- Customizable per-sprite gravity strength and terminal velocity
dab1c5d406 - Support negative indices for internal arrays
fae2ad2be6Some internal arrays would bound the index to force it to be valid, while others would instead error and give a default value. Now, indices are never bound, and instead if the index is negative it will "wrap around" to the end of the array, just like all other arrays do.
Previous behavior is available behind a compat QR.
npc->Flags[]array to access more enemy flags1a38b0065e- Add
messagedata::Segments[]036930bbcaThis exposes to scripts the parsed message string, which includes commands and escaped characters.
- Update WarpEx to not use weird array parameter
21390ba907 - Add debug data line mappings to compiler output
9b2cfd68e4With this, any trace or error from a script is now printed with a stack trace, showing what script file and line of code caused it.
- Add rich debugger
c7a2ccbb84See https://docs.zquestclassic.com/zscript/lang/debugger/ for details.
- Falsy-Coalescing (?:, ?:=) operator
4d0ea0fd73a ?: b==a ? a : ba ?:= b==unless (a) a = b; Audio->GetMusicData("Music Name")49608e7420ffc->ScreenFFCIndex17708d545c- Access to '*
weapon->PierceCount'fb65452a0b subscreendata->Open()/subscreendata->Close()c6bed9186cDirectly open an active subscreen, or via
this->Close()on an active subscreen script, close one. Equally works on map subscreens. Opening is delayed until the next moment the player could normally open the subscreen themselves.- Add
FileSystem->LoadFile, document "mode"11a3b8e3f1 - DrawMapdata
ecfab983e4Both Screen-> and bitmap-> versions available. Draws a mapdata pointer. Kind of like DrawLayer, but you can use a temporary mapdata to have it use temp changes from the current screen. Using a temp mapdata pointer that corresponds to an entire region will draw the entire region.
weapon->DisableTriggers,Hero->HammerPos1899b81feaScript ability to stop weapons from triggering triggers, and read the current state of the Hammer's swing.
ffc->Trigger()93d0807399allows scripts to trigger FFC combo triggers similar to 'Screen->TriggerCombo()'
Hero->TempStepBoost6f673c01edAn additive boost to the Hero's step speed, which resets every frame.
->DrawMiniTile()f3f39a23ddAllows drawing a quarter-tile directly to the screen or a bitmap.
- Add
Hero->RespawnDMapScreen08a84e777bSame as 'Hero->RespawnScreen', but accounting for DMap offset.
sprite->InvisibleTimer2b1c4fe7f3Deprecates 'Hero->Invisible'. Acts as an invisibility timer, allowing setting any sprite to be invisible for a specific number of frames.
sprite->NoCollisionTimer95d1df53e3Replaces ->CollDetection, acts similar to existing timer variables.
itemsprite->PickupExState+npc->DeathExState6584696e49These features already existed for combo trigger use, now they have script access as well; setting an exstate when an item is collected or an npc dies.
- Add some new special draw layers
78e3e79647- under player draw for draws below the player
- over lift weapon, for above both the player and their held object
- over prompt combo, for above the player, their held object, AND any prompt displaying above their head.
- Add comment toggle shortcut to the web playground
bc49a7e9d8Ctrl/Cmd+Shift + /now toggles line comments on the current selection in the ZScript web playground. - JIT-compile shift and bitwise script commands
2bbac4c1d1The JIT now compiles the bit-shift, bitwise-NOT and bitwise-XOR operations natively instead of falling back to the interpreter for each one, speeding up scripts that do bit manipulation.
- Strength-reduce power-of-two multiplies in the optimizer
5a1c0b6650The optimizer now turns a multiply by a power of two into a left shift (reg * 2^k -> reg << k), which the JIT compiles to a single shift instead of a 64-bit multiply plus a fixed-point divide.
- JIT-compile array access and allocation
bf15ec043aThe JIT now natively compiles script array element reads/writes, array allocation, and bulk array initialization instead of falling back to the interpreter for each one, which avoids a register-cache flush at every array operation. Array-access-heavy scripts run measurably faster - stellar_seas_randomizer.zplay is ~5% faster.
- Collapse array constant-initialization in the optimizer
e7726d749eThe ZASM optimizer now folds a run of per-element array writes into a single bulk array write. Older quests initialize arrays as a long sequence of individual element writes; this rewrites them to the compact form the modern compiler emits, cutting instruction count (e.g. -11% of all instructions in the stellar_seas randomizer) and avoiding per-element overhead in both the interpreter and the JIT.
This sped up stellar_seas_randomizer.zplay by ~11%.
- Measure time spent running scripts with -script-timings
31bcc69f23Launch the player with the -script-timings switch to profile how much time a quest's scripts spend in the scripting engine. When the game ends, a report is printed with the total scripting time and call count, the highest-cost scripts, and the slowest script-frames (-script-timings-top configures how many; default 20).
Documented at https://docs.zquestclassic.com/zscript/lang/debugger#profiling
- Stack objects are now saved
c46a8ed441Stacks referenced from global variables (directly or transitively) are now persisted to the save file and restored on load, like arrays and class objects - including which of their elements are objects, so reference counts reconstruct correctly. Previously a stack global was NULL after loading a save.
- The stack class is now generic -
stack<T>c2abe7fab2The stack class takes a type parameter:
stack<int>,stack<MyClass>,stack<int[]>. Typed stacks type-check pushed values, and return typed values from PopBack/PeekFront/Get etc, so no casts are needed. The type parameter is implicitlyuntypedwhen omitted, so plainstack(and all existing scripts) behave exactly as before. - @ExportInitD0 - @ExportInitD7
e8f9357639Using multiple annotations for one thing is a bit bulky. With this new annotation, specify all the information about an InitD at once! ex.
@ExportInitD0("Speed", "Movement Speed in px/frame")to specify a name + helptext. A 3rd parameter can be supplied to specify the field type. This combines@InitD0(),@InitDHelp0(), and@InitDType0()into a single annotation. - Native AArch64 JIT backend
489060ad94Scripts now compile to native code on arm64 (e.g. Apple Silicon macs) instead of always running in the interpreter, matching the speedup the x64 JIT already provides on x86-64.
- Add
npc::Parente5fe1c96fbDiscord - Script instance variables ('static' / 'nonstatic')
86fbc65139DiscordScript-scope variables can now be per-instance: every running copy of a script (each ffc, npc, item, ...) gets its own value. A
staticvariable instead holds a single value shared by all instances.Also,
staticnow works on class variables, not just class functions.ffc script Counter { static int spawns; // static variable - one value shared by every ffc nonstatic int frames; // script instance variable - separate value for each ffc void run() { spawns++; while (true) { update(); Waitframe(); } } nonstatic void update() { // Instance variables and `this` now work in any non-static // script function, not only `run()`. this->Data = ++frames; } }void run()is special: it is always an instance function (marking itstaticis an error), so it can callupdate()and use instance variables without needing thenonstatickeyword.Instance members are private to their script: other scripts cannot call a non-static function or read a non-static variable. Static members remain reachable from anywhere as
Counter.spawns. Instance variable initializers must be compile-time constants.Nothing changes for existing scripts. Whether script members default to static is controlled by the new
DEFAULT_STATIC_SCRIPT_MEMBERScompiler option, whose default (auto) currently resolves toon. Script-scoped variables default to static (unless explicitly markednonstatic), exactly as before. In a future version of the language,autowill flip tooff, making per-instance the default. To opt into that behavior today, set#option DEFAULT_STATIC_SCRIPT_MEMBERS offin a script (or file). For example:ffc script Counter { #option DEFAULT_STATIC_SCRIPT_MEMBERS off static int spawns; // static variable - one value shared by every ffc int frames; // script instance variable (not static) void run() { // ... } void update() { // ... } } @Exportscript variables, editable in the editor76b97b95eeDiscordAnnotate a script instance variable with
@Exportand its starting value becomes editable in the editor, on a new "Exports" tab besideInitD[]wherever the script is assigned (ffc, item, enemy, weapon, screen, DMap, ...). The variable's initializer is the default value; edited values get a reset button. This effectively lifts the 8-slotInitD[]limit.ffc script Spinner { @Export("Speed", "Rotation speed, in degrees per frame"), @ExportRange(1, 90) nonstatic int speed = 5; @Export("Clockwise?") nonstatic bool clockwise = true; // bools show as a checkbox void run() { // ... } }@Exporttakes a required label, plus optional help text (shown behind the field's '?' button) and input field type.@ExportRangekeeps the field within a min/max.- @ScriptInfo and @ScriptSetup annotations
c7f6da771bSpecify an info/description string and a setup instruction string for your scripts! These can be read in the Editor in the script setup dialog.
- Sprite-based special draw layers
f874360bf8SPLAYER_SPRITE_TARGET_UNDER,SPLAYER_SPRITE_TARGET_OVERallow drawing at a special draw timing under or over any specific sprite.Graphics->SpriteLayerTargetcontrols the sprite used by these special layers. It defaults to NULL, - Dispatch switch statements without walking a compare ladder
3ebe18df63Speeds up scripts built around large switch statements. Quests must be recompiled to benefit.
After recompiling, a switch-heavy benchmark ran about 24% faster interpreted; the JITs already dispatched switches well, so they see little change.
- Debugger breakpoints that pause when a value changes
f47b67abe4Right-click a variable in the debugger's Variables or Watch panel to add a breakpoint that pauses the game whenever that expression's value changes. Arrays and class instances are compared by their contents, so changing a single element triggers a pause. If the expression can't be resolved (e.g. a local variable that is out of scope), it is skipped until it resolves again - the last known value is still remembered.
When one triggers, the Breakpoints panel flashes it (line breakpoints flash too) and hovering it shows the old and new values.
- Annotations can use constants
fa0d835656 - Npc and npcdata 'WeaponSecondarySFX'
488183e049DiscordReads and writes an enemy's new 'Secondary Fire Sound' - the sound played when it fires a weapon other than its own, which today only the 'Fire Octo' death effect does.
- Collapse repeated script errors in the log and console
0c73deb5e6A script that errors the same way every frame used to write the same error message and stack trace to allegro.log and the ZScript console 60 times a second, which buried everything else.
Now an error identical to one already shown (same script, message and stack trace) is shown at most once every 300 frames (5 seconds). Repeats in between are counted: the count is shown the next time the error is shown, or on its own line once the error stops happening.
This is configurable in zc.cfg via
[ZScript] repeated_error_interval(in frames); 0 shows every error, as before.The debugger console still receives every error.
- Document symbol outline, hover tooltips and "Go to Definition"
dbd473b97aThis patch greatly enhances the capabilities of the language extension. New features are:
- A symbol outline of the current script, showing all variables, functions, classes, namespaces, etc.
- Tooltips on hover, shown if a variable/class/whatever was declared with a comment. This supports markdown
- "Go to Definition" to jump to where something is defined. You can right-click to see this option, or CTRL/CMD+click on something
- Support @link tags in hover tooltips
1430272d25Comments may contain inline links to other symbols with the
@linktag:// Better than {@link counter2} ... {@link counter2|that counter is lame} int counter1; // This also works as shorthand for links: [counter1] int counter2;
When hovering the mouse over any usage of
counter1, the tooltip will render these as clickable links that navigate you to the specified symbol. - Support Go To Definition for type of variable declaration
32d372e647 - Support Go To Definition for includes/imports
dffa4cf41a - Support Go-To-Definition for enums
c3ae6346b1 - Support Go To Definition for function return type
ea021739acAlso support tooltip showing up when hovering over declarations.
- Support 'Find all references'
e15861fc0cFor now, this is only able to list all references within the current file.
- Skip compiler codegen, not needed for extension
02786b32b5 - Add contextual autocomplete and function signature help
4683653438When typing, VS Code will now suggest relevant variables or functions. This suggestions are contextual, such that typing
Screen->will suggest only things on theScreenobject.If a function is selected, its parameters will be suggested as a snippet for easier completion.
Also new is 'function signature help', which allows pressing a keyboard shortcut (default is
ctrl/cmd + shift + space) to display a tooltip that describes the parameters of the function under the text cursor. - Add document highlight
867e93e3beWhen selecting a variable or function name, all instances within the current document that refer to the same symbol will be highlighted. Before, it would highlight everything with the same name, even if it was an unrelated variable in a different function / scope.
- Scan all ZScript files in workspace
1418595b9bThis collects all code completion suggestions at start by eagerly processing every ZScript file found in the current workspace.
- First pass on wasm JIT backend for web
08254299cbAdds a new backend to convert ZASM to WebAssembly. This also includes some utility methods for analyzing the structure (finding the functions) and control flow of a ZASM script, which was necessary to split ZASM scripts into multiple WebAssembly functions and implement the control flow of a ZASM script into WebAssembly structure control ops.
Although
prime.zsis ~10x faster, scripts from real quests aren't any faster than the normal ZASM interpreter, since a very naive and poorly performing method was used to transform the ZASM control flow graph.The utility methods for analyzing ZASM should be useful for improving the x64 backend too, for example, to similarly compile only one function at a time.
- Support more ZASM ops for wasm JIT
53d5bc9a77 - Support new SETCMP, GOTOCMP, CALLFUNC, RETURNFUNC ops in wasm
1c190a5a7b - Support loading quests from remote url
d9d6a5ed42See https://docs.zquestclassic.com/about/how-to-play#alternative-method-play-directly-in-the-browser
- Compile more ZASM commands in the JIT
df217bf662The wasm JIT deferred several common commands (ABS, AND/OR, MIN/MAX, FLOOR/CEILING, LOADI/STOREI, SUBV2) to the interpreter, paying a script-to-engine boundary crossing for every batch containing them. Compile them to wasm inline instead, matching the command coverage the x64 JIT already has. This speeds up scripts on the web version by a couple percent.
- Inline the hottest engine registers in the JIT
0edd9ce98cThe web JIT now reads and writes the most frequently used engine registers directly in compiled code instead of calling out to the engine each time. Quests using old-style array access run about 5% faster.
- Run scripts of quests using generic frozen scripts on the JIT
06d5f048bcQuests that use generic frozen scripts (for example stellar_seas or terror_of_necromancy) previously ran every script on the interpreter in the web version, because compiling them used to crash or desync - both since fixed. They now get the JIT, making script-heavy quests much faster: stellar_seas_randomizer's script time drops 6.2x (32.7s -> 5.3s over a 10000-frame replay), total engine time 2.35x (45.1s -> 19.2s), for a one-time 1.7s precompile at quest load.
- Compile scripts in parallel at quest load
9ae8b8ed98When the JIT is enabled on the web version, precompiling a quest's scripts blocked the main thread once per module. Script code generation now runs on background threads and every generated module is handed to the browser in one batch, which compiles them concurrently. Precompile time drops 19% for stellar_seas (1773 -> 1434 ms) and 34% for yuurand_riviere (6536 -> 4283 ms).
- Modulo operator on decimal values being entirely wrong
efe6125234 - Remove sfx limit (except for fuzz testing)
0c1de2949a - Pushblocks ignoring the top half of combo solidity
09f9912980 - Fire level triggers not counting as 'weapon' triggers
5f42bff76eThey didn't count for effects such as 'Kill Triggering Weapon'- they do now.
- Prevent multiple potential crashes from bad string formatting
b809aa2aa2 - eweapon Rocks no longer hardcoded to die on solids
20e5b2415bInstead, they obey the weapon flag for breaking on solids, allowing rocks that either break or not.
- Classic / cambria tilesets having a 'pop' in the 'Jump' sfx
7c81dd136b - Subscreen selector fitting to item hitboxes is now togglable via QR
e7746505b3Subscreen rule, not compat rule
- Render depressed button in window title bar on mouse down
9724ffbd64 - Improve lens hint graphics
19d8265659They were flickering weirdly, and animating wrongly when more than one of the same hint were visible. This also fixes an item animation issue in the editor, which uses the same drawing code.
- Lens 'Disable Secrets' flag also disabling hints
2178424f6c - Rare crash when loading quests that define few dmaps
77c7b2a957Loading a quest could intermittently crash (or misapply a compat rule) because dmaps beyond those defined by the quest file were never initialized.
- Headless runs could crash driving keyboard LEDs
37c8fd7403Installing or removing the keyboard updates the physical keyboard LEDs, which goes through X11 on Linux and crashes when there is no usable display. Skip LED updates when running headless.
- Per-quest settings were forgotten for quests in paths with # or =
4950d98535Settings saved per quest were lost on restart when the quest's path contained "#" or "=", such as a quest kept in a folder named "#Quests".
This affected the quest's control scheme in the player, its script debugger state, and the editor's test init data, ZScript buffer, and zoom level. Choosing the quest's control scheme again also added another line to zc.cfg each time.
Bug introduced when test init data started saving per quest in 2.55-alpha-117 (c7a9d6a2cf).
- Disable scripts that start with an unknown command
4aa4acd943 - Passageways can have their own midi music
97a0c0130a - Shadows for rocks and boulders not drawing
dc7454ec5d - Ensure enemy projectiles spawn at center of hitbox
3a60859a38 - Ignore conveyors when rafting
5167be5988 - Pushblocks with non-push flags placed on them were leaving trails of that flag
fa2c337583 - Layers not showing revealed secrets in map view
2502d11cd1 - armos/graves not activating properly from Large Hitbox player
1b4fd9b507 - Generic scripts wrongly stopping on
F6->Continueba4c6cdaff - Liquid combo passive damage logic
82d06203d9If the required itemclass was set to 0, but the required level was set >0, would wrongly still require the item (when item class 0 should be
(None)for this combo) Also, the hit sound was sometimes being ignored, and damage events were not being emitted. - Fix item-conveyor hitboxes and solid sideview conveyors
ce0e2a9ddf - Walk-through-walls cheat now makes player immune to conveyors
f3114fd01d - Items using hardcoded hitbox for landing on the ground in sideview
294f11981a - Items that don't obey gravity still counting as on the ground for conveyors
97cda6df94 - Weapons using hardcoded hitbox for landing on the ground in sideview
81f2a996f8 - Engine Map spoiling dark rooms
3066107905Now properly draws new dark rooms, and blacks-out old dark rooms.
- various fixes for Bridge combos
6c30566233Bridges previously were not covering some things they should - this fixes many of them. Notably:
- Warp, Save, Step, Reset Room combos
- Win Game, Fairy Ring, Weapon-based placed/inherent flags
- Bridges above layer 2 for most things
Also made the code for handling bridge combos MUCH cleaner.
- Quake hammer while jumping slamming into the air
c4756842e4Now instead, the quake attack will not unleash until you land on the ground.
- Pushblock lens hints not drawing over block sprite layer
5dffacbc84 - Fake "lens hint" weapons sometimes triggering secret flags
a5b07145f5 - Non-triggering weapons still trigger secret flags
a139c83ab0 - Check bridges for standing-on-z state
3bf23e312b - Don't crash when loading a replay after playing with script bitmaps
80c7a66290Loading a replay (via the Replay menu or -replay-batch) after a game that allocated script-drawn bitmaps had already run in the same process could crash on the loaded game's first frame.
- Reset subscreen state when starting a game
78d0dc4fb8Starting a new game while the previous one ended with the subscreen open could render the new game at the wrong screen height.
- Reset hero ladder-cover position when starting a game
7b98be271aThe hero's ladder-cover position could carry over from a previously-played game and nudge movement on the first frame of a new game.
- Clear leftover screen-scroll state when starting a game
6f3ad96996An in-progress screen-scroll state could linger from a previously-played game into a newly started one.
- Reset hero movement step when starting a quest
169f1a062eThe hero's collision-adjusted movement step could carry over from a previously-played quest and shorten the first move of the next quest.
- Reset the hero's held item when starting a game
17f32424d3The item the hero was holding up could carry over from a previously-played game into a newly started one.
- Reset the hero's tile size when starting a game
f0f0420a65If a script resized the hero in a previously-played game, the leftover size could shift the camera at the start of the next game.
- Don't carry custom test-play init data into the next quest
e383e46f36When test-playing a quest with custom initialization data, those starting items and counters could incorrectly carry over to the next quest loaded in the same session, changing its starting inventory.
- Clear A-button item when starting a game with a charged sword
2d67e151d9Starting a new game while the sword was mid-charge could clear the A-button item selection, leaving it unequipped.
- Reset the skip-continue-screen flag when starting a game
c855017dc5A game started after another in the same session could wrongly skip its own continue/game-over screen if the previous game left the "skip continue" flag set.
- Reset more leftover hero state when starting a game
93f207d50fSome leftover hero state from a previously-played game (hit direction, warp return coordinates, ladder-cover position) could carry over into the next game started in the same session.
- Menu SCCs with nothing after them causing string to not disappear
118e26fe6a - Keep View Map and dark room lights identical across cpu architectures
3d2e713161The View Map's zoomed drawing and the radius of dark room light circles could differ by one pixel between x86 and arm64 builds, causing replays recorded on one architecture to fail their graphics checks on the other.
- Keep the death red tint identical across cpu architectures
87f280c078The luminance math in red_shift() could produce a slightly different tint on arm64 than on x86, causing replays recorded on one architecture to fail their graphics checks on the other during the death animation.
- Keep Patra ring positions identical across cpu architectures
d9985bc6c3Patra children could be positioned a pixel off on arm64 compared to x86, desyncing replays recorded on the other architecture.
- Fade-to-black closing wipes no longer flash the screen at the end
32ede6302cDiscordThe last frame of a fade-to-black closing wipe restored the palette, making the whole screen visible for a moment. Doing a closing wipe followed by an opening wipe (like
Screen->ClosingWipe(WIPE_FADEBLACK)thenScreen->OpeningWipe(WIPE_FADEBLACK)) now fades out, holds black, and fades back in as expected.
- Missing rclick menu separators
1b0b0341c4 - Upgrade tile 'move' code, more things now update on moving tiles
5c29d6f4e6 - Upgrade combo 'move' code, more things now update on moving combos, add Combo overwrite warnings
e8d903186f - Arrow buttons above combo columns sometimes not working properly
1af434da4a - 3-stair warp dialog not properly listing catchall purpose
6ab8d137e9 - Buffer overflow in info editor dialog
63b6cb23f3 - Reduce latency on combo page paste when ComboProtection is off
5fd5fa503e - Delete the initial screen from default.qst
3b7ed5186d - Draw eyeball combos correctly in compact mode and when zoomed out
3f8e849e8d - Add latest fields to .znpc for enemy save/load
0f15969f6c - Fix tile protection for darknut, gleeok, ganon, and patra enemies
74e0347de2 - Set CSet to 2 when loading new quest
e587bafe06 - Use actual qst file code for export formats
5b29f87b43The following export formats in the editor no longer use code separate from the main qst file code, which means these will no longer fall out of date as the qst format continues to evolve:
- .znpc
- .ztileset
- .zdoors
- .zcombo
- Clean up some missing function returns
ef52113252 - Use template for
Condto support arraysaf4293cd68Also deprecate and suggest using ternary expressions.
- Clear script data when reassigning script
03ce2a4f66Previously, only FFCs properly reset their state when changing their script. All others would retain their state, so would instantly do all the wrong things.
- Exit with correct status for JIT on QUIT
3a48a0aea4 - Handle WAITX not actually yielding in JIT compilers
6e95932c2fWAITFRAMESR D2does nothing when D2 is 0, but the JIT compilers assume all wait commands should yield. Now they check if waiting actually occurs. - Derive language runtime version from compiled scripts
a772dd8734The script engine checks the version a script was compiled in to vary some behavior. Previously this version was set to the section version in the qst file format, but that is updated even if scripts were not re-compiled. Now we look directly at the script metadata to set this version. This avoids issues with saving a quest in a new version without a recompile.
- Don't only show singular deprecation warnings
88898e22f2 Hero->Warp()using current screen's warp return square value1f010f2d65- Exit process when preprocessor recursion limit is reached
58aaefd3a3 OwnArray()not working properly at alld706df9038- Scope error when using
for (...){} else {}f43e469073 - Prevent bogus "invalid object pointer" caused by uninitialized memory
9db7d34032 - Remove a bunch of unnecessary zprints
1e1000c99f - Make
npcdata->Flagsa bool array, remove->Flags2ec60344a6bnpcdata->Flagsandnpcdata->Flags2are undocumented and broken tools for accessing the internal flag of npcdata. They tried to split 64 possible flags over two integer values, but since they aren't "long" ints it didn't work. It is now a bool array. - Pop parameters for internal functions in fewer commands
2ea65eef2d - Typo in
Region->GetScreenForComboPos93238598d4 - For-each loop compile issue when iterating over 'const' arrays
a7945bb456 - Use lexical scoping for namespace compiler options
215607727eDiscordPreviously, namespaces would ignore options defined in the file scope. Also, options defined in one namespace block would be applied to every namespace block of the same name.
Screen->DrawLightfunctions now respectScreen->DrawOriginae5a36c6a7These functions did not add the playing field offset, like other draw functions do. Now they respect
Screen->DrawOrigin, and useSPLAYER_DARKROOM_UNDERfor the draw timing.Old behavior is behind the compat QR
Scripts Screen->DrawLight Functions Have No Offset.- Use correct id for
eweapon::TotalDYOffset9fb331c9d9 - Suspending ffc scripts no longer suspends screen scripts
723d6e040d - For JIT, prevent running script from changing itself
e17575e4a2It's forbidden for a script to directly change its own
Scriptvariable, but when JIT is enabled that check was missing and the result was a crash. - produce correct codegen for objects with default constructors
99a548a524Creating a custom object inside another's constructor generated incorrect code when the second class has a default (or empty) constructor.
For example, this code would error and not set the
bvariable onf.class foo { bar b; foo() { b = new bar(); } } class bar { bar() { } } foo f = new foo(); - Make owned objects live as long as the sprite owner
104fc490eaThe
Ownfunctions on sprite objects (npc, ffc, itemsprite, weapons) are documented as assigning the object's owner to the sprite. However, they were actually being "owned" by the sprite's script, so in the case where a script ends before a sprite is destroyed, the object lost its owner a little earlier than expected. Game->LevelStates[]andGame->GlobalStates[]actually toggle switches on-screenc0df8c0d90- Return invalid mapdata when
Game->LoadTempScreen, etc. fail2d76d115cdThese methods were actually returning the first canonical (id 0) when the input is out-of-bounds. Now, they return an invalid mapdata.
- Log error if file fails to open
15c711a2cf - Update door combos when writing to
mapdata::Doorb6f369d2e7 - Clear script-applied palette tint when starting a game
9f580c116bIf a previously-played game left a script-applied palette tint active, the next game could render with a wrong or black palette.
DMap->Offsetreturned wrong values on platforms where char is unsignedae79189a9eReading DMap->Offset cast the (already signed) xoff field back through plain char, so negative offsets came out as large positive values where char is unsigned (Linux AArch64). Quests with scripted map widgets laid out dungeon map rooms wrong there.
- Assignment operators no longer run LHS side-effects twice
e87ce24c04Discordarr[f()] += 5andgetObj()->X += 5called f()/getObj() twice: once to read the current value and once again to write the result. All compound assignment operators (+=,-=, ...,?:=) and++/--now evaluate the array pointer, object pointer, and index of the left-hand side exactly once.
- Character literals not highlighting properly
5dc7bd7c0e - 'loop' keyword missing highlighting, add range operators to operator list
df11ee40f1 - Increase max buffer size for ZScript process, which was breaking editor for large scripts
2169c67a36 - Show error message when default include file does not exist
d19b885857
- Improve sfx on title screen by yielding during quest load
424f6200c2 - Skip titlescreen for quick open links
840e2ef7b2 - Avoid performance hit by disabling info bitmap
2a6812a96b - Packaged quests not loading correctly
49b71a2a1f - Disable text selection in Safari
dd4d5a5cce - Prevent hang when attached folder is deleted
f155adeff9 - List default controls relevant to detected keyboard layout
c48d4f2fe4 - Prevent backspace randomly inserting characters
0cb58f500b
- Create https://docs.zquestclassic.com
ce839d1e8dThis is a new website for documentation. It's currently mostly just reference docs for ZScript, but soon it will also have tutorials and documentation for the editor.
- Add SCC tutorial
a731f1d2c0 - Remove ghost, tango doc sites from release package
5fd2ed7ce1 - Remove zasm_registers.txt from release package
63984595c8 - Add new ZScript language documentation
e1cfeefd1a - Update docs related to generic script events
d517ebf642 - Mention loading functions at header of each class
9d3693b6a5no notes were added mentioning class constructors, as they simply are in the constructors list already.
- Document values for
Game->GlobalStates[]0e40c8fc18 - Add "Using a tileset" tutorial
3cdbbe32f4 - Add AI disclosure
fa61adaed3 - Add wieldable bow and arrow tutorial, by Jared
c094ee6fa9
- Include logo and title assets in web data file
9e4f5313f5 - Fix typo in building.md for cmake version
aa460db5ab - Use better library for json
Relevant changes:
- ci: update to macos-13 in other places too
6bb570d372
- ci: update to macos-13 in other places too
- Update fmtlib to 10.2.1
11b834b35e - Update building.md for Linux
f00d2f0ace - Pin poolSTL dependency to specific commit
1a347f264b - Fix gcc compilation issues
7cfee7439c - Only depend on .git/refs/tags if present
bd8e3c8f53 - [linux] do not disable allegro5 png, which broke the title screen logo
c0553e6a98 - Update fmtlib to 11.2.0
d808c0b5ef - Add WANT_NFD cmake option
4b75a51c00 - Enable unused parameters diagnostic as error
7aeeb0e47a - Upgrade sentry to 0.13.8
e57dff45d7 - Vendor nlohmann/json
bb0ff5761c - Vendor libvorbis and libogg
16aac4601e - Enable many compiler errors
a73e6d203b - Support AArch64 targets, including native arm64 macs
a720c27f87Native arm64 mac builds previously failed to compile. The fast tile blitters now have NEON implementations (matching the SSE versions pixel for pixel) on all AArch64 platforms, including Windows on ARM.
- Upgrade to emscripten 3.1.60
8bceba4de1 - Upgrade to emscripten 3.1.64
171d5ce811 - Upgrade emscripten to 4.0.8
10b4684be3 - Upgrade emscripten to 4.0.13
422dd5a155 - Upgrade emscripten to 6.0.6
33fd59c1a9Notable changes since 4.0.13: LLVM 22 toolchain, musl 1.2.6, and the SDL2 port moved from 2.32.8 to 2.32.10.
- Share common allegro app setup
05eb72d5b6 - Use enums instead of defines for many flag values
806180beab - Combine misc attributes for guys into array
4e949df181 - Use vector for storing FFCs
c1273e1491Previously, every screen allocated memory to hold the maximum number of FFCs (2.55 alpha 112 bumped this from 32 to 128), which took ~43 KB per screen, even if no FFCs were used. Now screens only allocate as many FFCs as they need.
For a quest that uses no FFCs at all, this saves ~5 MB of memory per map. For Yuurand, total memory usage on startup went from 1.3 GB to 800 MB.
- Consistently use "Hero" instead of "Player" to refer to the playable character
3e3989cdb5 - Move Hero extern to header
ef61b61363 - Move particles extern to header
92136e1c93 - Remove module system (zinfo has replaced it)
3f0f249761 - Rewrite string message parsing and renderer
71b272aee9- Completely rewrite the string message parser / renderer - this will make it possible to add more advanced SCC features in the future.
- Executing a SCC no longer takes a frame per command.
- Use the same code for parsing a message string in the player and in the editor - this fixes a handful of differences w/ word wrapping that the player handled poorly.
https://discord.com/channels/876899628556091432/1277878877057978460
- Improve syntax and encoding of message strings
8c038be724Message strings now use an improved syntax that is more readable, supports negative arguments, and is less error prone.
Previous:
It's dangerous to go alone! \1\2\3Take this!
New:
It's dangerous to go alone! \TextColor\2\3\ Take this!
Additionally, message strings no longer use a binary encoding to store SCCs, but instead now use plain ASCII. Scripts that require the old binary encoding should use the compat QR.
See https://docs.zquestclassic.com/tutorials/message_strings for more.
- Update old
getnumberdialogsb418222d8d - Create display window in consistent manner for every app
ec4f1e0973 - InfoDialog construction
0ea9ecc390 - Clean up dummy item code
68edac45e6 - Replace unsafe sprintf with snprintf
6a64ede16e
- Use common structured ZASM utilities in jit_x64.cpp
c40c79a067 - Simplify how structured ZASM finds functions
46bc924eda - Split some ZASM opts into separate script-level pass
3f4f964dcd - Assume modern function calls in ZASM optimization passes
e260ce752e - Move get_register_dependencies to zasm_table.cpp
13b6a599c6 - Add get_command_implicit_dependencies in zasm_table.cpp
9e4a41e07f - Add get_register_ref_dependency in zasm_table.cpp
ced4dbad84Also run
propagate_valuesafter the comparison opt passes, as it was accidentally skipping some optimizations due to the comparisons passes assuming D2 is being compared. - Simplify ZASM simulation and always simulate stack
37d86217db - Optimize ZASM scripts in parallel
9ae7f4e860 - Improve handling of bugged SDDDD by fixing it, instead of deopting
df037da33f - Reduce duplicated code for trigger conditionals
Relevant changes:
- refactor(zc): reduce duplicated code for trigger results
f20ddc1b49
- refactor(zc): reduce duplicated code for trigger results
- Clean up jinx handling
cfe48cd7b0 - Deduplicate enemy code reading of SIZEflags
92bb2cc6ad - Remove old movement functions
c5b8a0e17d - use translucency table cache for all fade/lighting
284fc7567d - Remove many per-frame heap allocations
2b3510c4eeProfiling a script-heavy replay showed ~5% of busy time inside the memory allocator, all from a handful of per-frame temporaries. Removing them cuts that to under 1% and makes those replays 2-4% faster.
- Re-organize the combo editor 'Triggers' tab
53310a2541 - Redesign enemy editor using new GUI
e335517596 - Upgrade enemy editor's enemy selector to new GUI
b7e767fd40 - Remove the
Misc[]dialog as it was unused49c6f2e4f9 - Upgrade screen enemy selector to new GUI
54498fae33 - Upgrade midi editor to new GUI
e472b5f1a0 - Upgrade sfx editor to new GUI
ccdde8a650 - Upgrade map styles editor to new GUI
031767ec0e - In enemy editor, read defense names from zinfo
8cde41f2ec - Remove classic_zquest.dat, load assets from new assets/editor folder
5551216eb2 - Clean up
Quest->Audio->MIDIslisterc4a6d8b720Empty MIDIs now show as
zzUntitled, to help support alphabetized sorting. - Rename Fire Levels to Burning in combo triggers tab
d454c4abe0 - Upgrade sprite data list dialog
383b5d34a6 - Hero editor now uses zcgui
9fa5643029 - Redesign ffc editor
fdd6917e77
- Remove instances of deprecated functions
331bbd4e39 - Make every std file compile individually
6de1bb98b4 - Move some constants from std to bindings, and add more doc comments
45d9718e1e - Collapse many per-type overloads to sprite
1b6432a79effc/lweapon/eweapon/npc/item all extend sprite, so a single sprite overload replaces the dozens of near-identical per-type overloads.
Collapsed functions:
- CenterX
- CenterY
- ProximityX
- ProximityY
- HitboxRight
- HitboxTop
- LinkFacing
- RightOf
- Internal function aliases, internal constexpr functions
17e03bc814 - Use alias name in comments, update expected ZScript
b0af4b4b83 - Reserve 'constexpr' token
0cb3519ea3 - Clean up generic script indexing
a27241f734 - Optimize bool ops a lot
c8fae535d2 - optimize sections of zasm that are run only for their side-effects
d253cbb843 - Clean up
getStackOffset(Datum)code3cdf73853f - Label opcode register args as R/W/RW/unused
40e805b559 - Label some opcode properties with flags
c11ec71723 - Use common UserDataContainer for most user data
ba6e421d92 - Standardize script object management
be20f347b6This keeps script-created objects in the same map, gives all objects a unique id, and implements allocation and retrieval for any object type using the same methods. This reduces some duplicated code, and should help with implementation of a potential garbage collector feature.
Bitmap objects are a bit special, and still need to be refactored.
- Migrate user_bitmap to script object system
68329daf9fIncidently, this increases the maximum number of user bitmaps to 256.
- Move ZASM table and serialization to shared lib
c483f611c8 - Remove separate ZASM defines for compiler
bcd0795391 - Improve location of many error messages
52949459f6 - Move internal symbols to new binding .zh files
011539980bInternal symbols were defined in
.cppfiles, but now they are defined in.zsfiles with a newinternalkeyword and@ZASMdoc comments. These files live inbindings, and are automatically included for every compilation.This should simplify the process of adding new internal symbols. It also enables viewing documentation of any internal symbol in the VS Code extension (w/ a hover tooltip), and all the documentation we have for internal functions and variables has been inserted as comments in the binding files.
This also deprecates functions that create an object of internal types, like
Game->CreateBitmap(width, height)- and replaces with normal constructors -new bitmap(width, height). - Remove library symbol cpp files
76a67b3714 - Remove internal class type
b760782751 - Array literals better deduce their element types
3717da2936 - Type-safe opcode classes and use ZASM table for stringification
75dc4d745e - Separate ZASM code from script data
75f981f571 - Make all command strings match enum name
08e0c08e56This normalizes all the string names for commands to be the same as the enum name used in code, and rewrites
get_script_commandto be an explicit mapping of this string representation and the enum value. These not matching was confusing, and was a potential source of future bugs. - Remove unused features from ZScriptArray
c09b581332Various things are just a wrapper around what std::vector does, and we don't need dimensions, a template, or a custom iterator.
- Remove duplicated function deallocateZScriptArray
d061e3c552 - Add -json switch to parser, use stderr for logging
3be9b16e8a - Add errors and warnings to json output as diagnostics
6ae06e15d7 - Improve validation of file paths
0480ad0349..is now allowed in paths, as long as it doesn't reach above the quest's "Files" folder- more specific error messages when path is invalid
- check for illegal filenames
- general clean up of path validation code
- Remove
Game->Misc,Misc2,Misc3,STD,Ghost,Tangoarrays5c64321ee1These have been removed from ZScript. Additionally their implementations are removed too, since no quests ever used them.
- Remove unused getters/setters from npcdata
a7fbbb5cc2 - simplify ltou, utol and convcase
7aabd90782These functions returned false if the string given is empty. That's not useful, so now they no longer return anything.
- Remove unnecessary
Debug->"typecast" functions18c2b4c49e - Remove many unused
Game->functions7948da864cAll of the following functions were found to not be used in any published quests or scripts. Since they have all been deprecated (via
Screen->ormapadata), they have been removed.GetScreenEnemySetScreenEnemyGetScreenDoorSetScreenDoorSetScreenGuyGetScreenGuySetScreenStringGetScreenStringSetScreenRoomTypeGetScreenRoomTypeSetScreenEntryXGetScreenEntryXSetScreenEntryYGetScreenEntryYSetScreenItemGetScreenItemSetScreenUndercomboGetScreenUndercomboSetScreenUnderCSetGetScreenUnderCSetSetScreenCatchallGetScreenCatchallSetScreenLayerOpacityGetScreenLayerOpacitySetScreenSecretComboGetScreenSecretComboSetScreenSecretCSetGetScreenSecretCSetSetScreenSecretFlagGetScreenSecretFlagSetScreenLayerMapGetScreenLayerMapSetScreenLayerScreenGetScreenLayerScreenSetScreenPathGetScreenPathSetScreenWarpReturnXGetScreenWarpReturnXSetScreenWarpReturnYGetScreenWarpReturnYGetScreenEFlags
- Improve placement of errors/warnings on function calls
9eedc19110Errors/warnings from using unknown or deprecated functions now attach to the function name, rather than the entire call expression.
- Remove A registers
2c8e6a1ecdThe "A" registers are two old registers that were never used in any quests. The only way to access them in recent builds has been the FFC
GetFFCInitA/SetFFCInitA, but no published quest has ever used them.Now the ffc and item editors no longer display these two "A" register fields, and internally many other things handling these registers have been deleted.
- Make
ComboAtinternal as an optimization777571531c - Tidy up std, move many enum/constants to bindings
45b9f17949Many constants are now named enums, and moved from
stdto binding files (which are imported automatically). This allows these values to be used with internal bindings (likeGame->) without importingstd; and improves documentation by giving everything a reference-able name.Also did a large general clean up of documentation comments, and made sure every internal function/variable documents what enum applies to it.
Removed many unused or unimplemented features.
- Remove HEADER_GUARD (allow and ignore duplicate imports)
626c877724 - Prevent parsing same files multiple times
20885219b6Before, every import would parse the file it included. Now, a cache is used so every file is only parsed once. This reduces compiler times (for example: compiling the binding files went from ~300ms to ~200ms).
- Remove WarpReturnC
0f4e5290cb - Deprecate
WrapAngle(useWrapRadiansinstead)786f3b248d - Emit shared ZASM for scripts
51ec0e0a51Previously each compiled script resulted in a separate chunk of ZASM for just the code it used. This resulted in large amounts of duplicated ZASM instructions across all scripts. Now, the ZScript compiler uses the same chunk of ZASM for all scripts.
Compiling Yuurand's scripts went from 4m ZASM commands to 1.87m.
- Remove separate "script UID" for sprites
02028b2077Every sprite object has an internal engine ID, but for some scripting features a separate "script UID" was used. Features such as
->HitBy,->ParentUIDused this - andScreen->LoadNPCByUID(etc.) existed to translate to the actual engine ID. These are relevant toeweapon,lweaponandnpcsprites.Now, all these features just use the engine ID, and "script UID" is no longer a separate thing.
- Print context alongside script runtime errors
b7829c0f8eWhen a script does something that results in an error, a message is logged to the console that usually mentions the ZScript source variable or function where the problem occurred. This was usually right, but sometimes would mention the wrong thing.
Some automation is added to more consistently print the correct variable or function name when encountering an error. In addition, potentially multiple bits of context may now print alongside error messages (one or all of: function, variable, or the name of a specific parameter).
- Remove almost all of
Debug->418b016fabThe only useful thing here is
Debug->Testing, which is now deprecated in favor of the newly addedGame->Testing. - Use common abstraction for arrays
df3ce2079cBuilt-in arrays (such as
Screen->State[]) are now implemented using a new shared abstraction.- improves maintainability of arrays
- consistent application of index/value bounds (this was often wrong and many issues are now resolved)
- enables new features in the future (such as iterating built-in arrays)
https://discord.com/channels/876899628556091432/1382495697907093574
- Simplify ownership of JIT script handles
e44642dc36 - Improve stack overflow error behavior
dcac26d531Previously, if a script used too many stack variables (typically by doing lots of recursion), the engine would (sometimes) emit a warning, "wrap around" the stack pointer, and continue executing the script. However, that results in very buggy and random behavior, and is never recoverable.
Now when the stack overflows, the script is stopped.
- Increase stack from 1 KB to 5 KB
b118e9fc1a - Limit max nested function calls to 1024
37a0a4f13c - Soft-deprecate some duplicate variables
00f762a12eSome variables access the same data. All but one of these are now soft-deprecated (compiler won't complain, but docs will suggest not using them).
- deprecate npc/npcdata/itemsprite/itemdata
Family(preferType) - deprecate lweapon/eweapon
IDandFamily(preferType)
- deprecate npc/npcdata/itemsprite/itemdata
- For x64 JIT, compile each function separately
daa1161618Instead of compiling the entire ZASM chunk at once, compile only one function at a time, and only the "hot" ones. This greatly reduces the amount of memory needed to compile scripts, and does not waste any time compiling unused code.
- Always return 0 for out-of-bounds access for internal arrays
e323678cb3Some internal arrays would return non-zero values if the index used was invalid. Now, all return zero.
Previous behavior is available behind a compat QR.
- For x64 JIT, use smarter register allocation
68087da593Instead of reading / writing to memory within every command, the x64 JIT compiler now attempts to keep values used across multiple commands cached in registers, only writing back to memory when necessary.
This makes the compiled code ~40% faster, and makes compilation take ~44% less time.
- Move Own functions to base sprite class
bfb37ca568 - Deprecate QuitNoKill
32dbbc501b - Remove unused "ignore/catch" compiler directive
fc12c12651 - Remove multiple compat compiler settings
725b3f3a33The following compat compiler settings have been removed in order to simplify the compiler. They don't seem to be necessary to support any popular scripts, and sometimes resulted in bugs when users inadvertently had them enabled.
- 2.50 division truncation
- 2.50 value for 'true' is 0.0001
- Binary operations use true 32-bit int
- True MAX_INT sizing (smaller max int sizes no longer supported)
- Short-circuit boolean operations (non-short circuiting no longer supported)
repeat(N)now acts likeloop(0=..N)1ec6f924f2- Change
Screen/mapdata->Tile/SideWarpType[]to enum type8e6839aeabThis will require using the correct constants to assign to these, but also will make them return the correct type for use with ex.
WarpEx() - Remove unused version variables from Game
ff9afa989e - Call directly between JIT-compiled script functions
48fc5b7218Script function calls under the JIT previously round-tripped through the C++ driver on every call and return - a function lookup, a resume lookup, and a full function re-entry each time. Scripts making many small function calls (std.zh-heavy quests reach thousands per frame) spent more time in that overhead than in the scripts themselves.
Calls to functions that can never yield now call the compiled code directly on the machine stack. Yielding callees, not-yet-compiled callees, and calls past a native depth cap keep the driver path. Across the benchmark set, total script time drops ~30% (yuurand_riviere -62%, freedom_in_chains -35%, 100_rooms_of_wisdom -29%).
- Fast paths for the hottest script registers
01776fc9d6Script engine time on Yuurand dropped by 10%.
- Binary search for ZASM command and variable names
815e4261b1Looking up a command or variable by name scanned the whole table with string compares. Sort a pointer index by name once and binary search it instead. Assigning compiled scripts to slots re-parses the ZASM text and does one of these lookups per instruction and register argument; for playground.qst that stage drops from 41ms to 9ms.
- Cache script object lookups instead of walking a map
30974734aaSpeeds up scripts that make heavy use of objects - classes, arrays, and other script-created values.
An object-heavy benchmark ran 39% faster with the JIT and 7% faster interpreted.
- Resolve switch/class/stack registers on the fast path
fd5aac89b7Speeds up scripts that lean on switch statements and class method calls.
A benchmark heavy in both ran 10-12% faster, interpreted and with the JIT.
- Inline script stack reads and writes
34e5265650Speeds up scripts that call functions frequently.
Script-heavy interpreter benchmarks ran about 3% faster.
- Inline the interpreter's comparison checks
2065e65832Speeds up scripts with lots of conditionals - if statements, loops, and comparisons.
Comparison-heavy interpreted scripts ran about 4% faster.
- Fast-path plain array element access in the pod opcodes
988b3e9d22Speeds up scripts that read and write arrays heavily.
An array-heavy benchmark ran about 8% faster under the JIT and about 1% faster interpreted.
- Resolve script debug checks inline on engine entry
eaf13045dfScript-heavy benchmarks ran about 3% faster, both interpreted and with the JIT.
- Compile class member reads and writes in the JITs
4685ecd825Speeds up scripts that use classes, when running under the JIT.
A class-heavy benchmark ran about 30% faster under the JIT, native and web alike.
- Use new -json ZScript option for diagnostics
1143e74802 - Improve symbol id generation used for metadata
175bf49720 - Add job pool, improve script processing
6e70798b29
- Call engine callbacks directly from JIT-compiled scripts
13fbc0a7eaCompiled scripts reached engine callbacks (register access, interpreted command batches, array reads/writes) through JS wrapper functions, paying a JS frame plus argument marshaling on the hottest script-to-engine path. Bind the script module's imports to the engine module's raw wasm exports instead, making these calls direct wasm-to-wasm. Scripting benchmarks run twice as fast: this halves total scripting-engine time across the benchmark set, with the heaviest quests improving the most.
- Compile real control flow for non-yielding functions
82e4a07a8cThe wasm JIT lowered all control flow through a "loop-switch": one giant br_table dispatch that every branch re-enters by writing a global block id. A script loop paid a global write plus a multi-way dispatch every iteration, and the browser's optimizing tier couldn't recover the loop nest to optimize across it.
Non-yielding functions - where game-logic helper loops live - are now compiled to genuine structured control flow (block/loop/if) reconstructed from the CFG, so script loops become real wasm loops. Scripting benchmarks run ~4% faster on the web version.
- Compile the yielder's non-suspending loops as real loops
6afa80a1d2The previous change gave non-yielding functions real structured control flow, but scripts that wait are inlined into the "yielder", which stayed entirely on the slow loop-switch dispatch. Now a loop inside the yielder that never suspends (no waiting, no calls to waiting functions) is also compiled as a real wasm loop, nested inside the dispatch. This helps quests with compute loops inside scripts that also wait, ~2% across the benchmark set.
- Keep the script stack pointer in a register
0db05a5de4Compiled code accessed the script stack pointer through a wasm global on every stack operation - a memory access the browser's optimizing tier cannot register-allocate. The stack pointer now lives in a function-local (which the optimizer keeps in a machine register) while inside compiled code, touching the global only at function boundaries. Scripting benchmarks run ~4% faster on the web version.
- Keep hot engine pointers in machine registers
b8b10c40aeCompiled script code re-read a few frequently used engine pointers from memory on every access; they are now loaded once per function so the browser can keep them in machine registers. Scripting benchmarks run ~2% faster on the web version, up to ~4% for script-heavy quests.
- Fix get_recent_release_tag method
3b24464b14 - Update 'armos.zs' expected ZASM
8ccc152f66 - Extract snapshot testing code to base class
d9d839b21e - Add snapshot tests for x64 JIT
07a6ef7137 - Fix test_jit.py not looking in the right folder anymore
44227cd6e3 - Add test_optimize_zasm.py and update_snapshots.py
6b8053c89f - Move snapshot files to common folder
47eb8e7451 - Hash JIT output for all but playground.qst
8a28eff6bb - Add scripts/run_for_every_qst.py, for running a command against every qst in the database
0eb93f48d2 - Add replay test for class ctor/dtor
57c8cc5e1a - Fix different outputs for JIT snapshots
179f968587 - Define calling convention for JIT regression tests
03e3f08718 - Add playground_exstate.zplay and playground_large_animations.zplay
d61aeb1bc3 - Add crucible_quest.zplay
5dd7d4c231 - Add combo_rotator.zplay
543bcfb5ffThis is the first of more planned script replay tests, which along with the playground.qst replays will be re-compiled with the latest ZScript in CI and their replays re-verified. Should result in better test coverage for newer compiler features.
- Fix crucible_quest.zplay from recent slope refactor
3a3dba0d00 - Update crucible_quest.zplay for 5732b53
798646bc47 - Add local web app for running replay tests
bd16f16e03 - Move build archive operations to archive.py
144ec7f337This greatly cleans up bisect_builds.py, which was doing a lot. Now a new tool
scripts/archive.pyis responsible for downloading any build - or building from source, as needed. - Avoid enumerating s3 bucket just to download single version
e1b37622be - Use new archive download for run_replay_tests.py
f2eaaf7ec7This removes the old download flow that required a github api key to get a baseline build for a compare report.
- Move github related functions to github_helpers.py
deb47752d3 - Use requirements.txt for python deps
61941b504c - Extract core replay runner to replays.py
a2ab3ac30a - Format Python using Black
c54f261959 - Sort Python imports using isort
2cabfdb7c0 - Update expected ZASM from recent changes
ed025a9724 - Refactor how known replay failures are handled
85f745323c - Import Path directly
2fd2403216 - Remove solid.zplay
2b3acd7420 - Add playground_bitmap_credits.zplay
d6b398ad43 - Make some test scripts emit no warnings
6720fc50e9 - Update test scripts for new array syntax
873e7ecd64 - Add item_spawns_cloud.zplay
0ab66ae79b - Add crucible_quest_short_1.zplay
f7650745d9 - Add snapshot test for compiling the ZScript database
46e71c1d8f - Use truecolor bitmap for gfx frame hash
bd2cf5c9be - Add "auto" script tests; reorganize and document playground quest
99a867ad32 - Add SCC replay test
cfe187b588 - Add scripts/replay_uploads.py for downloading and running uploaded replays
49b3d60e07 - Add Database class to nicely automate downloading the database for local use
3af230f63f - Add terror_of_necromancy_demo5.qst replays
4d652888b6 - Add dither testing
d17462015c - Add terror_of_necromancy_demo6.qst replays
6ba5e9d277Discord
- Add in-process batch replay infrastructure
557fdc34ccDiscordAdds tooling to run many replays back-to-back in a single process and to pinpoint state that leaks between them, so cross-replay desyncs can be reproduced and guarded against.
- Add tests for 2.55 and 3.0
c9334a3811Also:
- On Mac, can now use path to
.appbundle as installation folder - For 2.55, fix bug where parser errors underlined the entire line
- On Mac, can now use path to
- Move most logic from .yml to ci.py
0231327ab3 - Test AArch64 Linux
4f987b0047
- Ignore fixup commits in git hook
6447981462 - Use better examples for commit messages
46af4f0af8 - Version refactor
b49ae14d62Switch from "alpha/beta/gamma/final" to simpler "stable/nightly" versioning, and adopt a semver-like version string. See docs/versioning.md for more.
Also, greatly automate the version bumping process. Simply select stable or nightly in GitHub action, and release scripts handle selecting the next version number accordingly.
- Link to website in generated changelog
c72db74777 - Minor replay/debug improvements
4fe60ce1f8 - Add jit_runtime_debug.py for debugging JIT bugs
781ffbc008 - Auto-generate 'include/bindings/qrs.zh' from source code
93f82434ea - Add horizontal scrolling panes
c9a009b60b - Add "spreading fire" to 'trigger_example.qst'
a755adb086 - Update trigger example with new doors
fe7a63903c - Update 'trigger_example.qst'
ce7fa21378include example large liftables, large armos, and boss music triggers
- Disable ZASM optimization until reported issues with tango are fixed
c3b7e1ba25 - Update MIDI Info dialog
1926d732e6 - Update goto cheat dialog
09d6d254f5 - Update 'ZC > Quest Info' dialog
e72ed380b1 - Update 'Screen Saver' dialog, let screensaver take arbitrary seconds value
46f6a1c476
- Editor-only combos no longer show by default in
View Map80976f3199There's now a (default unchecked) checkbox in
View->View Mapfor if 'Only Visible In Editor' combos should be drawn. - Improve global_frame tick rate
ed5abf073eThis notably makes the 'Show Misalign' arrows continue blinking while you hold click to draw on the screen.
- Update headers and bindings with array typing
b23b23484e
- Optimize '!' operator
cb8cbe0388 - More parser optimizations
900178b730 - Optimize multiple consecutive PUSH opcodes
dc6d9e49ef - Add ZASM comments to parser output
407bcf258d - Add more ZASM comments
4b1dd09883 - CALLFUNC/RETURNFUNC for optimized function call/return
5aa14b3355 - New 'ReturnVisitor' pass errors on functions missing 'return' statements
5cc8fb151d - Code reachability optimizations
17ae5ad31f - More small ZASM optimizations
76f86d2a7e - Add compile option for missing return error
18275ed760 - Treat empty functions like prototype functions
433581fe73This can be a heavy optimization for empty constructors/destructors.
- Make some more internal functions
constexpr21cdf3c04b - Optimize 'STORED' followed by 'LOADD', and add 'STOREDV'
6fce115646 - Optimize standing-statement x++,x-- to ++x,--x
5b62f2f5c4 - Optimizations related to function call parameters, unused function params
d79b131ab7 - Range loop cleanup
9841db7d55 - Optimize variables initialized to 0
f20abd31d0 - Clean up unused variables
f3a0991d62 - Compare related optimizations
3a0d346dc7 - Allow 3-arg opcodes, move ZASM tables to remove duplication
0c3e0823b2 - Optimize comparisons to run when used, add CMP_BOOL flag for boolean-equality comparisons
aa9bf8ebba - Support CMP_BOOL in x64 JIT
accf84bf07 - Optimize PEEK in x64 and wasm JIT
0ff7dee9ef - Use faster LOAD/STORE instead of LOADD/STORED in compiler
e8b3be6fd8 - Remove SRAM feature
22a9c67341SRAM continually has caused issues with new updates and has fallen severely behind. As it was originally implemented, it does not work well.
- Add constants for more ffc flags
bf188b3515 - Error on using
staticon arunfunction11fcf2b6fe
- Publish 1.0.14
883e1553d4