Tunic Randomizer 3.0.0

Tunic Archipelago has moved!

The multiworld version of the Tunic Randomizer was recently merged into Archipelago, and will be included in their next release! Thank you to everyone who has been playing, providing feedback, and helping us get to where we are today.

A few important changes:

• This release combines the Archipelago client mod and the standalone randomizer mod into one, allowing you to play both types of randomizers without needing to switch mods.
• This repo will not be updated anymore. Instead, all future updates to both the Single Player and Archipelago randomizers will be found at the original Tunic Randomizer repository.
• If you're updating from an older version of the Archipelago mod, you should delete the Tunic Archipelago folder in your BepInex/plugins folder. Your settings won't carry over, but this should be the last time the settings file gets moved.
• As with previous Archipelago versions, this client version is not backwards compatible, so please use the newest apworld and yaml included in this release.
• YAML files from previous versions will not work with this version, so please use the new template yaml provided.

With all that said, please head over to the new repo to view the release notes for the latest version of the Randomizer and Archipelago Mod!

Tunic Archipelago 1.1.0

More Features, QoL improvements, and Bugfixes

NOTE: As with past releases, this update is NOT backward compatible with previous apworlds, so make sure to update to the newest apworld included in the release download. An error message will now display starting in this version if you start a game while connected to an incompatible room. The apworld is only compatible with Archipelago 0.4.4.

New yaml settings

Logic Options

• Restricted Logic: The same logic as always.
• No Major Glitches Logic: Includes ice grappling through walls/doors in logic, shooting the Western bell from afar (with the fire wand), and quick killing bosses in the logic.
• Unrestricted Logic: Includes all the No Major Glitches logic, as well as using ladder storage to reach places early. Does not include using ladder storage to reach specific chests.

Lanternless and Maskless

• Decide whether the Lantern and Scavenger Mask should be included in the item logic. Turning these on allows for lantern to be shuffled into dark rooms and mask in lower quarry/ziggurat.

Laurels location

• Option to place the Hero's Laurels at a predetermined location, including:
  • 6 and 10 Coin Tosses
  • 10 Fairies Reward

New client settings

Skip Upgrade Animations

• Skips the animation that plays when upgrading stats.

Send Hints to Server

• Automatically records certain hints from ghost foxes in the Archipelago Server/Text Client.
• Also records the randomized shop items as hints when you interact with them.

Clear Early Bushes

• Clears a path through three sets of bushes in the Overworld, opening up the way to the Windmill, East Forest, and Swamp.

More Skulls

• The setting nobody asked for. Does exactly what you think it does.

Arachnophobia Mode

• A dumb idea I couldn't let go of.

AP Config Editor

You can now edit your Archipelago settings directly on the main menu.

Hint System Changes

The Hero's Grave hints have been changed slightly:

• The candle on each Hero's Grave will light up once you have found the item being hinted.
• Once all 6 hinted items have been found, the candles at the Hero Graves will turn blue, and the hints at those graves will change into hints for the six Hero Relics (a random one at each grave)
  

Entrance Rando Tracker

A new tracker made specifically for entrance rando has been created by ScipioWright and can be found here:
https://gitlab.com/ScipioWright/tunic-tracker

Bugfixes

Enemy Randomizer Fixes

• Randomized enemy spawns now work correctly in the Gauntlet.
  • This also fixes an issue where defeating a randomized enemy would mark all enemies of the same type in that area as defeated, causing none of them to spawn in if the area is reloaded.
• Crabs and Slorms now behave properly with the enemy randomizer.

Other Fixes

• Fixed an issue where the red/blue hexagon plinth items and the item on siege engine's head would still appear after being !collected with the collected item setting on.
• Holy Cross chests containing !collected items will now appear as solved and opened when the setting is turned on.
  • Turning the setting off and reloading the area will re-close the chests.
• Changes to the "skip item animation" setting:
  • The manual can now be opened after receiving pages with skip item animations turned on.
  • Flask shards now properly condense into a new potion when the 3rd one is received with skip item animations enabled.
  • Shop items and bomb codes display the popups again with skip item animations turned on.
• Fixed word wrapping for long location names in certain hint messages.

Misc Changes

Ability Unlocks

The abilities you have unlocked are now shown in the inventory screen.

• Talking to a ghost fox that hints at an ability unlock in Hexagon Quest will also record that ability name in this section if it hasn't been unlocked yet.

Save Files

Added a failsafe to prevent certain save files from being loaded, including:

