ShopEnhancements Mod

Description

This mod enhances the in-game shop by allowing customization of the number of upgrade items available for purchase and how their costs scale with purchases.

Features

• Configurable Upgrade Count: Set a minimum and maximum number of upgrade items that can appear in the shop.
• Customizable Cost Scaling: Choose how upgrade costs increase:
  • Vanilla: Costs scale based on total purchases across all players (default game behavior)
  • Highest Player: Costs scale based on the highest level any single player has for that specific upgrade
• Randomization: The actual number of upgrades available each time the shop loads will be randomly chosen between the configured minimum and maximum (inclusive).
• Host/Singleplayer Only: Changes are only applied if you are the host of a multiplayer game or playing singleplayer to ensure game consistency.

Installation

1. Install BepInEx: Make sure you have BepInEx (version appropriate for your game) installed.
2. Download: Obtain the latest ShopEnhancements.dll file from the releases page
3. Place DLL: Copy the ShopEnhancements.dll file into your game's BepInEx/plugins/ folder.
4. Launch Game: Run the game once to generate the configuration file.

Configuration

After running the game once with the mod installed, a configuration file will be created at: BepInEx/config/discjenny.ShopEnhancements.cfg

(Note: The exact filename depends on the GUID set in the plugin, which is currently discjenny.ShopEnhancements)

You can edit this file with a text editor to change the following settings:

Shop Settings - Item Count

• MinUpgradeItems: The minimum number of upgrade items that should appear (default: 1, range: 0-14).
• MaxUpgradeItems: The maximum number of upgrade items that should appear (default: 8, range: 0-14).

Shop Settings - Cost Scaling

• UpgradeCostScalingMode: How upgrade costs increase with purchases (default: Vanilla)
  • Vanilla: Costs scale based on total purchases across all players
  • HighestPlayer: Costs scale based on the highest level any single player has for that upgrade

Important Notes:

• The value of MinUpgradeItems cannot be greater than MaxUpgradeItems. If it is, the mod will automatically use the MaxUpgradeItems value for both the minimum and maximum during that game session and log a warning.
• When updating the mod, any outdated configuration entries will be automatically removed and replaced with new defaults. Your settings for existing options will be preserved.

Changelog

All notable changes to this project will be documented in this file.

Changelog

[2.0.1] - 03-30-2025

Added

• Compatibility with other mods that add custom shop items
• Automatic adjustment of shop space and item counts for modded items
• Preservation of custom items while managing vanilla items

Changed

• Improved shop item filtering to only remove vanilla items
• Shop spawn limits now account for modded items in calculations
• Better handling of item list management for mod compatibility

Fixed

• Issue where custom modded items were being cleared from shop
• Spawn limit calculations not considering modded items
• Potential conflicts with other mods' shop items

[2.0.0] - 03-29-2025

Added

• Expanded shop space using GalaxyMods' custom shelf prefab
• Global price multiplier (0.1x to 5.0x) for all shop items
• Individual maximum counts for each upgrade type:
  • Health Upgrades
  • Energy Upgrades
  • Strength Upgrades
  • Speed Upgrades
  • Jump Upgrades
  • Map Upgrades
  • Launch Upgrades
  • Range Upgrades
• Configurable min/max counts for new item categories:
  • Regular Carts
  • Pocket Carts
  • Guns
  • Melee Weapons
  • Grenades
  • Drones
  • Mines
  • Trackers
  • Power Crystals
  • Health Packs
• New upgrade cost scaling mode: HighestPlayer
  • Cost scales with highest level any player has for that upgrade
  • Alternative to vanilla's total-purchased scaling

Changed

• Completely reworked shop item spawning system
• Improved configuration organization with three distinct sections:
  • Shop Settings - Item Count
  • Shop Settings - Cost Scaling
  • Upgrade Settings - Max Amount
• Better logging for debugging and troubleshooting
• Updated to use REPOLib for core functionality

Fixed

• Item spawning issues in multiplayer
• Upgrade cost scaling inconsistencies
• Various edge cases with item counts

[1.1.0] - 03-29-2025

Added

• New configuration option UpgradeCostScalingMode with two modes:
  • Vanilla: Preserves default game behavior (50% price increase per purchase, 5% discount per additional player)
  • HighestPlayer: Price scales only with highest upgrade level among players, ignoring multi-player discounts
• Automatic cleanup of outdated configuration entries during updates
• Better organization of configuration file into clear sections

Changed

• Improved configuration handling to preserve user settings during updates
• Reorganized configuration file into logical sections for better readability

[1.0.0] - 03-29-2025

Added

• Initial release.
• Configuration option MaxUpgradeItems to set the maximum number of shop upgrades (default: 14, range: 0-14).
• Configuration option MinUpgradeItems to set the minimum number of shop upgrades (default: 14, range: 0-14).
• Validation to ensure MinUpgradeItems is not greater than MaxUpgradeItems.
• Randomization of the number of upgrade items spawned between the configured (and validated) min and max values each time the shop initializes.
• Functionality applies only when the player is the host (MasterClient) or in singleplayer mode.