Animated sprites now support skipping forward or backward, speeding up or down, and pausing and resuming with sprite.currentframe, sprite.animationspeed and sprite.animationpaused

New text command [alpha:xx] supports transparent text, and text objects can now be moved above or below each other with text.MoveAbove and text.MoveBelow

The Inventory object now supports Inventory.AddItem, Inventory.RemoveItem and Inventory.GetType, allowing for very easy adding, removing, and even swapping of items

The Misc object now supports Misc.cameraX and cameraY, Misc.MoveCamera and MoveCameraTo and Misc.ResetCamera, which let you move the game camera outside of its normal 640x480 restraints!

Sprite.SetAnimation now takes an optional third argument, that will let you avoid copying and pasting the same folder path for every sprite

Sprite.currenttime and Sprite.totaltime have been added, and they function the same as NewAudio.GetPlayTime/NewAudio.SetPlayTime and NewAudio.GetTotalTime

NONE has become a state again. Now, to pause the engine, it's State("PAUSE")!

Fixed Sprite.currentframe choosing the wrong frame index when being set

Fixed using Sprite.animcomplete on an active sprite with the "ONESHOTEMPTY" loop mode causing the animation to advance twice in a frame

Fixed SetButtonLayer not actually setting the layer of the buttons (lol)

Fixed not being able to change the player's properties before EncounterStarting

Fixed an oddly specific error (from calling State("ITEMMENU") from a state in which the default text manager was inactive, like "DEFENDING" or "NONE")