• Saves that don't match the data on the currently connected player/slot.
• Saves that weren't originally made from the mod, such as vanilla save files or saves from the standalone randomizer mod.
• Added an error message if you start a game while connected to a room that is incompatible with the client (i.e. a room made with an older apworld).
  

Other

• Renamed "Bottom of the Well" -> "Beneath the Well"
• The message popups when receiving/sending out items now show the icon of the item being received/sent (for tunic items)
• Save files that are Hexagon Quest will display a Gold Hex icon in the file select screen.
• The in-game time will now be displayed alongside the ending stats summary if speedrun mode is turned off.
• Removed a bush near the East Forest hero's grave to prevent accidentally softlocking yourself there via the holy cross chest.
• The Dath Stone now has an accurate model when it appears as a freestanding item/in item popups

Tunic Archipelago 1.0.0

Doors and More

NOTE: The newest apworld included in this release is only compatible with the preview release of Archipelago 0.4.4. Please update or install that version before generating games. Games generated with older apworlds are not compatible with this version of the client mod.
If you need to generate games using 0.4.3, use the previous apworld and client mod from version 0.0.6.

Entrance Randomizer

Entrance randomization is now possible in multiworld settings (thanks to @ScipioWright)! In this mode, all entrances, doors, teleporters and more become randomly connected to each other! Who knows where you'll end up?

Torch

• With Entrance Randomizer, it may sometimes be possible to enter an area from which you cannot return. For cases like this, the Torch item has been added and is given at the start of entrance rando seeds. Using it will warp you back to the Overworld save statue, allowing you to continue progressing elsewhere.
• When playing without Entrance Randomization, the Torch will also be given to the player when they find the Dath Stone. Using the Torch does not overwrite the warp point of the Dath Stone, allowing you to maintain up to two separate save warps!

Fixed Shop Entrance Option

• This option reduces the amount of shop entrances that can be found in entrance rando to 2, and will always place one of them at the Overworld Windmill entrance.

The above options can be found in the yaml as entrance_rando and fixed_shop.

New Settings

Auto-open checks from !collect and !release

With this setting enabled, checks that were completed via the !collect and !release commands will appear as opened/already picked up, and stat screens that show check counts (such as the inventory display) will reflect this as well. You can enable/disable this setting at any time and the game world will update accordingly on the next scene transition.

Skip Item Animations

This setting disables the item/page popup animation that plays when receiving an item/page, allowing for less interruptions when playing. You will still be notified of which items you receive via the messages in the top-left corner. Can also be toggled on/off at anytime.

Enemy Randomizer Updates

• New enemy types have been added to the random enemy pool:
  • Scavengers that throw either Fire or Ice Bombs
  • An unused Scavenger type that shoots ice bullets
  • An unused centipede enemy
  • An unused enemy called "Shadowreaper"
• Enemies that spawn other enemies or that have multiple phases (Administrator 2nd phase, Voidling spiders, bats thrown by the big skeletons, etc) or now work correctly.
• Excluded certain enemies that are used to reach chests from being randomized, such as the turret in Frog's Domain and the slime in East Forest.

PopTracker Update

The mod now communicates with the Tunic PopTracker pack to autotrack additional things, such as:

• Free bomb code usage
• When the bells are rung
• When bosses are defeated
• What map to display on the tracker based on where you are in-game.

Thanks to @Br00ty as always for working on the map tracker!

Misc Changes and Bugfixes

• The Shop in the Swamp is now accessible during the day.
• The ladder shortcut on the upper level of Swamp (behind the shop) can now be accessed during the day.
• Ice Bombs and Peppers can be purchased from the shop.
• The sword upgrades are now their own items and can be equipped separately from each other.
• True Ending will now trigger on the first visit to the heir if you already have all pages.
• Removed collision on the chest in Maze Cave to ensure you can always get the chest behind it.
• The Slot name will now be displayed on the file select screen for Archipelago saves.

Tunic Archipelago 0.0.6

More QoL Updates and Bugfixes

Reminder: The tunic.apworld file has been updated in this release. Be sure to replace the old one (if you have one) before generating any games. The mod will likely not work properly with games generated on older versions of the apworld, so keep that in mind.

Apworld changes

• Small logic tweaks to make certain checks and locations slightly more accessible.

Releasing and Collecting

• Items can now be directly released and/or collected from in-game after completing your goal by pressing 'r' or 'c' during the end-of-game sequence.
• The goal completion status will now immediately be sent upon beating the heir or interacting with her for the alternate ending, rather than having to wait for the credits to start.

