An Archipelago (AP) randomizer world for Resident Evil 3 Remake. Designed for use with the RE3R Archipelago client repository linked below.
- Due to the nature of the game, there are points of no return and as such you can potentially miss items if you progress far enough.
- Setting Allow Missable Locations to false will not put progression in those locations, but you will still find useful/junk/traps.
- You can find progression if that setting is set to true, fair warning.
Grab the latest client here: https://github.com/TheRealSolidusSnake/RE3R_AP_Client/
Follow the visual setup guide here: https://TheRealSolidusSnake.github.io/RE3R_AP_SetupGuide/
All scenarios are currently supported.
If you play on Assisted, make sure you choose Standard in your yaml.
All of the scenarios' data lives in the data folder. The structure of the data is:
Data is loaded from the jill character folder, it contains all the scenario data and everything else involving the scenarios.
Each character's items are the same across scenarios. Some important fields to note:
There are multiple item types to choose from:
- Key = These are high-priority gating items that unlock major progression
- Gating = These are low-priority gating items that unlock only a few locations
- Consumable = These are non-progression but likely useful items that are consumed on use
- Crafting = These are the same as Consumable, just categorized as powders/explosives
- Recovery = These are the same as Consumable, but further categorized as healing items
- Weapon = These are weapons that consume ammunition (so the Combat Knife is not included)
- Subweapon = These are weapons that do not consume ammunition, and many of these are throwable
- Ammo = These are all the ammo types for use with the Weapon item type
- Upgrade = These are all the weapon upgrades for use with the Weapon item type
The decimal field is a decimal (base 10) representation of the item's in-game hex code. This is how the randomizer client translates a named item to an in-game item.
The count field represents the quantity you receive each time the item is received, NOT the number of this item in the scenarios. In most cases, the count will be 1. For Weapons, the count is the starting ammo count for that weapon when received. For Ammo, the count is the amount of ammo received when you receive that "pack" of ammo.
If an item is marked as progression, it unlocks one or more locations. Typically, this will only be the case for the item types Key and Gating.
Regions represent rooms, so zones represent groups of rooms, like RPD.
Each scenario is separated into its own folder under the scenarios folder. Typically, each scenario has a different set of item locations, some different regions, and different ways that regions connect to each other.
This is the most important part of the randomizer world. The locations and original items defined here directly impact what is randomized into the world, and the item object information is used by the randomizer client to track those location checks.
Some important fields to note:
These are combined into the location name, and the apworld customizes the region name to include the scenario suffix. The region name must match a region name in the Regions file.
This is the item that is found at the location when playing through the vanilla game. When the apworld is generated, this item is added to the item pool for randomization.
This allows conditional logic for whether a location should be accessible. For instance, Locker 203 in the Safety Deposit Room requires both Spare Keys, so they are listed as a condition.
These three fields uniquely identify every location in the game. They are derived from game object names and field values from the game's code. Using these values, the randomizer client can identify the right named location to track.
To find these values, you can use REF_Inspect and interact with the locations normally.
This is an optional field and only included on some item entries. In some cases, we want to force a specific item to be placed at a specific location for a specific campaign, so we use this option and provide the name of the item to place.
This is an optional field and only included on some item entries. In some cases, we want the location to keep its vanilla item, so we use this option. This option defaults to 1 (randomized), and 0 means not randomized.
There must be exactly one Victory location (i.e., location that finishes the randomizer), and it is the only location that uses these fields. All location IDs are dynamically assigned unless provided, but Victory forces a non-dynamic ID. The Victory field is set to true to indicate that the location is the Victory location.
This file is optional, but needed for Hardcore difficulty support for scenarios. Hardcore difficulty just removes some locations from the game, and beefs up the damage you take a little bit.
This file only contains locations that are changed/added for Hardcore, and is loaded after the normal locations file. If a location in the Hardcore file has the same region name and location name as a location in the normal file, the location in the normal file will be overwritten when playing Hardcore difficulty. If the location in the Hardcore file has a region + location name that doesn't match an existing location, it will be added as a new location when playing Hardcore difficulty i.e. (JAH) will be appended to the name
This file is optional, but needed for Nightmare difficulty support for scenarios. Nightmare difficult removes some locations, but also changes the layout of other items as well.
This file only contains locations that are changed/added for Nightmare, and is loaded after the normal locations file. If a location in the Nightmare file has the same region name and location name as a location in the normal file, the location in the normal file will be overwritten when playing Nightmare difficulty. If the location in the Nightmare file has a region + location name that doesn't match an existing location, it will be added as a new location when playing Nightmare difficulty i.e. (JAN) will be appended to the name
This file is optional, but needed for Inferno difficulty support for scenarios. Inferno has the same item placements as Nightmare, removes some typewriters and item boxes as well as quite a few item locations.
This file only contains locations that are changed/added for Inferno, and is loaded after the normal locations file. If a location in the Inferno file has the same region name and location name as a location in the normal file, the location in the normal file will be overwritten when playing Inferno difficulty. If the location in the Inferno file has a region + location name that doesn't match an existing location, it will be added as a new location when playing Inferno difficulty i.e. (JAI) will be appended to the name
This file lists all of the rooms (regions) in the game and what zone (area) they belong to. This file must always start with the Menu region.
This file dictates how the randomizer connects each room (region) together. Currently, these connections must follow their vanilla connection and item requirements.
Some important fields to note:
Each of these must be set to a region name from the regions file. These define a forward connection from the From region to the To region.
Note: Since you can travel back along any connection you've previously traveled forward over, don't define two-way connections between regions. This will likely break logic because the logic will sometimes use the reverse connection to avoid the vanilla connection mentioned above.
Similar to the Condition field in the regions file, this allows you to specify item requirements to traverse a region connection. This is the most common place to use the Condition field, for things like door keys, etc.
This is an optional field, and is currently only used to define a region connection as a one-sided connection (with the value "ONE_SIDED_DOOR"). This is commonly used for doors with latches or bolt cutter doors that you have to activate from one side to allow traversing.
Note: One-sided connections are currently excluded from the randomizer because they may end up in logic on the reverse path, which can be unreachable. Similar issue as noted above with From and To. However, we want these defined in case we change this behavior later.
This file defines all of the typewriter locations in the scenario. This is used for creating typewriter teleports in the randomizer client.
Some important fields to note:
These fields all uniquely identify a typewriter by field values and game object names from the game's code.
To find these values, you can use REF_Inspect and interact with the typewriters normally.