FriendShapes Online Manual

                                             FriendShapes  v 1.2.2
=============================================================================================

Anniversary art by KitterCyat!

Thank you very much for purchasing FriendShapes, a unique atmospheric horror lite-RPG with some rouge-lite elements where you try to reason with strange sometimes hostile beings, it's approximately 7-10 hours in length and took over 3 years to develop in RPG Maker MV

For more, check out Era's End Entities; an Analogue Horror set in the same world as FriendShapes

Plus there's FriendShapes Merch available here!

======
Contents
======
1. Tips
2. Help
3. Encounters in Detail
4. Save Migration
5. Known Issues
6. How to Fix Crashes Due To Missing Files
7. Change Log

==============================================================
                                             1. Tips
==============================================================

Speeding up:
- You can increase how fast text is displayed both in and out of Digressions via the Options Menu
- You can toggle FastForward Mode on and off during Encounters to make the pauses shorter by pressing Shift/X on Joypad

Starting out:
- Stock up on Items, some friends outside the Digression may give you some if you talk to them
    - Talking to TradeMark and letting Hifive explain Digressions will net you some free items
- Items usable for interacting with Shapes from your Inventory: Cloth Rag, Niap, Pain, Warmth of Another

Digressions:
- Keep your stats up when continuing deeper into the Digression; text events can damage your stats and end your venture prematurely without warning
- Running out of Wellbeing, Sanity or Focus in a Digression takes you back outside, while the items you used are gone, any Credit you earned or other items you found are still yours

Encounters:
- Withdrawing isn't (usually) the same as running away
- For a variety of results during encounter interactions:
    - Most usual interactions can be used at least twice before returning the same result - baring unique reactions to a Shape's previous action (see below)
    - Using a specific interaction in reaction to Shape's last action may result in a different outcome
    - Context Actions may be gained during an Encounter or be available from the start - a cog animation will play in the bottom right of the screen if a new Context Move is available
    - Context Actions may disappear if the window to use them is lost
- Trying new things in an Encounter increases FOCUS and CREDIT reward
- A few Shapes may need to be waited out while trying to mitigate damage sustained to yourself
- Usually if there's no Focus heal for an action, then repeating the action will yield the same result, (unless it becomes a reaction to a Shape's specific last move)
- Most Shapes have 2 different paths (Orange path and Blue path, shown at the bottom left of the Encounter screen) that fill up from specific actions or reactions, some Shapes have additional, hidden alternate ways to end their Encounter as well. There is a noise and visual effect on the bottom left of the screen indicating if Blue or Orange has been filled, along with two boxes that show their progression.


==============================================================
                                             2. Help
==============================================================