Hexagon Quest

• The number of hexagons needed for unlocking abilities has been updated. Instead of unlocking abilities at 5, 10, and 15 hexagons, they are now unlocked after reaching 25%, 50%, and 75% of the required goal amount (rounded down).
  • Example: If your goal amount is 37, you will unlock an ability at 9, 18, and 27 hexagons.
• Ghost foxes now have a chance to hint these ability unlock requirements to the player.

Enemy Randomizer

• Fixed a bug that caused balanced mode to not work properly in the Bottom of the Well.
• Changed the spawn points of randomized enemies in Gauntlet in an attempt to reduce the chance of softlocks occuring.
• Addressed an issue where enemies wouldn't randomize on the very first load after launching the game.

Misc Changes

• Speedrun Mode is no longer forced on when the game is launched, and the ending stats screen will still appear without it.
• "progressive sword" is now a valid alias for hinting Sword Upgrades in the text client

Tunic Archipelago 0.0.5

Hex Quest Updates + Bugfixes

Hexagon Quest

• The number of required gold hexagons is now configurable in the yaml, and can be set between 15 and 50.
  • This option is called hexagon_goal in the yaml
• The number of extra hexagons beyond the goal amount in the item pool is configurable as well.
  • This option is called extra_hexagon_percentage in the yaml, and can be a number between 0 and 100
  • This number is taken as a percentage of hexagon_goal to determine how many extra hexagons go in the item pool.
    • For example, if hexagon_goal is 20 and extra_hexagon_percentage is 50, there will be 30 hexagons total in the item pool (20 + (50% of 20)) = 30
• The default values for these options are 20 and 50, which is equivalent to how Hexagon Quest was configured prior to this update.

Misc Changes

• Added a button on the title screen to directly open the settings file in a text editor
• Renamed certain items:
  • The "Hexagon" items are now referred to as "Questagons" (i.e. Red Hexagon -> Red Questagon)
  • The Shotgun is now just called the Gun
• Major hint locations will now tell you the location of said hint/item
  • If the hint refers to a location in someone else's Tunic world, it will say the region the item is in
  • If the hint refers to a location in a non-tunic world, it will say the location directly.

Bugfixes

• Level 4 sword can now activate the bridge switches in Ziggurat/Beneath the Vault
• Fixed seeded enemy rando always using the same seed and not changing per game
• Fixed the seeking spell sometimes becoming fixated on the coin wells
• Addressed an issue where receiving sword upgrades would sometimes cause the incoming item queue to get stuck

Tunic Archipelago 0.0.4

Apworld Updates and Bugfixes

Apworld Changes

• Fool Traps have been moved into a yaml setting and are now their own item in the apworld with the trap item classification, so you and other players will know when you are sending a Fool Trap to a Tunic player.
  • Fool Traps still replace money items from the item pool the same as before, and the options are still off (0 traps), normal (15 traps), double (32 traps), and onslaught (50 traps)
  • Fool Traps for Tunic players will appear in-game as a random level money item.

Bugfixes

• Fixed an issue where the mod wouldn't work correctly if the Randomizer folder was missing from the game's AppData directory.
• Reverted a change that allowed the East and West Bells to be activated in unintended ways.
• Fixed an issue where buying your own money item from the shop would sometimes give you more money than it should have.

Tunic Archipelago 0.0.3

Known Issue

If you experience an issue related to not receiving items at the start of the game, you can fix it by creating a folder called "Randomizer" in your game's LocalLow Appdata directory and then restarting the game: C:\Users\User\AppData\LocalLow\Andrew Shouldice\Secret Legend\Randomizer <-- this folder needs to exist

Bugfixes

• Added a failsafe to convert flask shards into a new potion if you get stuck with 3 or more shards in your inventory.
  • This issue is usually caused by receiving a flask shard right before (or during) a scene transition. The failsafe is checked after every scene transition so the issue should fix itself right away if it occurs, but if not then going through an additional load zone should fix it as well.
• The Level 4 sword can now hit the East and West bells
• Fixed a certain holy cross chest that remained active without having holy cross unlocked
• Fixed time of day not resetting on the first load after dying to The Heir.
• Fixed a small logic error in the apworld.

QoL Changes

• The Shop in the Swamp is now always accessible.
• The settings file now lives in the same folder as the mod (BepInEx/plugins/Tunic Archipelago) to make installation simpler.
  • A settings file template is included in the release but the mod will also create one if it doesn't already exist.
