潜水服独立槽 Diving Suit Slot

[h1]⚠️ FRAMEWORK-TYPE MOD WARNING ⚠️[/h1] This is a framework-type code mod, just like LuaCs. BOTH the host and EVERY client must subscribe and enable it themselves! The server will not auto-push this mod to you — every player must subscribe on their own (and enable it after subscribing) before joining. Otherwise you may fail to join, get errors in-game, or be kicked.

Adds a true 7th clothing slot — a dedicated Diving Suit slot! Tired of diving suits hogging the outerwear slot? This mod moves every diving suit out of the outerwear slot into its own slot.

◆ Features

• A true 7th clothing slot: the equipment bar now has a dedicated "Diving Suit" slot (6 -> 7)
• All 8 diving suits relocated: Diving Suit, Abyss Diving Suit, Combat Diving Suit, Respawn Diving Suit, Broken Diving Suit, PUCS, Exosuit, Clown Exosuit
• Outerwear slot freed up: Body Armor, Makeshift Armor, Mudraptor Shell and Safety Harness stay in the outerwear slot
• Wear both at once: you can now equip a diving suit AND body armor at the same time
• Automatic compatibility with modded suits: detection is based on the built-in diving/deepdiving item tags, so suits added by other mods move to the new slot automatically

◆ New in v1.3.0: a "custom clothing slot" framework

Since v1.3.0 this mod is more than a diving suit slot — it is an extensible framework for custom clothing slots:

• Third-party mods declare new slots with zero code: drop a declaration file (or one Lua line) into your mod and you get a brand-new clothing slot — slot expansion, item migration, UI layout and AI recognition are all handled by the framework
• Up to 21 custom slots: unused flag bits 1024–2^30 are all available; bit conflicts are detected and reported in F3
• Free placement of slots (new in M15): declared slots anchor to the block right above the vanilla ID Card slot by default, with row/col/yoff fields for free positioning — no more leftward squeeze; the panel grows automatically to contain the new slots, with full mouse interaction
• Zero impact for regular players: the diving suit slot behaves exactly like v1.2.0
• Companion demo addon: "背包独立槽 Backpack Slot" — a pure-XML, zero-code demo that gives backpacks their own slot (4096)

Mod authors: full documentation in the mod folder ("框架使用手册", bilingual).

◆ Open Code

The declaration API and the core layout technology are fully open — mod authors are free to use them:

① Declaration 1 · XML — place [code]DivingSuitSlotSlots.xml[/code] in your mod's root folder:

<DivingSuitSlots>
  <!-- bit slot flag | tags/identifiers item match | from source slot | row/col grid | yoff vertical fine-tune -->
  <Slot bit="4096" id="backpack" tags="largemobilecontainer" from="Bag"
        priority="0" row="1" col="0" yoff="0" />
</DivingSuitSlots>

② Declaration 2 · Lua (runtime registration):

DivingSuitSlot.RegisterSlot({
    bit = 4096, id = "backpack",
    tags = { "largemobilecontainer" },
    from = "Bag", priority = 0,
    row = 1, col = 0, yoff = 0
})

③ Core layout algorithm (inside CSharp/Shared/DivingSuitSlot.cs):

// Declared slots anchor above the vanilla Card slot; row/col grid + yoff fine-tune:
int px = cardX + col * (slotW + spacing);          // horizontal: extend right from the Card column
int py = cardY - row * (slotH + spacing)           // vertical: row blocks above Card
         - 7 * spacing + yoff;                     // default extra lift of 7 spacings + fine-tune

// True slot pixel size (scales with the UI):
slotW/H = SlotSpriteSmall.size × UIScale × AspectRatioAdjustment
spacing = 5 × GUI.Scale

// Panel auto-grows: personalSlotArea is overwritten with
// vanilla equipment area ∪ declared-slot area, so the vanilla
// background frame calculation wraps the new slots automatically

④ Full source ships with the mod: [code]CSharp/Shared/DivingSuitSlot.cs[/code] (registry, five patch layers, XML/Lua discovery, layout override) — compiled at launch by the game's built-in LuaCs runtime. Anyone can read, learn from and build on it.

◆ Installation

[list=1] [*]Subscribe to this mod [*]Enable it in the mod list [*]Click "Allow" on the C# mod permission prompt (this is a code mod) [*]Open your inventory — the new diving suit slot is right there [/list]

◆ Multiplayer (important)

• The host and every client must subscribe and enable this mod themselves — the server does not auto-force subscriptions
• Servers should enable the Workshop version, not a LocalMods copy
• Hosts are advised to declare this mod as required content in their submarine file, so players missing it are clearly blocked with a message
• Version mismatches cause join errors — everyone should be on the latest version (1.3.0 M15 BETA)

◆ FAQ

Q: Do vests draw OVER the diving suits or UNDER? A: Vests draw OVER the diving suits (armor on the outside). Q: Why is there no subscribe prompt when joining a server? A: The prompt only appears when joining through the server browser; direct friend invites skip it. Subscribe to this mod beforehand. Q: I'm a mod author — how do I add a custom slot to my mod? A: See "Open Code" above: a declaration file plus a slot icon style is all it takes; position it freely with row/col/yoff. Full docs in the mod folder.

◆ Technical notes