Aska Cave Tools

ASKA Cave Tools

Reset Cave:

• []Restore Ore/Resources - Respawns iron deposits and ore nodes on cave walls[/]

  []Restore Cave Walls - Restores cave walls to pristine state, seals opened passages[/]

  []Respawn Creature Dens - Resets crawler spawners and creature dens[/]

  []Respawn Spawner Eggs - Respawns crawler eggs at spawner locations[/]

  []Full Cave Reset - Complete restoration including ore, walls, creatures, and exploration fog[/]

  Item Cost System

  • []Each reset operation requires specific items (fully configurable via CFG)[/]

    []Default costs use Explosive Sacks, coal, stone, rope, and raw materials[/]

    []Choose inventory source: Player only, Nearby carts only, or Both[/]

    []Real-time item quantity display with color-coded availability (green/red)[/]

    []UI updates immediately after reset to show consumed items[/]

    Configuration Options

    • []Toggle item costs on/off (free resets if disabled)[/]

      []Customize required items and quantities per operation type[/]

      []Adjust cart search radius for nearby inventory detection[/]

      []Admin-only mode for multiplayer servers[/]

      []Safety checks to prevent resetting with players inside caves[/]

      Quality of Life

      • []Clean two-column UI: function selector on left, cost details on right[/]

        []Hover tooltips show "Cave Tools" on the custom tab[/]

        []Compatible with StackSizeMultiplier and DurabilityMultiplier mods[/]

        []Deferred initialization prevents conflicts with other mods[/]

        ---

        Installation

        Requirements

        • []BepInEx 6.x for ASKA (IL2CPP version)[/]

          Steps

          • []Install BepInEx for ASKA if you haven't already[/]

            []Download AskaCaveTools.dll from the Files tab[/]

            []Place it in: ASKA/BepInEx/plugins/AskaCaveTools.dll[/]

            []Launch the game![/]

            ---

            How to Use

            Basic Usage

            • []Locate a Cave Entrance building in your world[/]

              []Interact with it to open the workstation menu[/]

              []Click the "Cave Tools" tab (shows with handshake icon)[/]

              []Select a reset operation from the left column[/]

              []Check the right panel for required items and your current quantities[/]

              []Click the "Reset" button when you have enough items[/]

              Understanding the Item Cost System

              Item Source Modes:

              The mod can pull required items from three different sources (configurable in-game via dropdown):

              • []Player Only - Only items in your character's inventory count[/]

                []Nearby Carts Only - Only items in carts near the cave entrance[/]

                []Player and Nearby Carts (Default) - Combines both sources[/]

                How the Cart System Works:

                When you select "Nearby Carts" or "Player and Nearby Carts":

                • []The mod scans for all carts within 10 meters of the cave entrance (configurable)[/]

                  []It checks each cart's inventory for the required items[/]

                  []Items are pulled from carts automatically when you click Reset[/]

                  []The UI shows total available items from all sources combined[/]

                  []Color coding: Green = enough items, Grey= missing items[/]

                Tips:
                • []Place carts near cave entrances before opening the menu for easy access[/]

                  []The search radius can be adjusted in the config file (default: 10 meters)[/]

                  []Items are consumed from player inventory first, then nearby carts[/]

                  []The UI updates immediately after reset to show consumed items[/]

                  ---

                  Configuration

                  Edit BepInEx/config/AskaCaveTools.cfg to customize the settings after the first game start and the CFG got created:

                  ## Master enable/disable for the mod.

                  # Setting type: Boolean

                  # Default value: true

                  Enabled = true

                  ## If true, forces Enabled=true in BepInEx.cfg on startup.

                  # Setting type: Boolean

                  # Default value: true

                  AutoEnableBepInExConsole = true