• Removed the "Reload Settings" button from the title screen. The "Connect" button will now automatically detect changes to the settings file and apply them before connecting.
• Changed the hero relic item popups to match their freestanding blue colored appearance.

Tunic Archipelago 0.0.2

Some Updates

Note: This release is not compatible with previous versions of the Tunic apworld. The newest compatible version of the apworld is included in this release download.

Changes to the apworld

• Sword Upgrades are now their own items called Sword Upgrades.
• Item groups have been created to make certain things easier to hint for.
  • Ability pages can be hinted by ability name (prayer, holy cross, ice rod)
• Updated slot data to account for start_inventory_from_pool so hints don't break
  • Items that have been taken out of the pool will say they are in "Your Pocket" if they appear in an in-game hint

Non-Tunic Item Changes

• Item will be colored based on rarity:
  • Green for Filler Items
  • Blue for Useful Items
  • Gold for Progression Items
• Fool traps will also appear differently to those with a keen eye

Other Changes and Bugfixes

• Mailbox hint now matches the "First Steps" hint in the single-player randomizer.
  • Will tell you a location in Sphere One that contains one of your progression items or a random Advancement for another player.
• The Old House Key will now appear as a turquoise color, similar to the key from the old Tunic demos.
• Reworked how the incoming item queue is handled in an attempt to prevent items from becoming lost or desynced
  • This is likely still not perfect, so if errors continue to happen please report them.
• Added an experimental fix to prevent enemy randomizer from breaking
  • This may also not totally solve the issue, so if enemy randomizer still breaks after this update report it as well.
• Fixed hints not working when playing with non-tunic games
• DeathLink now works correctly

Tunic Archipelago 0.0.1 Beta

First Beta Release

Tunic apworld: https://github.com/silent-destroyer/tunic-archipelago/tree/tunic-randomizer

This is the first release of the TUNIC Randomizer Archipelago client. The mod is still very much work-in-progress, so expect bugs to occur and things to potentially not work properly. The easiest and quickest way to report bugs is to message me (silentdestroyer) directly on Discord.

For information on all of the features and settings available, check out the TUNIC Randomizer website.

Included in the download zip is a template yaml settings file that can be used to generate a game locally (on Archipelago 0.4.2).

Known Issues

• Items may eventually become desynced and/or not received in the proper order. The issue is still being investigated for a cause but appears to be uncommon.
• Death Link currently doesn't work and may crash the game if enabled.

IMPORTANT!

If you have the TunicRandomizer.dll from the single-player version of the randomizer, you MUST uninstall it before playing the Archipelago version, or else the mod will not work correctly.

Installation

• Must use a compatible PC version of TUNIC on the latest update. The mod has been tested on Steam and PC Game Pass versions, but should realistically work on any PC version (including Steam Deck).

  • If playing on Steam Deck, first follow this guide to setting up BepInEx on Steam Deck via Proton.

• Download the correct build/version of BepInEx from here: https://builds.bepinex.dev/projects/bepinex_be/572/BepInEx_UnityIL2CPP_x64_9c2b17f_6.0.0-be.572.zip, or alternatively search for it yourself by going to https://builds.bepinex.dev/projects/bepinex_be, finding Artifact #572, and downloading the "BepInEx Unity IL2CPP for Windows (x64) games" build.

  

• Extract the zip folder you downloaded from the previous step into your game's install directory (For example: C:\Program Files (x86)\Steam\steamapps\common\TUNIC)

  • For the PC Game Pass version, extract the zip into the "Content" folder, i.e. C:\XboxGames\Tunic\Content

• Launch the game and close it. This will finalize the BepInEx installation.

• Download the TunicArchipelago.zip file from the latest release.

  • Copy the "Tunic Archipelago" folder from the release zip into BepInEx/plugins under your game's install directory.
  • Copy the "ArchipelagoSettings.json" file from the release zip into the following directory: %localappdata%low\Andrew Shouldice\Secret Legend\Randomizer
    • This settings file is where you will configure you Archipelago connection settings, including Player name, hostname and port, and password if required.

• Launch the game again and you should see "Randomizer + Archipelago Mod Ver. x.y.z" on the top left of the title screen!

• To uninstall the mod, either remove/delete the "Tunic Archipelago" folder from the plugins folder or rename the winhttp.dll file located in the game's root directory (this will disable all installed mods from running).