mirror of
https://github.com/MarioSpore/Grinch-AP.git
synced 2025-10-21 20:21:32 -06:00
New features and fixes for Raft (#984)
* Add DeathLink, small logic changes * Fix generation, rules, use bool for slotData * Add more island options * Update Shovel-related logic * Update docs
This commit is contained in:
@@ -22,7 +22,7 @@ Decoration Packages are unchanged.
|
||||
Researches and pickups remain visually unchanged, regardless of what the unlock is.
|
||||
|
||||
## When the player receives an item, what happens?
|
||||
A Raft notification will appear with the item information. The unlock will also appear in the chat. Unlocks that would normally give you the item (eg Machete) will NOT give it to you, but must instead be crafted.
|
||||
A Raft notification will appear with the item information. The unlock will also appear in the chat. Unlocks that would normally give you the item (eg Zipline) will NOT give it to you, but must instead be crafted.
|
||||
|
||||
## Are there any limitations compared to vanilla Raft?
|
||||
- Mods that add new researchable technologies, modify story islands, or give items like blueprints are likely incompatible with Raftipelago.
|
||||
|
||||
@@ -4,23 +4,50 @@
|
||||
|
||||
- [Raft](https://store.steampowered.com/app/648800/Raft/)
|
||||
- [Raft Mod Loader](https://www.raftmodding.com/loader) ("*RML*")
|
||||
- [ModUtils mod](https://www.raftmodding.com/mods/modutils)
|
||||
- [Raftipelago mod](https://www.raftmodding.com/mods/raftipelago)
|
||||
|
||||
## Installation Procedures
|
||||
|
||||
1. Install Raft. The currently-supported Raft version is Version 1.0: The Final Chapter. If you plan on playing Raft mainly with Archipelago, it's recommended to disable Raft auto-updating through Steam, as there is no beta channel to get old builds.
|
||||
1. Install Raft. The currently-supported Raft version is Version 1.0: The Final Chapter. Any minor version (such as 1.08) should be compatible.
|
||||
|
||||
2. Install RML.
|
||||
|
||||
3. Install the Raftipelago mod from the Raft Modding website. You should open the auto-installation link on the webpage through RML. Alternatively, you can download the .rmod file and place it in the Mods folder manually.
|
||||
3. Install the Raftipelago and ModUtils mods from the Raft Modding website. You should open the auto-installation link on the webpage through RML. Alternatively, you can download the .rmod file and place it in the Mods folder manually.
|
||||
|
||||
4. Open RML and click Play. If you've already installed it, the shortcut in the Start Menu is called "RMLLauncher.exe". Raft should start.
|
||||
4. Open RML and click Play. If you've already installed it, the executable that was used to install RML ("RMLLauncher.exe" unless renamed) should be used to run RML. Raft should start after clicking Play.
|
||||
|
||||
5. Open the RML menu. This should open automatically when Raft first loads. If it does not, and you see RML information in the top center of the Raft main menu, press F9 to open it.
|
||||
|
||||
6. Navigate to the "Mod manager" tab in the left-hand menu.
|
||||
|
||||
7. Click on the plug icon for Raftipelago to load the mod.
|
||||
7. Click on the plug icon for ModUtils to load the mod. You can also click on the (i) next to the plug icon, then check the "Load this mod at startup" button. This will make the mod always load at startup.
|
||||
|
||||
8. Click on the plug icon for Raftipelago to load the mod. While it's possible to also make this mod load at startup, it's recommended *not* to do so; if this mod loads before ModUtils, the mod will fail to load properly.
|
||||
|
||||
## Joining a MultiWorld Game
|
||||
|
||||
1. Ensure you're on the Main Menu with Raftipelago loaded.
|
||||
|
||||
2. Open the Debug Console by pressing F10.
|
||||
|
||||
3. Type */connect {serverAddress} {username} {password}* into the console and hit Enter.
|
||||
- Example: */connect archipelago.gg:12345 SunnyBat*
|
||||
- If there is no password, the password argument may be omitted (as is the case in the above example).
|
||||
- serverAddress must not contain spaces.
|
||||
- If your username or password contains spaces, surround that value with quotation marks ("). Adding quotation marks even when not necessary (eg "SunnyBat") is fine.
|
||||
- If your username or password starts with a quotation mark, surround the value with an additional set of quotation marks (eg the value *"myP@s$w0rD* would be entered as *""myP@s$w0rD"*).
|
||||
|
||||
4. Start a new game or load an existing one. It's recommended to avoid using an existing game that was not created with your current run of Raftipelago (either vanilla or a different Raftipelago run). It will work, but if anything is unlocked, it will be automatically registered with Archipelago once the world is loaded. This is irreversible.
|
||||
|
||||
5. You can disconnect from an Archipelago server by typing */disconnect confirmDisconnect* into the console and hitting Enter.
|
||||
|
||||
## Multiplayer Raft
|
||||
|
||||
You're able to have multiple Raft players on a single Raftipelago world. This will work, with a few notes:
|
||||
- Only the player that creates/loads the world can connect to Archipelago (this is the "host" of the Raft world). Other players do not need to connect; everything will be routed through the the host.
|
||||
- Players other than the host will be labeled as a "Raft Player (Steam name)" when using ingame chat, which will be routed through Archipelago chat.
|
||||
- Ingame chat will only work when the host is connected to the Archipelago server.
|
||||
|
||||
## Installation Troubleshooting
|
||||
|
||||
@@ -45,38 +72,12 @@ If this happens, then RML is configured to only start a new instance of Raft, th
|
||||
You can either:
|
||||
- Close the existing instance of Raft then click Play
|
||||
- Check the box next to the "Disable Automatic Game Start" setting in the Settings menu then click Play.
|
||||
|
||||
## Joining a MultiWorld Game
|
||||
|
||||
1. Ensure you're on the Main Menu with Raftipelago loaded.
|
||||
|
||||
2. Open the Debug Console by pressing F10.
|
||||
|
||||
3. Type */connect {serverAddress} {username} {password}* into the console and hit Enter.
|
||||
- Example: */connect archipelago.gg:12345 SunnyBat*
|
||||
- serverAddress must not contain spaces.
|
||||
- If your username or password contains spaces, surround that value with quotation marks ("). Adding quotation marks even when not necessary (eg "SunnyBat") is fine.
|
||||
- If your username or password starts with a quotation mark, surround the value with an additional set of quotation marks (eg the value *"myP@s$w0rD* would be entered as *""myP@s$w0rD"*).
|
||||
|
||||
4. Start a new game or load an existing one.
|
||||
- Raftipelago save games are marked as *incompatible* with vanilla Raft. This means when Raftipelago is not loaded, saves made with Raftipelago will show as corrupt/unselectable.
|
||||
- Avoid using an existing game that was not created with your current run of Raftipelago (either vanilla or a different Raftipelago run). It will work, but if anything is unlocked, it will be automatically registered with Archipelago once the world is loaded. This is irreversible.
|
||||
|
||||
5. You can disconnect from an Archipelago server by typing */disconnect confirmDisconnect* into the console and hitting Enter.
|
||||
|
||||
## Multiplayer Raft
|
||||
|
||||
You're able to have multiple Raft players on a single Raftipelago world. This will work, with a few notes:
|
||||
- Only the player that creates/loads the world can connect to Archipelago (this is the "host" of the Raft world). Other players do not need to connect; everything will be routed through the the host.
|
||||
- Resource Packs are only received by the host and any other players connected to the Raft world when the resource pack is received.
|
||||
- Players other than the host will be labeled as a "Raft Player (Steam name)" when using ingame chat, which will be routed through Archipelago chat.
|
||||
- Ingame chat will only work when the host is connected to the Archipelago server.
|
||||
|
||||
## Game Troubleshooting
|
||||
|
||||
### The "Load game" button is disabled for my world / my world is corrupt
|
||||
|
||||
Be sure that you click the "Load game" button **after** you load Raftipelago. You can click the Load Game button again to reload all of the saves in your folder (there is no need to restart Raft if the mod loaded successfully).
|
||||
Be sure that you click the "Load game" button **after** you load Raftipelago. You can click the Load Game button again to refresh all of the saves in your folder (there is no need to restart Raft if the mod loaded successfully).
|
||||
|
||||
### I'm certain I'm doing things correctly, but the world is still not loadable
|
||||
|
||||
|
||||
Reference in New Issue
Block a user