Progressive Map Access 1.1.0

Progressive Map Access

Progressive Map Access locks map access behind a configurable quest progression wall. Each map can be dynamically unlocked based on completed or accepted quests. While a map is locked it will be inaccessible from the menu. You would need to use the in map transits to move to locked maps.

I got the inspiration from some posts I saw on discord about how the new 'hardcore' wipe could have handled map access. This is what I came up with. With default settings of the mod the starting map looks like this:

The default progression should be quite forgiving, unlocking most maps by level 10ish. By default ground zero is open, its the only open map at first.

• Customs by accepting Background Check
• Woods by accepting Introduction
• Factory by completing Stirrup
• Interchange by accepting Make Ultra Great Again
• Streets by completing Friend from the west part 1
• Shoreline by accepting Fishing Gear
• Lighthouse by accepting Broadcast Part 1
• Reserve by completing The Punisher Part 1
• Labs by completing Fishing Place

This is easily configurable in the mods config file.

As of version 1.1.0 the mod introduces a new mechanic that I am currently calling 'Camping'. The mod saves the players last successful extract location and unlocks that map until the player either dies or extracts from another map. If the player dies, the 'Camping' trip ends and the player loses access to the extra map and reverts to the maps the player has unlocked via quest/config.

The camping mechanic also has a separate option that is just called campingAdjacent in the config that unlocks maps adjacent to the players saved location. These follow the same rules as the main camping rule and the player will lose access to these if they die or extract from a different map.

Currently the player scav is also limited by the unlocked maps, but with one exception. The mod does not track scav activity, so if you unlock maps temporarily via the location system, your scav can use those maps without worry of dieing and losing access to those maps. But it goes both ways and if you extract with your scav it will not update your pmc's location in Tarkov.

This is primarily a server mod, but it includes a client mod portion that is used to actually allow the lock status to update dynamically without having to restart the client. The client mod also fixes the exploit that was present on live at the start of the current wipe that allowed players to bypass the map locks by removing the next button from the map screen.

The mod should be safe to add/remove mid playthrough as all changes the mod makes are saved in the mod itself and not added the players spt server profile.

The mod tracks each user individually, so this MIGHT work with fika, haven't tested it yet. But each accounts map access is tracked individually by the mod.

If you use fika, the transit/location system will really only work if you use a headless setup. Transits do not function in vanilla fika from my understanding. The quest unlock progression should work still though.

Map Unlocking

The mod has two primary ways of unlocking maps enabled by default, the quest method, which tracks the players quest progression and unlocks maps based on the quest settings in the mods config file.

• Customs by accepting Background Check
• Woods by accepting Introduction
• Factory by completing Stirrup
• Interchange by accepting Make Ultra Great Again
• Streets by completing Friend from the west part 1
• Shoreline by accepting Fishing Gear
• Lighthouse by accepting Broadcast Part 1
• Reserve by completing The Punisher Part 1
• Labs by completing Fishing Place

Example of unlock progress with default settings and the player has unlocked the mission Background check.

These requirements are configurable in the config file.

An example of the mod saving the players location, in this example the player last extracted from Lighthouse. Observe how the bordering maps have also been temporarily unlocked.

The second optional method involves using the transit system. If the player successfully extracts from a map, the mod will track that as the players saved location. This is just used for unlocking the map the player just extracted from. The map location will only stay unlocked until either the player dies, or extracts from another map.

The system has an optional extension that unlocks all maps adjacent to the players saved location. These maps follow the same rule as stated above and will lock once the players position changes. Using the example above, if the player next extracted from the Woods map, the map Shoreline would become locked and Factory would then become unlocked as it borders Woods.

If the player dies, the unlocked maps will revert to whatever the player has unlocked via the configured quest progression.

Configuration

The mod is highly configurable:

"enabled": true,
"campingTrip": true,
"campingAdjacent": true,
"enableLogging": false,

  "ExampleMapConfiguration": {
    "lockedByDefault": true,
    "questID": "657315df034d76585f032e01",
    "requireQuestStartedOnlyPickOne": false,
    "requipreQuestCompletedOnlyPickOne": true
  },
  
  "GroundZero": {
    "lockedByDefault": false,
    "questID": "657315df034d76585f032e01",
    "requireQuestStarted": true,
    "requireQuestCompleted": false
  },

  "Customs": {
    "lockedByDefault": true,
    "questID": "5936da9e86f7742d65037edf",
    "requireQuestStarted": true,
    "requireQuestCompleted": false
  }

Above is a code snippet from the config, you can enable or disable the mod from the config. Each map can be individually configured.

• campingTrip: This value toggles the mods setting that unlockes the last map the player successfully extracted from. This map will remain unlocked until either the player dies, or extracts from another map.
• campingAdjacent: This value toggles the unlocking of maps adjacent to the map marked as your location. These maps follow the same rule as the main camping value and will remain active until you either die, or extract from another map.

• lockedByDefault: states whether or not the location is locked by default
• questID: is the quest that needs to be either accepted or completed to access the location from the menu
• requireQuestStarted: pick one of these as the requirement for access the location, requires accepting the quest
• requireQuestCompleted: pick one of these as the requirement for access the location, requires completing the quest

The full config includes all current maps available in Tarkov.

Known Issues

• Occasionally the map access doesn't unlock as expected on first loading of the locaiton selection screen. The current fix is to back out to the side selection screen and that should make it update.
• If for whatever reason the player deletes there profile in the mod folder but keeps using the mod the correct map access won't immediately update. I built in a work around for those lucky few by clicking the survey tab on the main menu. Now that button has a reason.

Hardcore Alt Config

At the request of MOSSY, I created an alternate config that by default requires the player to complete a quest on each map before it unlocks. Just need to unzip and drag onto your SPT install.

Download

Alternate config for Progressive Map Access.

This config requires the player to complete a specific mission on each map, other than ground zero before it unlocks.

The missions I picked I picked either because they would require the player to extract at least once or if I couldn't find

a mission that required that, would require the player to do a fair amount of work. I also wanted to pick a mission that

unlocked relatively early on a map if possible.

Customs: Background Check

Factory: Scout

Woods: Search Mission

Interchange: Big Sale

Streets: Cease Fire!

Shoreline: Fishing Gear

Lighthouse: Long Road

Reserve: Disease History

Labs: Beneath The Streets

Unlocking Customs and Woods could be difficult as whichever one you start with would require the player to start at

Ground Zero, transit to Streets, then to Interchange, then to Customs. If you picked to unlock Woods first would further

require transiting to Factory then to Woods itself.

Aside from the hand picked missions selected, the config differs from the regular setup as having the campingAdjacent value switched off, the user can turn it back on. The hardcore config, still has the campingTrip value switched on, meaning the player could transit to a map of their choosing, and as long as they extract successfully from it, the map will remain unlocked for them until they either die, or extract from another map.

For those who want a hardcore experience without having to comb a wiki, here it is.