AP Pre-Release - (4.9.25) - THE "UPDATE THAT HAS LITERAL MONTHS OF WORK, SO MUCH SO THAT AT SOMEPOINT WE JUST STARTED DOING WHATEVER WE FELT LIKE THAT DAY, AND TO BE HONEST I'M KINDA SUPRISED WE GOT THIS TO RELEASE WITHIN EITHER OF OUR LIFETIMES anyway so how are you doing?" UPDATE!

Ok. I'm gonna be 100% honest. I know I said in the beta11 version that updates wouldn't take this long BUT I swear we made it worth the wait this time.
This bad boy is packing:
On the engine side of things:

• Optimization. So. Much. Optimization. It may be framey now and again for one reason or another, but it shouldn't die after like 10 songs anymore :D

• ACTUAL PROPER DISCORD PRESENCE (Now you can finally stop telling your friends you're playing psych)

• Blazin now uses the proper stickers when transitioning

• Added compatibility for the FridayLight Launcher

• You can now actually go into fullscreen when pressing your fullscreen keybind

• Removed the secondary Ghost Effect option (Whoops)

• Whatever you do, DO NOT delete fred.

• Spruced the Main Menu up a bit

• Changed how the Titlescreen GF works (mods shouldn't break with the change)

• Added an option to change what the loading screen loads (Off to be directly sent to playstate, song only for the normal loading screen, and everything to load everything for that current mod (CAN BE MEMORY HEAVY!!! BE CAREFUL NOT TO LOAD A GIGANTIC MOD WITH THIS ON!!!))

• The engine now properly clears the memory. You should be able to notice a HUGE difference in memory usage (via Task Manager, because the in-game one isn't 100% accurate)

• Added a secret to the title screen if you type a certain name from DELTARUNE

• The "Sick!" rating no longer has the same accuracy as the "Marvelous!" rating. It is now 0.88 (from 1)

• Crashes from tween-related issues should no longer occur (this isn't a guarantee, but most of them have been addressed)

• Dialogue bubbles now properly adjust to the Dark Mode theme.

• I finally remembered to actually put in the ScreenShot plugin, so now you can press the bindable screenshot button to take a screenshot

• added support for loading .hscript files

• You can now edit the Metadata of a song in the chart editor (it's a little buggy, but as long as you have a properly formatted meta.json in the files already, it should work flawlessly. If it isn't properly formatted, please delete the file so that the chart editor won't have a stroke trying to read it.)

• Base modcharts now (for the most part) work. If a modchart uses NoteTween, it's not gonna work. This is an issue that is being looked into.

• The Random button now tweens to the selected song instead of snapping to it

• Animated Icons should work now, but I have no idea because I forgot if I tested it or not (it was 2 months ago lol)

• Idk if I put this in any of the previous updates or not, but Freeplay (Both of them) now properly updates the sound that plays when you select a song

• The game will no longer delete the entire sustain when hitting a parent sustain note

• Added the Pixel and Pico Breakfast variants, Girlfriend's Ringtone, and Stay Funky to the Pause Menu Music options

• DO NOT PRESS F5

• Gave the snow in the mall more "depth"

• Added some charting SFX (courtesy of SkyDecay Engine) (ONLY IN THE NEW EDITOR!!!)

• Optimized ALL the images

• You can now configure icons via an inserticonnamehere.json file with the following:
  { "type": "INSERTTYPEINALLCAPSHERE" }
  The type can be either ANIMSINGLE (Animation name must be "idle" to work!), ANIMDEFAULT (Animation names must be "normal" and "losing" to work!), ANIMWINNING (Animation names must be "winning", "normal", and "losing" to work!), or ANIMSINGING (Animation names must be "idle", "left", "down", and "right" to work!)
  little side note, ANIMSINGING doesn't work in this update, though it will by the next one!

• FunkinModchart Support (because one modchart system wasn't enough!)

• Added a few achievements because I gotta give the 100% people something to do

• Added a Trash Mode option, which, like the No AntiAliasing option, makes the graphics in playstate worse for the sake of performance. (It is also now required for the "potato" achievement)

• Added an UNO minigame (no, I'm not kidding. It's got custom music and everything. Made by me.)

• Added an alternative crash handler to better catch and mark crashes

• Added a Debug menu (Accessed via F4 or CTRL + D)

• Removed the unnecessary HUD folder that was doing nothing but taking up unnecessary space

• Add the entirety of the Mechanics Mod (shoutout to @EyeDaleHim for letting me do this! Check out the original mod too! It is accessed via the mechanics mod logo, poorly placed in the corner of the Category state.)

• Added the ability to turn off Garbage Collection (removes stuttering at the cost of heavy memory usage. Be careful when turning this off!)

• Added a console that can be spawned via a bindable button (Credits to Codename Engine for that code)

• You can now display a user's username (if enabled) by typing USERNAME in dialogue. (if disabled, it has a built-in fallback, so don't worry about it being weird and just straight up saying USERNAME lol)

• Added a new input: Troll Engine

• You can also use your mouse to hit the notes, but I never actually tested it, so I have no idea if that actually works lol

• Added new Chart Modifier: UNO (it's very buggy but really funny to look at)

• Changed the search bar in Mixtape Freeplay to only update the songlist when the Accept keybind is pressed. This is so that it doesn't lag like a mofo as you're typing

• Added a new loading screen: Mixtape Loading Screen (Courtesy of Yuta)

• Also an option to switch between Mixtape and Psych

• Added the options to the UNO game in the options menu

• Added Window Functions to LUA (The Wiki and Server will be updated with this information later)

• Added Pong Minigame (Nope. Still not a joke. It ALSO has custom music made by me.)

• Added 144p Mode. You're just gonna have to see it for yourself. Nothing I could say would do it proper justice.

• Added Rendered Text (toggleable in options) so that you can see how many current notes are loaded/how many max were loaded/how many are currently in the notes array

• Made it so that exiting the game continues to exit the game if you open a new state

• Added Legacy Lua Settings to the Options Menu

• There is now a 5% chance of getting a random transition when switching menus

• Added a Match 3 Minigame (W.I.P., but mostly done. No custom music yet :( )

• Fixed a small problem with the Small Argument Chart

• Added P-Slice Metadata support (mostly)

• Added another Secret Song

• Added Proper Time signatures (New Chart Editor Only for now!)

• Added a visualizer to Category State (Credit to Novaflare Engine for the visualizer code, btw)

• Fixed a spelling error

• You can now add a videosprite directly behind the HUD (put 'hud' for the addBehind argument)

• Menus with visualizers should no longer crash when the music is null/isn't playing (emphasis on SHOULD)

• Re-added the EX Opponent/ EX Player options fully

• Re-added the balance code to the new chart editor

• Added Modchart Debug Info (Togglable in options)

• Added a Minigame Menu (in the Debug Menu for now)

• Added a third Splash Screen

• Downscroll now works again

• You can now disable the traces for a performance boost, at the cost of, well, no more traces lol

• Added an experimental NotePool option (Does essentially nothing for now)

• Added a Chart Preload option (Tends to not like reloading a song, and can break the notes/game. Recommend to keep this off for now)

• If you're a speciallilbaby you should let the Caregory Menu know.

• Added the option to change the Icon Bop

On the AP side of things:

• Made it so that the freeplay song list only shows songs you have within that sync.
• You can no longer use Showcase Mode as an alternative to botplay and still send checks
• Deathlink should work now (how many times have you heard THAT)
• An issue where the game would falsely flag completion upon entering freeplay has been fixed
• Added some flavor text to the YAML depending on how many mods you have loaded and enabled when generating
• The Hint Category is now fully functional! Any hinted songs will appear there.
• Traplink Support (It'd be rude of me to reveal everything >:))
• LOCALHOST SUPPORT!!! (idk why this wasn't a thing to begin with)
• You can now import weighted YAMLs (even though you really shouldn't be using one in the first place)
• Fixed the Streamer Vs. Chat and Tutorial Trap weights being swapped (Don't ask how that happened, I still don't know)
• Experimental Compressed Websockets (I'm pretty sure it doesn't work yet, so I personally recommend keeping it off for now)
• CUSTOM AP ITEMS! (Read the docs in the CustomEx branch to learn how it works)
• Added the UNO Challenge Trap (no, I'm still not kidding)
• Added the Pong Challenge Trap (Also still not a joke)
• Added the Song Switch Trap (Like the Tutorial Trap, except it's special songs added exclusively for this trap)
• Added two new items: Pocket Lens and Extra Lives
• Added new AP Menus (and an option to switch between them and the old menus)
• You can now set your Starting/Victory songs
• Added the Max HP Down Trap (and yes, you can lose max health without the extra health)
• Combo/Accuracy Requirements now actually work
• There is now a pop-up that tells you what items you've sent
• The coloring for the songs has been fixed
• Pressing quit no longer closes the game, as closing the game is no longer required to leave AP Mode
• Added the Resistance Trap (Don't let her replace you, or she'll slowly kill you)
• Added a new filler item: PONG Dash Mechanic (Only exists if the Pong Challenge Trap is set to exist)
• Added the ability to turn on and off the Base, Erect, Pico, and Secret songs

This was quite a monster to put together, and with all the IRL stuff that's happened, we're lucky to get this update out as soon as we did. That said, however, we hope you enjoy this update.

Chances are, upda...

FNF Emergency Release

Update README.md

Added the link to the wiki page

AP Pre-Release - (4.8.2) - THE "Sweet now I don't need to have 3 trillion checks" UPDATE!

Yes, yes, I know I'm so creative with my update naming.

Anyway, as the title states, I've finally figured out the thing literally every other rhythm game AP figured out years ago: SONG LIMITING!
now you won't have to worry about a giant list of checks because now you don't have to play every single one of your songs >:)

Oh yeah, here's some other things too:

• Fixed the transition back to the freeplay menu not working after you finish a song (my bad)
• Added a Pride Month effect in the main menu
• Dark Mode (You can thank me later)
• Added the BG image to Story Mode
• Added a new secret health mode
• Added a few more achievements
• Added back the secret splash screen (1% chance)
• Fixed closing the game having a chance to kill you instead of actually closing
• Added a toggle to turn on and off time-specific events
• Updated the windows.bat file so that you can actually compile the engine lol
• Added a sound to the archipelago popup
• Added a "Max FPS" option
• Fixed a few more tweening issues
• Modified the FPS limits
• Fixed the winter horrorland intro cutscene
• Added a "Reset All Achievements" keybind (Shift + R)
• Added a small bit of text at the bottom of the achievements menu so that you know you even can reset the achievements
• Fixed the difficulty select in Mixtape Freeplay changing to Normal if you go backwards
• Fixed the eggnog camera events
• Added snow to the Evil Mall
• Added a small ranking display on the bottom left of the screen during gameplay
• Re-added the "Marvelous!" hit window setting (whoops)
• Fixed some capitalization errors that made some songs not show up during AP
• Fixed there being 2 Abots during Blazin'
• Added Date-Specific LUA callbacks (Will be added to the wiki)
• Made the speech bubble dark mode when the dark mode theme is active
• Fixed the big pixel note not playing the right animation
• Fixed the notes being broken when selecting the Default noteskin in settings
• Fully disabled botplay/Showcase Mode during AP Play

Now that all this fun stuff has been added, the next update will most likely be pure optimization, as this engine's getting kinda beefy, and we don't want it breaking when we're just getting started.

See ya next update!

oh, and here's the full changelog because some of you guys like knowing this stuff: beta11...beta11.5

AP Pre-Release - (4.7.0) - THE "FIX FOR THE BIG BOY UPDATE THAT TOOK SO LONG I EVENTALLY ADDED TOO MUCH STUFF FOR IT TO JUST BE A BUGFIX UPDATE AND THEN PROCEEDED TO WAIT LONGER AND JUST MAKE IT A MAJOR UPDATE SO HERE WE ARE" UPDATE!

Yeah, sorry this took so long.

But hey, as a reward for your patience, you get:

• Fixed the majority of the Tween Errors (if you still get them, report them, and then turn on Ignore Tween Errors in the settings)
• The music shouldn't stop when returning to a menu
• Stabilized the video player
• Added the P-Slice camera movements to the songs that had them. Makes em more lively, personally
• BF is actually censored now lol
• Re-added all of (I'm pretty sure all of) the base game cutscenes
• Added some P-slice events (Vslice Scroll Speed, Set Camera Bopping, Target Camera) (I haven't added them to the chart editor yet, this was purely for compatibility sake atm)
• Modded ratings actually work now
• The visualizer is now actually behind the healthbar and icons
• Added snow to the mall (not the evil variant)
• Changed the look of the FPS text
• Selecting and saving a file no longer crashes the game randomly
• Added a tab in the New-styled chart editor: Metadata (I bet you'll never guess what it's for)
• Mania now (as far as I'm aware) is now 100% functional
• Base psych modcharts are now compatible with the engine (info on that provided below)
• The menu visualizers should no longer crash the game if there's no music playing
• Added a bunch of new settings (more below)
• Mods no longer run globally by default (idk WHY psych does that??)
• Added more achievements (you're gonna have to see what they are for yourself)
• Accurate Full Combo actually registers properly during gameplay
• Added the rest of the health modes
• Added the Album Photos and Difficulty Stars to the Mixtape freeplay menu
• Set the keybind to exit the ranking substate to SPACE
• Remembered to add the updated pixel icons

Archipelago

• The default settings actually work now
• The secret songs register properly now

The new settings are as follows:

• Optimized Holds
• Hold Subdivisions
• Draw Dist. Mult
• Ghost Effect
• In-Game Rating
• Start Hidden

I'm not sure if I got everything, but I think I got most of em. Enjoy!

(and for future reference, bugfixes will NOT take this long lol)

Full Changelog: beta10...beta11

AP Pre-Release - (4.7.0) - THE BIG BOY UPDATE!

There is ALOT that we've done for this update. So I'm gonna list as much as I can remember:

Engine Things:

• Adjusted the Tabi health drain
• Random Playback can now be even faster
• April Fool's now only triggers on April Fool's
• The text shouldn't have a stroke anymore
• Sustains have once again been improved
• Added the AudioSwitch Fix
• Fixed stickers.....again......
• The memory usage should be a bit better (and by that, I mean it shouldn't be as laggy)
• Added some new Lua Variables: PsychVideoSprite, FNFWeeklyVideoSprite, and VideoSprite as well as the newShader function from Troll Engine
• If a video plays instead of the usual game over, it should do this properly now
• Added a toggle to show all of the mods as a separate category (Press CONTROL while in the Categories Menu)
• Fixed most of the APNote weirdness
• Got a new Pixel Marv! Image (Thanks to RazzoDazzee for the amazing art!)
• skipText has been changed to skipTxt for consistency's sake
• Added Pitstop 2
• Fixed the ConvertMania chart modifier
• You can now set the category of a week in the Week Editor (I thought I already added this lol)
• You can also create custom categories by typing in any name in the Category textbox
• You can also add multiple weeks to multiple categories by adding a comma in between the category names
• Fixed the keybinds menu being weird
• Finally slightly updated the README
• Fixed the Enable/Disable Mods button
• Added the option to turn off the APWorld check (I got annoyed by it)
• The opacity bug should be fixed
• The notes shouldn't cause as many lua panics now
• Added a warning to the GPU Caching setting
• You can now customize how the Skip Intro works in the Mixtape Settings setting
• Added Menu Visualizers (Not all menus have it!)
• Added healthbar visualizers
• Both can be modified and toggled on/off in the Mixtape Settings settings
• Added the old chart editor, which can be toggled via, you guessed it, the Mixtape Settings setting
• The file dialog to save files no longer crashes the game
• Modded sticker compatibility has been added
• Added the Lil' Buddies from FPS Plus (because what engine doesn't have them at this point)
• Added a toggle to activate the Lil' Buddies or actual characters in the New Chart editor (Hasn't been added to the old one yet)
• Added the Sticker Test debug menu as well as an XML Editor menu to the Debug Menu
• Added the V-Slice Volume Tray
• Added the ability to customize the volume SFX (Take a wild guess where this setting is)
• Added a new Freeplay menu: an OSU-themed freeplay! (Can be toggled you-know-where)
• Added Editor Music! (You know where to find this setting by now) (Doesn't exist in the old chart editor for now)
• The notes in the New Chart editor now have note textures for the sustains
• Added song MetaData! (A small instruction guide will be added at the bottom) (Only affects the OSU menu and PlayState for now)
• The notes will now match the opacity of the strums if the strums are less than the notes
• The main options menu now scrolls to accommodate for mode options

Archipelago Things

• The game shouldn't die if you decide to be impatient while going into freeplay after just connecting
• Introducing: NOTE CHECKS! Hit the dark notes and beat the song to get the checks! Now you can select how you wish to receive checks!
• If you have both Song Completion and Note Checks, if you miss a check, the song will turn grey until all checks in that song have been cleared.
• Fixed(?) deathlink being a lil bastard
• Modified how the Items work so now they should break less
• fixed the game not goaling if you clear your goal song
• Fixed ghost chat not triggering most of the time
• Ghost chat now has more things to throw at you >:)
• Tutorial Trap should also work properly now >:)
• Max HP Up and Shield are no longer considered filler, and are thus able to actually be toggled on and off
• Speaking of which, the items and trap weights actually work now
• Added Pitstop 2
• Added Nothing (Literally! This is temporary until we come up with other filler ideas)
• You can now Hint easier by pressing H on the song you want to hint (you might have to press it twice, as it's kinda finicky for some reason)
• The ticket counter now shows Hint Points Available, Hint Cost, and the Debug Keybinds
• Added the option to change the button to open the in-game chat
• Ghost chat can no longer randomize your note positions
• Ghost chat can no longer swap your stums to the opponents or make you play both your and the opponent's notes
• The game shouldn't hydra when closing it while in a session
• Added more safety measures to the YAML generation
• Both Freeplays are fully compatible with Archipelago
• The install APWorld button will now be gray if your Archipelago installation cannot be found. If your archipelago is installed on a different drive other than your C drive, use the Change AP Location button to adjust where the engine should look.

Small Metadata guide for those interested:
Make a .json file called "meta.json", and then copy the following into it:

{
    "song": {
        "name":"Song Name Here",
        "artist":"Artist Name/Names Here",
        "charter":"Charter Name/Names here",
        "mod":"Mod name Here"
    },

    "freeplay": {
        "bg":"menuBGBlue",
        "album":"NoCover",
        "ratings":{ }
    }
}

Replace menuBGBlue with whatever you want the BG to be. Replace the NoCover with the name of the album image (IMAGE MUST BE 262x262)! The ratings are formatted like this: "difficultynameinalllowercase": 1, where one can be anything from 0-20.
This info will be added to the Wiki page on a later date.

Hopefully I didn't miss anything important lol

Well, I told you this update with a big one. Props to anyone who actually reads all of it.

Big Butt-Behind list of things that have changed since the last release according to GitHub: beta9...beta10

AP Pre-Release - (4.6.0) - The Most Stable Update Ever

Honestly? I don't even need to bother telling you what's changed. Just know it's the best we've ever done.

what? you wanna know anyways? fine, I'll give you a smidge of what's in store...

• Added some "AP Items"
• Added a menu music toggle. You can now switch between different menu songs (custom songs planned)
• More of the menu's now bop to the current menu theme playing
• Added the new Menu Theme, "TitleMania"
• New Logo!
• Anchored the Cause of Death to the top-right of the screen
• Sustains should be better now
• The "Tabi" health system now properly represents your extra heath
• Health now shows on the Score text
• Fixed tutorial trap...again...
• Freeze has also been fixed
• The lil characters now change depending on the actual character in the chart
• LINUX & MAC BUILDS! (untested but hopefully they work. Will come out later in the day)
• Lag should be much less promenant (in playstate. I make you no promises anywhere else)
• AP now has a popup for when a countdown is happening

and much more, but I'm not gonna tell you. and NO, it's NOT because it's april fools, this JUST SO HAPPENED to come out on the same day, and I have NO IDEA what you could be hinting at.

anyways enjoy the update

Full Changelog: beta7...beta9

AP Pre-Release - (4.4.0)

• Actually functioning input (You can change the input behavior in "Mixtape Settings"; currently, there are only 3. More are planned to be added in the future)
• Fixed the installed not opening the game correctly when it's updated
• (Archipelago) Fixed naming issues so that base game song checks should be sent properly
• The Cause Of Death is now locked to the top-right part of the screen in the Game Over screen (This will be way more fleshed out in the future)
• Updated the windows.bat file actually to contain everything needed to compile the engine
• fixed VideoSprite killing the game when it tries to destroy itself
• Pixel Notes should actually work now
• Custom noteskins should function somewhat better now
• The note color option should work now (pixel notes are still a bit broken for now)
• (Lua and Hscript) Added a makeVideoSprite function to both Lua & HScript (Mods that have their own script for this shouldn't interfere with the function, but if they do, deleting the script should fix it)
• (Lua and Hscript) You can now set a gameovervideo in scripts (Thanks to the FNF Weekly team for this)
• The lightning effect in the erect remix should be smoother now
• Added the image for the "Marvelous!" rating for the pixelUI
• You can now change the Icon Bounce (Only base game and Mixtape are selectable atm. More are planned to be added later on)
• New mode: Mania Mode: It's literally just the hud (for now...)
• More pause screen music has been added
• You can now turn on and off Username Detection (This is a setting for something planned later down the line)
• Disabled the LoadingScreen Hscript for now (it omega bricks the game for some reason)
• Added a Health System Switch
• Added a handful of new events (Change Mania, Silhouette, Save Song Posititon, False Timer, etc.)
• you can now skip the intro of all freeplay songs
• The BG for the game over is now permanently black (unless you add an image ontop of the nonexistent background, obviously)
• The stage mechanic now defaults to off for modded songs (an event to trigger it is planned so that mods can still use the gimmick)
• added a version watermark to the bottom of the main menu
• Updated the Archipelago button a bit

Yeah there's a lot lmao

Full Changelog if u wanna see ALL of it: beta6...beta7

AP Pre-Release - (4.5.1)

Engine:

• Checkboxes should no longer make the cursor stuck in the grabbing animation
• Fixed beat battle 2 still being dark when skipping the intro
• New feature: Metadata and intro credits (More info on how to use this will be made later on)
• Added the Week 3 Pico Mix cutscene

Archipelago:

• The chart modifiers should no longer get stuck
• Made the tutorial trap more "effective"
• The Fake Transition should no longer restart the song
• Removed the "Normal" modifier from the list of modifiers in the Chart Modifier Trap
• The "You got a ticket!" notification should no longer spam itself every time you enter freeplay
• More of the SvC Effects should work now
• You can now have more tickets then required and still be able to play the goal song
• Removed some traces so that it should run faster now
• The goal song now actually triggers the goal
• The secrets should work better now

Just a quick patch.

Full Changelog: beta8...beta8.5

AP Pre-Release - (4.5.0)

Engine Stuff:

• made the cursor less obnoxious
• Multi-key! (1-18K)
• added Chart Modifiers
• Opponent & Both side mode (A bit buggy, will be fixed in a later update)
• (Hopefully) fixed downscroll resetting sometimes
• Added a few modifiers (Wiggle)
• LEGACY LUA MODE (can be found in the sub-menu in Freeplay/Story Mode)
• Note alphas should work better now
• Added two new health systems: Kade & Tabi
• Added more events
  Archipelago Stuff:
• ITEMS AND TRAPS! (It'll be at the bottom of the change log)
• Pressing "Quit" During APMode shouldn't break the game now
• There is now more than one check per song
• Better APworld checking
• The secret songs should work better now
• Fixed Blazin crashing the game when sending a check
• There is now an in-game ticket tracker

New Items include:

• Ticket: Collect enough of these, and that final song is all yours. You still have to find it first, though.
• Shield: Prevents death from 0 hp and Blue Balls Curse, as long as you don't run out! Can't save you from DeathLink, though.
• Max HP Up: Upgrades your Max HP. Comes in handy, and is at least nice to have.
  New Traps Include:
• Blue Balls Curse: Kills you instantly. Even in freeplay. Also triggers DeathLink, so be careful!
• Fake Transition: Fakes Closing the game...or at least I think it does...
• Streamer vs. Chat Effect: Activates a random effect. What? You didn't think I was gonna list them, did you?
• Ghost Chat: Streamer vs. Chat Effect, but every 5-10 seconds. May the chat have mercy on your soul...
• Tutorial Trap: Yeah this one's pretty straightforward. I'm so sorry if you get this one.
• Chart Modifier Trap: Sets a random modifier when starting a song. again, pretty straightforward

Getting the items/traps working was a nightmarish, but fun process. Expect a few bugs with them, as they aren't perfect...yet...

Full Changelog: beta7...beta8

AP Pre-Release - (4.3.1)

• Fixed APMode not opening the Rank Results Screen when completing a song
• Songs now properly update outside of the All Category
• Actually set the internal version properly
• Update music should work

Full Changelog: beta5...beta6