morgan/Grinch-AP
1
0
Fork 0
mirror of https://github.com/MarioSpore/Grinch-AP.git synced 2025-10-21 20:21:32 -06:00
Code Issues Packages Projects Releases Wiki Activity

Overcooked! 2: Implementation (#1046)

Browse Source 
Overcooked! 2 is a couch co-op arcade game with a very high skill ceiling. It has a small but occult following, and the community craves a reason to keep coming back besides just grinding high scores. as such, this PR represents 3 major milestones in one:

 * The launch of OC2 Modding, a modding framework which is the first public mod for the game beyond simple RAM trainers
 * The launch of OC2 Randomizer
 * The integration of OC2 Randomizer in Archipelago
This commit is contained in:
toasterparty
2022-10-13 10:57:50 -07:00
committed by GitHub
parent 3bd4ef3f3d
commit 7f3f886e41
11 changed files with 5348 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

86
worlds/overcooked2/docs/en_Overcooked! 2.md Normal file
View File

@@ -0,0 +1,86 @@
# Overcooked! 2
## Quick Links
- [Setup Guide](../../../../tutorial/Overcooked!%202/setup/en)
- [Settings Page](../../../../games/Overcooked!%202/player-settings)
- [OC2-Modding GitHub](https://github.com/toasterparty/oc2-modding)
## How Does Randomizer Work in the Kitchen?
The *Overcooked! 2* Randomizer completely transforms the game into a metroidvania with items and item locations. Many of the Chefs' inherent abilities have been temporarily removed such that your scoring potential is limited at the start of the game. The more your inventory grows, the easier it will be to earn 2 and 3 Stars on each level.
The game takes place entirely in the "Story" campaign on a fresh save file. The ultimate goal is to reach and complete level 6-6. In order to do this you must regain enough of your abilities to complete all levels in World 6 and obtain enough stars to purchase 6-6*.
Randomizer can be played alone (one player switches between controlling two chefs) or up to 4 local/online friends. Player count can be changed at any time during the Archipelago game.
**Note: 6-6 is excluded from "Shuffle Level Order", so it will always be the standard final boss stage.*
## Items
The first time a level is completed, a random item is given to the chef(s). If playing in a MultiWorld, completing a level may instead give another Archipelago user their item. The item found is displayed as text at the top of the results screen.
Once all items have been obtained, the game will play like the original experience.
The following items were invented for Randomizer:
### Player Abilities
- Dash/Dash Cooldown
- Throw/Catch
- Sharp Knife
- Dish Scrubber
- Control Stick Batteries
- Lightweight Backpack
- Faster Respawn Time
- Emote (x6)
### Objects
- Spare Plate
- Clean Dishes
- Wood
- Coal Bucket
- Bellows
- Fire Extinguisher
### Kitchen/Environment
- Larger Tip Jar
- Guest Patience
- Burn Leniency
- Faster Condiment & Drink Switch
- Wok Wheels
- Coin Purse
- Calmer Unbread
### Overworld
- Unlock Kevin Level (x8)
- Ramp Button
- Bonus Star (Filler Item*)
**Note: Bonus star count varies with settings*
## Other Game Modifications
In addition to shuffling items, the following changes are applied to the game:
### Quality of Life
- Tutorial is skipped
- Non-linear level order
- "Auto-Complete" feature to finish a level early when a target score is obtained
- Bugfixes for issues present in the base game (including "Sink Bug" and "Double Serving")
- All chef avatars automatically unlocked
- Optionally, level time can be reduced to make progression faster paced
### Randomization Options
- *Shuffle Level Order*
- Replaces each level on the overworld with a random level
- DLC levels can show up on the Story Overworld
- Optionally exclude "Horde" Levels
- Optionally exclude "Prep" Levels
### Difficulty Adjustments
- Stars required to unlock levels have been rebalanced
- Points required to earn stars have been rebalanced
- Based off of the current World Record on the game's [Leaderboard](https://overcooked.greeny.dev)
- 1-Star/2-Star scores are much closer to the 3-Star Score
- Significantly reduced the time allotted to beat the final level
- Reduced penalty for expired order

84
worlds/overcooked2/docs/setup_en.md Normal file
View File

@@ -0,0 +1,84 @@
# Overcooked! 2 Randomizer Setup Guide
## Quick Links
- [Main Page](../../../../games/Overcooked!%202/info/en)
- [Settings Page](../../../../games/Overcooked!%202/player-settings)
- [OC2-Modding GitHub](https://github.com/toasterparty/oc2-modding)
## Required Software
- Windows 10+
- [Overcooked! 2](https://store.steampowered.com/bundle/13608/Overcooked_2___Gourmet_Edition/) for PC
- **Steam: Recommended**
- Steam (Beta Branch): Supported
- Epic Games: Supported
- GOG: Not officially supported - Adventurous users may choose to experiment at their own risk
- Windows Store (aka GamePass): Not Supported
- Xbox/PS/Switch: Not Supported
- [OC2-Modding Client](https://github.com/toasterparty/oc2-modding/releases) (instructions below)
## Overview
*OC2-Modding* is a general purpose modding framework which doubles as an Archipelago MultiWorld Client. It works by using Harmony to inject custom code into the game at runtime, so none of the orignal game files need to be modified in any way.
When connecting to an Archipelago session using the in-game login screen, a modfile containing all relevant game modifications is automatically downloaded and applied.
From this point, the game will communicate with the Archipelago service directly to manage sending/receiving items. Notifications of important events will appear through an in-game console at the top of the screen.
## Overcooked! 2 Modding Guide
### Install
1. Download and extract the contents of the latest [OC2-Modding Release](https://github.com/toasterparty/oc2-modding/releases) anywhere on your PC
2. Double-Click **oc2-modding-install.bat** follow the instructions.
Once *OC2-Modding* is installed, you have successfully installed everything you need to play/participate in Archipelago MultiWorld games.
### Disable
To temporarily turn off *OC2-Modding* and return to the original game, open **...\Overcooked! 2\BepInEx\config\OC2Modding.cfg** in a text editor like notepad and edit the following:
`DisableAllMods = true`
To re-enable, simply change the word **true** back to a **false**.
### Uninstall
To completely remove *OC2-Modding*, navigate to your game's installation folder and run **oc2-modding-uninstall.bat**.
## Generate a MultiWorld Game
1. Visit the [Player Settings](../../../../games/Overcooked!%202/player-settings) page and configure the game-specific settings to taste
2. Export your yaml file and use it to generate a new randomized game
- (For instructions on how to generate an Archipelago game, refer to the [Archipelago Web Guide](../../../../tutorial/Archipelago/using_website/en))
## Joining a MultiWorld Game
1. Launch the game
2. When attempting to enter the main menu from the title screen, the game will freeze and prompt you to sign in:
![Sign-In Screen](https://i.imgur.com/goMy7o2.png)
3. Sign-in with server address, username and password of the corresponding room you would like to join.
- Otherwise, if you just want to play the vanilla game without any modifications, you may press "Continue without Archipelago" button.
4. Upon successful connection to the Archipelago service, you will be granted access to the main menu. The game will act as though you are playing for the first time. ***DO NOT FEAR*** — your original save data has not been overwritten; the Overcooked Randomizer just uses a temporary directory for it's save game data.
## Playing Co-Op
- To play local multiplayer (or Parsec/"Steam Play Together"), simply add the additional player to your game session as you would in the base game
- To play online multiplayer, the guest *must* also have the same version of OC2-Modding installed. In order for the game to work, the guest must sign in using the same information the host used to connect to the Archipelago session. Once both host and client are both connected, they may join one another in-game and proceed as normal. It does not matter who hosts the game, and the game's hosts may be changed at any point. You may notice some things are different when playing this way:
- Guests will still receive Archipelago messages about sent/received items the same as the host
- When the host loads the campaign, any connected guests are forced to select "Don't Save" when prompted to pick which save slot to use. This is because randomizer uses the Archipelago service as a pseudo "cloud save", so progress will always be synchronized between all participants of that randomized *Overcooked! 2* instance.
## Auto-Complete
Since the goal of randomizer isn't necessarily to achieve new personal high scores, players may find themselves waiting for a level timer to expire once they've met their objective. A new feature called *Auto-Complete* has been added to automatically complete levels once a target star count has been achieved.
To enable *Auto-Complete*, press the **Show** button near the top of your screen to expand the modding controls. Then, repeatedly press the **Auto-Complete** button until it shows the desired setting.