Some information for those that may be unsure of what to do or wish to know the game loop better:
- There is a autosave feature, but it only happens half-way through a Digression - to save your game properly, speak to the Scape who is left of the gate in the central hub
- Losing does not end the game, instead returning outside of the Digression, you keep the items you found but don't have any you used returned to you
- The game can be played with most gamepads, keyboard and also mouse (using mouse for navigation via clicking is not recommended due to the 3D elements)
- There are in-depth Controls instructions within the Archive option in the pause menu after the intro (assuming you don't weird Edmonton out too much in your first meeting)
- Dash is disabled during the introductory sequence
- There are two Digressions in the West, others to the East, which you'll be allowed to traverse after completing at least one Digression
- Digressions tend to be ten areas long with text events between them

- Holding Enter will skip text fast, holding Shift will speed through it so fast you won't be able to read it
- If you are having trouble, try Assisted Mode; it grants a status condition that heals every Exchange in Encounters as well as traversing in the Digressions


==============================================================
                                             3. Encounters in Detail
==============================================================

In case you're having a hard time coming to grips with the Encounter system:

The order of events in a Exchange (turn)

1. The player chooses what they want to do, from the usual choices to a Context move to using an item (and choosing to use the item on themselves or the Shape, if the item allows)
2. Player chosen action happens first, depending on the current state of the Shape, what happens may be different than what would normally happen (depending usually on the Shape's last move)
3. If the Player Action affects the Shape in a way that increases or decreases their Blue or Orange path, a sound will play, along with an animation on the bottom left of the screen
4. The Shape's action happens, this can be random, part of a set sequence or a reaction to the player's last move. This can cause damage or a status effect
5. If neither of the Shape paths are completed, the Player takes the ambient Shape damage (shown on the right of the screen)
6. If the Player was at low sanity, causing the room to start spinning and have healed their Sanity enough this Exchange to recover, the room will stop spinning at this point
7. It becomes the Players turn once again.

The object is to find ways and means around each Encountered Shape, figuring out ways to placate or otherwise get around them to keep moving through the Digression.
This is achieved usually by filling the Shape's Blue or Orange path


==============================================================
                                             4. Save Migration
==============================================================

To move your save file from one version of FriendShapes to another (or demo save file to full release):
    Locate the "Save" folder found in the "www" folder
    Copy and paste it from the older version of FriendShapes to the newest one's "www" folder and let it overwrite any files

    If this doesn't work, try saving in the slot you wish to replace first, then overwrite it with the desired save file

Please note that if you are migrating files from GameJolt or Itch to Steam, achievements will not work - you need to start a new game in the Steam version for achievements to be activated


==============================================================
                                             5. Known Issues
==============================================================

- Slowdown - The game may slow down sometimes depending on your set-up and RPG Maker's general weirdness, be sure to check your graphics card's settings - it's been reported that some systems try to run the game via the onboard GPU rather than your actual card - changing this makes an extreme difference

- Controls - With dynamic 3D cameras in RPG Maker, it may be difficult to align yourself with something you want to interact with, clicking on the object you wish to interact with using the mouse may lead you straight to it, or you may need to hold down two direction keys at once

- Screen Effects getting stuck on screen - taking damage in the overworld while moving diagonally can cause this - try pausing and unpausing to clear the screen (taking damage in the same way while not moving diagonally can also fix this) - My only guess for the cause is that RPG Maker MV wasn't designed for diagonal movement so the damage sequence gets interrupted by the player moving both horizontally and vertically

- Broken Camera - seemingly caused by exiting the game while on a specific map (the one containing a horizontal bridge in Soft Contained Play and elsewhere) then loading another file - this can be fixed by exiting the game entirely then loading your save again

- Options - If the config and/or global file in the www/save folder isn't there, the Shadow Quality option will break and turn off when entering the Options menu in-game, and will not be restorable outside of either changing the option from the main menu or pasting the original Config/Global file back into the folder - don't ask me why this happens I wish I knew and didn't have to replace certain files manually after every deployment

- Encounter Battle Log - Unfortunately there's very little control to be had on the battle log in RPG Maker MV - I can't make it so you can read back on previous messages or even change the font's colour - which I would do if I could, I can only apologise and hope you don't mind it too much that the first encounter with Edmonton may be a bit confusing on who is talking (it's Edmonton monologing the entire time)


!!==============================================================!!
                                             6. How to Fix Crashes Due To Missing Files
!!==============================================================!!

I've hopefully fixed this specific issue but just in case I've missed something, here's the information on this:

I found very late into development that some of the music name files the game has, which have accented or unusual characters, (such as the "í" in Mícheart Jinsil's name,) somehow cause a retranslation by systems that have their locale to a language very different to English - so far Japanese and Russian have been discovered to have this happen - the file's "í" was replaced by a "｡" in the "Mauerbauertraurigkeit Semaphorism (Mícheart Jinsil)" file, and as such, RPG Maker couldn't find it, as all that was there was "Mauerbauertraurigkeit Semaphorism (M｡cheart Jinsil)"

RPG Maker MV tries to reference files to use and if it can't find the file, it'll crash and tell you what file it can't find and where it should be

I've tried to rename all of the song files that have accented letters in the hopes it won't crash for anyone - but RPG Maker being what it is, (there's no search function that can help me track down every call for each track - and it all needs to be done manually) - so if you do encounter a crash saying a file is missing, you should be able to fix it via duplicating the appropriate file then renaming the duplicate without having to exit the game... it's not the most elegant solution I'm afraid:

- Go into where the file causing the error is located, such as "FriendShapes\audio\bgm"
- Copy-paste the file so a copy appears with "- copy" at the end
- Rename the duplicate file to what the game is looking for (original names listed below)
- Clicked Retry on the error screen
- Let me know when and where this happened so I fix it

Given I've renamed and hopefully changed every reference instance of the songs there -shouldn't- be this problem anymore unless I missed something, here are the original songs names that I changed in case you do discover one I missed:

Catoptric Tristesse Cafuné (Mr Dac)
Dépaysement (Dimensional Inferiority)
Mångata (The Timeless Chorus)
Mauerbauertraurigkeit Semaphorism (Mícheart Jinsil)
Mauerbauertraurigkeit Semaphorism (Mícheart Jinsil) Intro
Pâro Backpfeifengesicht (A Reflection) Estonteco
Pâro Backpfeifengesicht (A Reflection) Nuna
Pâro Backpfeifengesicht (A Reflection) Pasinteco
Vemödalen (Conceptual Parasite)
Vemödalen (Conceptual Parasite) Intro

I took out all of the accented letters from these tracks and hopefully caught every instance of them being used in the game, but if I didn't, your best bet is to find the file, duplicate it then rename the duplicate to the original name listed above so the game can find both versions of it and continue to work
I left some of the original intro tracks in there as well as the renamed versions as they're very small in file size and it'll potentially prevent some crashes


==============================================================
                                             7. Change Log
==============================================================

v1.2.2 (07/Mar/2025)
Fix:
-   Instance of meeting Jinsil in the Backwoods causing constant "song not found" errors despite it being there (probably the accented i again) - thanks sonicthehedgegod!

Changes:
-   Text now displays at a Game Over, informing if there's an auto save from the current Digression (including if it's at the final area with Assisted Mode enabled) and giving a choice to continue with the items and experiences you had or return to the Title Screen to load an auto-save (Thanks ‪Gravenox13‬ & vantiss!)
-   Added a Autosave graphic to appear in the top right when the game autosaves (including finale areas if Assisted Mode is on and after completing a Digression if the setting is on) - had to do this manually so hopefully I have all instances of it happening

v1.2.1 (27/Feb/2025)
Fix:
-   Spelling & grammar
-   Jumping over a hole in The Backwoods on the right-hand side causing a soft lock (Thank you muuyo!)
-   Fog from previous map of The Final Digression carrying over into a zoomed out area, causing culling
-   Pain not ending a specific Encounter when it should have
-   Blue path being set to 1 instead of added to (Thank you Bits for those last two!)

Changes:
-   Increased time between lines for The Collective for readability
-   Made that one SCP revisit Encounter even more likely... (and hopefully doesn't cause any weird interactions with existing elements)
-   Upped hue and brightness on Hydra's text colour for better legibility
-   Slowed down space between text for Collective, Huh?Man and Abandoned Mascot

v1.2.0 (24/Feb/2025)
Fix:
-   Spelling & grammar
-   Text on picking up a specific File not being consistent
-   Axenic file to be out of frame and blocking your path
-   Era's End Entities Encounter Expert achievement wouldn't count Rejectamenta if their Encounter was completed entirely (thanks to TheFoxyDragon for loaning their save file to check this!) - interact with a Scape or get into an Encounter to trigger the achievement check

Changes:
-   Added more achievement checks for Era's End Entities Encounter Expert and Filing Cabinet

v1.1.9 (21/Feb/2025)
Fix:
-   Moved the Jayedpeg to be in a slightly easier area to see and interact with (I know the camera can be dodgy)
-   3 Files are now collectable (I was sure I put them somewhere but apparently not according to MV's terrible search function) - Lore Achievement should be possible now
-   Bag Maze area in Soft Contained Play camera breaking when loading into it after leaving a previous save and not exiting the game fully (hopefully doesn't break it normally)

Changes:
-   Reaching That One Specific Room now doesn't count as Progress in any Digression now (previously only didn't in The Final Digression)
-   Moved Malsana file from inside a wall you can't see to somewhere a little more easier to find
-   Made various Files to be far more likely to find (previously was chance + requirements - hadn't really planned for achievements when developing so have made chance either Always + Requirement or just quite likely)

v1.1.8 (20/Feb/2025)
Fix:
-   More changes to the Encounter in SCP revisit, hopefully it'll be guaranteed -now- (thanks Starluft for testing!)
-   Era's End Entities Expert Achievement not firing due to The Slasher (Hallways Text Event) switch being missing from the previous corruption (thanks MadHatterBelial!)

Changes:
-   Increased pauses and how long text stays on screen for Blood Shadow Encounter for readability

v1.1.7 (19/Feb/2025)
Sort of Fix?:
-   Made an Encounter in SCP revisit guaranteed in the area they're meant to be found in (as no one's ever encountered them)

Changes:
-   Halved Blue Path requirement of Protoplego
-   Made some pauses in Belarone Encounter longer for readability's sake

v1.1.6 (19/Feb/2025)
Fix:
-   Spelling mistake in the single bit of extra text I added in last time
-   Added dark gradients to the backgrounds for a Encounter in Soft Contained Play for better readability

Changes:
-   Changed the slowest Encounter speed setting from Continental to Glacial to clear up that it's even slower than Leisurely (NOTE: This may have reset your settings)
-   Made some pauses in Soft Contained Play boss a little longer for readability's sake

v1.1.5 (17/Feb/2025)
Fix:
-   Spelling and grammar, and an especially strange one  thanks to MadHatterBelial!
-   Added an extra check for getting the Era's End Entities Encounter Expert achievement that I'd missed - something dangerous in The Final Digression Text Events!
-   Removed testing stuff put on Conceptual Parasite I forgot to remove when re-balancing it (thanks Ultra!)

Changes:
-   Increased cool down between hits in The Hallways from 60 frames to 150 frames in 3rd person, 100 frames to 180 frames in 1st person
-   Added a more obvious point of interest in part of The Final Digression to attract attention to how to leave that area, as well as added more Events along it so it's easier to find

v1.1.4 (16/Feb/2025)
Fix:
-   Spelling and grammar
-     Some achievement triggers were unknowingly lost due to a bluescreen a few days ago that corrupted the game files - after rebuilding the game from a previous version (replaced all files with the current ones), turns out it didn't carry over anything in the Common Events, including some, (but not all??) previous spelling fixes, tweaks, certain achievements AND any additions to the Credits since starting to prep for Steam... so will be rediscovering those as they're reported again - very sorry if I miss someone for the credits especially
This has affected most of the alternative achievements concerning Shapes, as well as the Era's End Entities Encounter Expert & The Filing Cabinet - I have added them back in once more and checked the others - apologies for any frustration caused for this
Huge shout out and thank you to MadHatterBelial for leading me to discover this with their FriendShapes Achievement + Clues Guide!
-   Mr Dac achievement only firing if you'd cleared Digression before talking to him (now it works on returning to him after doing so as well) I can't blame this one on the bluescreen, I just forgot they said something different if you'd already done the Digression before talking to them - Thanks Ultra for helping with this one!
Changes:
-   Increased likelihood of a specific Encounter on Soft Contained Play return
-   Increased maximum Blue path for Conceptual Parasite to give players a bit more time to experiment in the Encounter
-   Door to The Hallways now requires 3 Digressions to be completed instead of 2 (let me know if this breaks anything please!)
-   Shifted the Autosave on Digression Completion to the Options menu, starting on Off rather than being built in

v1.1.3 (15/Feb/2025)
Fix:
-   Some spelling mistakes and grammar
-   Achievement on Rejectamenta not triggering
-   Hopefully Edmonton's future-sight concerning Mr Dac's approval

Changes:
-   Assisted Mode now Autosaves just at the final area of each Digression
-   Increase pause times between text for EgoSystem, as well as some other text and made a hint a bit more obvious

v1.1.2 (14/Feb/2025)
Fix:
-   Items in a certain area of Axenic reappearing after going in and out of a door/pathway
-   A Mystery Considered's item description not dropping a line where it's meant to (thank you MadHatterBelial for these two!)
-   Added way to get back onto the intended floor level in an area in The Final Digression
-   Encounter Text Speed being changed by Confirm buttons rather than arrows desynching speed
-   Axenic having a area where doors don't work - now if you're not meant to be there, the doors will continue to the next Text Event (thank you vantiss for reporting this!)
Changes:
-   How these are laid out in the text file so better work with all the other places that need hotfix updates too
-   "Message" to "Text Box" in Options to make it clearer it isn't the text Encounters use
-   Removed Quick Reference Guide from Steam Store page as it just refused to load (it was just a pdf that says to check the online manual anyway)
-   Added AutoSave to trigger on finishing a Digression
-   Increased pauses between all Encounter Text speeds slightly aside from the fastest setting
-    Increased battle log pauses specifically for Soft Contained Play's boss, and buffed one the one-time, easy to miss Context move's effect
-    Increased battle log pauses specifically for some of Psych & Belarone's Encounters

v1.1.1 (30/Jan/2025)
     -    Fix:
             Soft lock in Backwoods caused by bad RNG with a hole to be jumped over on top of an item (Thanks to bitsbops for discovering this!)
              Visible object that shouldn't be in Backwoods
             Collision remaining after a specific encounter spot in Axenic
             Object in Axenic quarantine area lacking a Direction Fix (Thanks to Ultra for those 3)
     -    Changes:
             Added a note saying that F4 grants fullscreen

v1.1.0 (30/Jan/2025)
     -    Fix:
             Instance of crash on a Axenic Shape from music mislabelling
             Camera not tracking player in final digression in a certain area

     -    Changes:
             Added Scape saves to final digression (Thanks to TheFoxyDragon for feedback on this):
             Rearranged Title Screen, added a Quit button and various linked buttons
             Updated Credits
             Added Steam API and various Nodes as well as Achievements (Steam version only)
             Added description to the hanging beartrap in the Backwoods as it always draws attention
             Added F4 and F5 functionality to Getting Around file (Steam only, will appear on other platforms next patch/fix)

---