[w:#] no longer ignores [instant]

Text.allLinesComplete no longer throws an error if the text object has been destroyed

Fixed Input.MousePosX and Input.MousePosY being able to go past 640x480 in fullscreen

Fixed the player being able to call bullet.sprite.Remove() or bullet.sprite.Dust(..., true)

Fixed calling Inventory.AddCustomItems twice removing all items added the first time

Fixed the error message for calling Inventory.SetInventory without calling Inventory.AddCustomItems first: it described the wrong problem

Fixed a bug where using [func:x] in the Game Over screen would crash CYF

Fixed General.GameOver crashing CYF instantly

Fixed General.GameOver causing the player to mysteriously vanish

Added a new variable, fleesuccess, which allows you to force the player's attempts to flee to fail or succeed

Added Arena.Hide() and Arena.Show(), which control the Arena's visibility, without actually removing it or its boundaries

[speed:#] now works as intended, instead of typing N characters every 4 frames. See the documentation for details

Made [instant] able to be stopped, at which point the text will continue typing

Made [instant:allowcommand] work exactly the same as [instant], but without ignoring commands
(this is what the Docs have always said this should do, but it never has done this)

Made [instant:stop] cancel [instant] and [instant:allowcommand] and resume typing

Made [instant:stopall] cancel [instant], [instant:allowcommand] and Player skips, and resume typing

The first argument of Text.CreateText can now be a single string

Removed Text.SetPivot, as it was found to not work

Added an optional argument to General.SetDialog and General.SetChoice, which lets you choose which side of the screen to have the text box on

Fixed some misinformation about Player.Hurt, Audio.PlaySound, script.Call, the Game Events and Special Variables pages, and some of the Overworld pages

Added Misc.OSType to tell which OS the user is on

Added Misc.OpenFile, which creates a new instance of The File Object (see below)

Added Misc.FileExists to check if a file exists before reading from it

Added Misc.ListDir which gives you the names of all files or folders in a given path

Added BattleDialogue as a shortcut to BattleDialog, so new users don't have to remember to use the "typo"

Player.atk and Player.def can now be modified

Player.ResetStats has been added, which resets the player's Max HP, ATK and/or DEF to their original values

Player.SetMaxHPShift now takes an optional argument to prevent any sound from playing

Added sprite.xpivot and sprite.ypivot

Added Text.Scale, xscale and yscale!

Added 3 shortcut functions:

• Text.SetTail --> Text.SetSpeechThingPositionAndSide
• Text.SetWaitTime --> Text.SetAutoWaitTimeBetweenTexts
• Text.Remove --> Text.DestroyText (we know you guys have been waiting for this one :P)

Added isactive to monster scripts, which tells you if a monster is active

Removed the third argument in Move and MoveTo, as it was actually a leftover argument that did nothing

Fixed BattleDialog, encountertext, deathtext and Text Objects playing the text sound for the space character " "

Fixed a bug where an encounter entered from the Overworld would always ignore unescape

Fixed BindToArena doing nothing on encounter start

Calling bullet.sprite.Remove will now call bullet.Remove instead of erroring

Fixed being unable to call bullet.sprite.Dust

Fixed a bug where calling bullet.sprite.SetAnimation on a bullet might make it incorrectly scaled in future waves

Bullet hitboxes now account for bullet.sprite.rotation and bullet.sprite.SetPivot properly, for both pixel-perfect and non-pixel-perfect bullets

Fixed the volume argument for Audio.PlaySound always being ignored

Fixed Player.SetMaxHPShift's third argument setting the player's max HP to weird values when Player.lv was > 1

Fixed a bug where calling Inventory.AddItem, rather than Inventory.SetInventory, would have the added items carry over to other mods

Fixed Inventory.AddItem giving an incorrect error message if you haven't called Inventory.AddCustomItems first

Fixed a major bug where [instant:stopall] and playerskipdocommand were completely ignored by text objects

Made dofile give more precise errors

Added a basic masking system through sprite.Mask, which forcefully masks or cookie-cuts a sprite's children based on one of 5 different modes

Added a third argument to CreateSprite for the purposes of choosing a sorted position in the given sprite layer

Added the Game Event BeforeDeath(), which executes just as the Player is being killed, and allows you to execute code on the Player's death and even prevent the Game Over sequence from starting

Player.SetAttackAnim now can take a third argument, in the same manner as sprite.SetAnimation (contributed by @deonix37)

Made Player.maxhp settable for ease of access compared to using Player.SetMaxHPShift

Added Input.MouseScroll, which allows you to track the scroll wheel movement supplied by the user's mouse or trackpad

Text.xscale/Text.yscale/Text.Scale now functions the same at ANY time, compared to v0.6.3!

Text.SkipLine() now takes playerskipdocommand into account

Added Misc.DirExists, Misc.CreateDir, Misc.MoveDir and Misc.RemoveDir to the Misc object for folder manipulation

Added function File.Move to the File object (contributed by @deonix37)

Added File.Copy for copying files!

Added File.filePath to get the full path to the opened file on the user's computer!

Added the property file.encoding, which lets you choose the file encoding method used to read from and write to files in byte mode

Added Misc.MonitorWidth and Misc.MonitorHeight, which always return the size of the user's monitor regardless of settings or fullscreen status

Added Misc.SetWideFullscreen, which removes the left and right black pillars when in fullscreen if the player's aspect ratio is wider than 4:3. Can only be used in battles, and resolution resets on battle end.

Changed several Audio-related functions: they no longer display a warning if an audio file could not be loaded; instead, they return a boolean representing if the file was successfully loaded or not (meaning you can now test for if given audio files exist!)

• Audio.LoadFile
• Audio.PlaySound
• NewAudio.PlayMusic
• NewAudio.PlaySound
• NewAudio.PlayVoice

Added a second argument to NewAudio.GetAudioName which lets you get the actual name you'd enter into PlaySound/LoadFile and such, without the prefix

Added Script.scriptname to the script object, for getting the name of a script object's source lua file

SetAction now has an extra use while in the state ACTIONSELECT: manually moving the Player onto the 4 different buttons

Added a special variable dialogueprefix to monster scripts, which can be used to prefix text to the beginning of all monster dialogue. Especially useful for text effects (contributed by @deonix37)

Added defensemisstext and noattackmisstext, which when set, will change the damage text displayed when dealing no damage to the enemy and not pressing Z to attack the enemy, respectively (contributed by @Shiftenas)

Added [texteffect:x,intensity], which allows for multiple different text effects in the same line of text

Added [mugshot:x] for use in the Overworld

You may now use [charspacing:default] to reset a text manager's character spacing to its original value

Fixed the famous "fullscreen bug", where upon entering blurless fullscreen, the player was able to see past the intended 640x480 area if they entered fullscreen at the exact same time as loading a mod. This behavior got moved to the new function Misc.SetWideFullscreen

Fixed a bug where loading a song using NewAudio.PlayMusic with loop as false would force the song to not loop whenever played with Audio.LoadFile

Fixed a bug where the variable waves will be set to an empty table on encounter start and after a wave ends, and Wave is nil at encounter start. The intended behavior is that the variable Wave should be set to an empty table in these events, rather than waves.

Fixed sprite.Dust forcing sprite objects to move to (0.5, 0.5) pivot

Changed the <wideness> tag in Speech Bubbles to <width> for clarity (but bubbles with only <wideness> set will still work the same)

OnHit and Update no longer execute in the reverse order as they did in v0.6.3

No more error message when using CreateLayer if a sprite layer already exists

Fixed calling State in DefenseEnding causing the new state to be entered twice

Fix ability to enter "ACTMENU" with empty command list through State (contributed by @deonix37)

Fixed errors in WaveEnding not providing a script name

Fixed Player.SetMaxHPShift behaving oddly towards the player's regular (yellow) hp

Fixed a bug where reviving the player through BeforeDeath cancels invincibility frames they would have received

Fixed a bug where setting the Player's hp to 0 or less in BeforeDeath would remove the player

Fixed using State with some states immediately in EncounterStarting sometimes leading to huge errors because the battle text manager didn't have a font set yet

Fixed text effects in BattleDialog and encountertext persisting into other game states

Fixed an infinite loop when placing a single [ at the end of any Text Object's text

Fixed a compatibility problem where [waitall:0] worked in Unitale but froze text completely in CYF

Fixed a bug where using [health:kill] from BattleDialog would move the battle TextManager to a different scene entirely and have it be invisibly typing and producing sounds even in the mod selection screen

Fixed [lettereffect:shake] not returning letters to their starting positions after each frame, causing them to fly away infinitely

Fixed a bug where giving a text object a sequence such as {"[instant]ONE", "[instant]TWO", "[instant]THREE"} would always instantly delete the text object when going to the next line

Fixed a bug where using SetFont before SetText would ignore the SetFont call

Fixed a bug where using [func:x] to call SetPause on a text object would still show the next character, regardless of speed

Text.SkipLine() now takes playerskipdocommand into account

Fixed the second argument in error(message, level) being completely ignored. (ixjf on GitHub: One, Two, Three)

Fixed a bug where using debug.getinfo(n, "l") - where n is any number - would still only return the line number as if n was 1

After 3 years, error messages now properly display the name of the erroring file instead of chunk_2

Fixed debug.getinfo(..., "S") not retrieving the name of the source. It can now properly retrieve the name of the current lua file

Fixed a bug where some string library functions would match all characters that have the same lower byte as the character you are trying to match. (masaedw on GitHub)

Added the utility functions Event.Exists, Event.GetSpeed, Event.isMoving and Event.isRotating

Added General.EndDialog, which can be used from parallel process event functions to forcefully close the dialog box at any time

Added Player.ResetMaxHP() which resets the player's max hp to what it would be based on their LV

You can use a second argument in General.EnterShop() to skip the fading screen transition

The second argument for General.SetBattle has been changed to a string. Use it to make the battle start animation play out normally, play out fast like Undyne's sequence in Undertale, or enter the battle instantly with no transition!

You can use an argument in General.Save() to instantly save the game without the player's knowledge

Added support for playerskipdocommand in both Event scripts and shop scripts

Misc.ResetCamera() resets the camera to the player's position in the Overworld instead of moving the camera to (0, 0)

Added a more descriptive and helpful save file tester for CYF:
If you have an incompatible Overworld save, you can now press "R" on the error screen to remove the save file without needing to remove it manually

Changed the way FailSell works, because it now has 2 error cases, not just one.

Even though CreateSprite was said to be added to the Overworld in CYF v0.6.3, it actually wasn't. So it's been added. For real this time. ಠ_ಠ

Even though CreateText was added to the Overworld, it created the text object in a completely different scene than it was supposed to, so it was never seen anyway. This has been fixed, too.

Fixed General.Save()'s undocumented boolean argument freezing code execution if used

Fixed the overworld text manager always keeping the last effect applied through [effect:x]. Now it resets automatically whenever using your menu, calling General.SetDialog, and calling General.SetChoice

Fixed General.SetChoice changing the overworld text manager's character spacing even after the choice dialogue has ended

Attached Debugger to Overworld camera when using Misc.cameraX, Misc.cameraY and related functions

Fixed General.GameOver behaving strangely with no arguments

Fixed Player.SetHP(0) erroring instead of triggering game over

Fixed Player.GetMaxHP() returning only the max hp offset instead of the player's total max hp

Fixed Player.SetMaxHP() being able to push the player into negative hp

Fixed Event.Rotate always assuming its argument waitEnd was set to true, even if it was set to false

Fixed shops not having a debugger and, as such, making your FPS display stuck on screen if you press F9, and making DEBUG useless in Shops

Added the new function EnableDebugger, which can be used to forcefully toggle the debugger's functionality, and force-hide it!

Added a fourth argument to Player.Hurt, which can be used to disable sound created by the function. Useful for, say, starting the player's invincibility frames silently

Added Text.SetAnchor (NOT Pivot) for simpler use with parenting

Added Text.GetLetters(), which generates a table full of sprite objects you can use to manipulate a text object's individual letters!

Text objects now call the new Game Event OnTextAdvance when advancing, if possible

The Game Event BeforeDamageValues now can have an argument which represents the amount of damage the enemy is about to take, but before the damage is applied, unlike in HandleAttack

Added the Game Event OnTextAdvance, which is run whenever a text object advances its text, in whatever script it was created in

CreateLayer now returns a boolean representing whether the layer was created successfully, instead of erroring

Misc.WindowWidth and Misc.WindowHeight are no longer Windows-only! They can be used to calculate the amount of pixels that are shown inside CYF, including in wide fullscreen, as well as the level of scaling applied to CYF when being drawn to the window.

The byte editing mode added in CYF v0.6.4 has been replaced with the most direct solution possible. File.encoding has been removed, as well as the "b" file opening mode. In its place are the new functions File.ReadBytes() and File.WriteBytes()!

Added Map.GetName() to the Overworld, used for getting the name of the active map

Added Map.GetSaveName(mapName) to the Overworld, used for retrieving the save point text for a given map

Fix object buildup when enemies die, or when calling sprite.Dust

If a monster's font variable points to an invalid font, the default monster font will now be used instead of erroring

Fixed Misc.StopShake() having no effect (since CYF v0.6.4)

Fixed the [health:x,y] text command not updating the health bar when used in battle

Fixed the [lettereffect] text command persisting after a line of text in the Overworld and in battle. It now resets to "none" after every line of text.

Fixed [lettereffect] not applying to letters that get skipped over by the player, with the [instant] and [instant:allowcommand] commands, and text.SkipLine()

Fixed [lettereffect]'s version of "twitch" taking an absurd 5 seconds (at minimum) for each letter to start twitching, per letter

Fixed [name] disappearing entirely instead of displaying the player's name as intended

Fixed engine error when calling Text.SkipLine() if script did not contain playerskipdocommand = true (since CYF v0.6.4)

Fixed engine error if using Text.GetTextWidth() while the text object is given characters not supported by the font file. Also applies to the automatic line break system in battles and in the Overworld (since CYF v0.6.4)

Fixed strange behavior involving Text.Remove() and a resulting engine error

Fixed Text.layer throwing an engine error most of the time when read

Fixed a bug where removing bullets could cause future bullets to be missing their mask components, and error when attempting to use bullet.sprite.Mask (since CYF v0.6.4)

Fixed an error screen when trying to use Player.sprite.Mask (since CYF v0.6.4)

Fixed sprite.animationpaused, sprite.currentframe, sprite.currenttime, sprite.totaltime, and sprite.animationspeed being unusable on Overworld event sprites (since CYF v0.6.4)

Fixed the Overworld text box being potentially covered up by Screen.SetTone and similar functions, when selecting "Use" on an item in the inventory

Fixed animated mugshots remaining active in future text boxes if they hadn't yet stopped their animation (such as by skipping the end of text with [next])

Correctly reset [charspacing] and [linespacing] in the Overworld's text box after a sequence of dialogue/text boxes ends

Optimized the internal Lua code used by CYF events to remove a massive if/elseif block (99 conditions) scanned through EVERY time you run a function from a CYF overworld object (like General.Wait and Screen.DispImg)