Artisan

A quality-of-life and gameplay enhancement mod for YAPYAP focused on improving multiplayer compatibility, performance, and customization.

Artisan combines multiple gameplay improvements while addressing limitations, bugs, and performance issues found in previous implementations.

Why Artisan Exists

Artisan was created after discovering useful community mods that introduced interesting features but also presented limitations, multiplayer issues, or performance problems.

Normally, contributing fixes directly to those projects would be the preferred approach. However, some referenced projects did not provide public repositories or issue trackers where bugs and improvements could be reported.

Because of this, Artisan was developed as an independent project focused on improving, reimplementing, and expanding those ideas while maintaining configurability, compatibility, and performance.

This project exists as a complement to community work and not as criticism of the original authors whose work served as inspiration.

Features

Monster Health Bars + Multiplayer Damage Indicators

Adds health bars and floating damage indicators to monsters.

Improvements:

• Proper multiplayer synchronization
• Visible to all players with Artisan installed
• More stable implementation

Aero & Teleblast Damage

Adds configurable damage support for:

• Aero
• Teleblast

Features:

• Individual spell damage values
• Can be configured independently
• Can be disabled completely

Extended Inventory Slots

Adds additional inventory slots to increase carrying capacity.

Features:

• Improved performance compared to previous implementations

• Avoids lag spikes when:

  • Switching selected inventory slots
  • Moving items between slots
  • Changing held items

• Added additional hotkeys:

  • Slots 4–8

• Improved inventory UI behavior

• Can be disabled completely

Backpack Upgrade System

Adds optional progression-based inventory upgrades.

Players start with the default inventory size and can purchase additional inventory slots during the lobby phase.

Features:

• Individual progression per player
• Shared room gold economy
• Configurable base upgrade price
• Configurable price multiplier
• Dedicated upgrade station in the lobby
• Multiplayer-safe synchronization
• Locked slot visual indicators
• Locked slot interaction protection

Locked slots include:

• Visual overlay
• Tele-lock themed lock icon
• Pickup validation
• Hotkey protection
• Scroll selection protection
• Drag/drop protection

Configuration

Every Artisan feature is configurable.

Available options include:

Gameplay

• Enable/disable health bars
• Enable/disable damage indicators
• Enable/disable Aero damage
• Enable/disable Teleblast damage
• Enable/disable extra inventory slots
• Enable/disable backpack upgrades

Backpack Upgrade Settings

• Base upgrade price
• Upgrade price multiplier

Configuration file:

BepInEx/config/gamedroit.artisan.cfg

Changes can be made without modifying the mod itself.

Goals

Artisan aims to provide:

• Better multiplayer support
• Higher stability
• Better performance
• Modular features
• Full configurability
• Compatibility-focused implementations

Installation

1. Install BepInEx
2. Install Artisan
3. Launch the game once
4. Configure features if desired

Configuration path:

BepInEx/config/gamedroit.artisan.cfg

Credits

Inspiration

• Health Bar: https://thunderstore.io/c/yapyap/p/XiaohaiMod/HealthBar/
• Aero With Damage: https://thunderstore.io/c/yapyap/p/ControllerAndHisFriends/AeroWithDamage/
• More Inventory Slots: https://thunderstore.io/c/yapyap/p/H4Mods/MoreInventorySlots/

Author

Created by Gamedroit also known as Hadaward

Changelog

1.1.0

Added

• Added support for adaptive inventory grid positioning.
• Added support for configurable inventory grid columns.
• Added support for configurable slot spacing.
• Added support for optional inventory background hiding.
• Added support for configurable inventory position offsets.
• Added support for extra slot key bindings.

Changed

• Refactored inventory UI layout system to support dynamic grid configurations.
• Reworked slot positioning to use relative offsets based on configurable grid settings.
• Improved offhand slot alignment and scaling to maintain consistency with dynamic grid layouts.
• Reorganized mod configuration into dedicated configuration groups.

  :warning: Its recommended to reset your mod configuration after updating to this version to ensure all new settings are properly initialized.

Fixed

• Fixed issue where items could become permanently inaccessible when inventory slot upgrades were enabled after a save already contained items in higher slots. Such items are now automatically removed from invalid slots and dropped into the world as recoverable items.
• Fixed issue where reducing MaxSlots could permanently delete items stored in higher inventory slots. Items from overflow slots are now automatically dropped into the world during inventory restoration instead of being lost.
• Fixed race condition between: ServerTryRestoreFromKvp and ServerSerializeToKvp, which could cause inventory data to be overwritten during restoration. Now added restore state tracking through: RestoringInventories and prevented slot serialization while a restore operation is in progress.

What comes next on the roadmap?

• Implementing support for synchronizing host configurations to clients in multiplayer sessions, so that settings are consistent across all players without requiring manual configuration.

If you have any suggestions or feedback on the mod, please feel free to reach out to me on the mod's GitHub repository or through the modding community discord. Your input is invaluable in helping me improve and expand the mod's features!

1.0.2

Added

• Added configurable backpack inventory slot upgrades.
• Added per-player inventory progression system.
• Added lobby upgrade chest for purchasing additional inventory slots.
• Added support for shared gold economy when purchasing inventory upgrades.
• Added locked slot visual overlays with tele-lock mesh rendering.
• Added automatic slot locking/unlocking synchronization.
• Added multiplayer-safe inventory upgrade networking.
• Added localized upgrade text support.
• Added English and Brazilian Portuguese localization support.
• Added shopkeeper purchase feedback integration.
• Added purchase sound effects and NPC reactions after successful upgrades.
• Added configurable upgrade pricing:
  • Base slot upgrade price
  • Upgrade price multiplier
• Added support for disabling the upgrade system entirely while keeping all slots unlocked.
• Added inventory full handling for potion ingredients and custom interactables.
• Added runtime UI refresh for slot overlays and upgrade states.

Changed

• Completely refactored extended inventory UI layout system.
• Reworked slot positioning to use deterministic absolute positioning.
• Improved inventory frame alignment and spacing.
• Improved offhand slot alignment and scaling.
• Improved locked slot visuals and overlay rendering.
• Improved inventory interaction validation.
• Improved multiplayer synchronization for inventory upgrades.
• Improved tooltip behavior for locked/full inventory states.

Fixed

• Fixed players being able to store items in locked inventory slots.
• Fixed mouse scroll selecting locked slots.
• Fixed locked slots accepting drag/drop interactions.
• Fixed inventory pickup validation when extra slots are locked.
• Fixed inventory full tooltip inconsistencies.
• Fixed potion ingredient tooltip not displaying "Inventory Full".
• Fixed upgrade chest not respawning after returning to the title screen.
• Fixed locked slot overlays not refreshing immediately after upgrades.
• Fixed several inventory UI alignment issues.
• Fixed frame positioning inconsistencies between regular slots and offhand slot.
• Fixed purchase SFX playing when upgrades failed.
• Fixed multiplayer purchase confirmation behavior.
• Fixed several UI layering and overlay positioning issues.

Technical

• Added runtime mesh-to-sprite rendering for tele-lock slot icons.
• Added server-authoritative inventory upgrade purchases.
• Added custom Mirror networking handlers for upgrade synchronization.
• Added helper utilities for locked slot validation and inventory state checks.
• Added automatic UI rebuild and refresh logic for inventory overlays.