DeepSeaPirateTreasure

A Deep Sea treasure event plugin using Rust’s native metal detector flow.

DeepSeaPirateTreasure adds a pirate treasure hunt to the Deep Sea area. When Deep Sea opens, the plugin can automatically start an event by selecting valid native Deep Sea detector spots. Players search normally with a metal detector, uncover a custom treasure flag, dig it up, and reveal a protected loot crate.

The plugin is built around Deep Sea gameplay only. It does not create regular land treasure events and is not meant to interfere with normal detector finds outside Deep Sea.

Features

• Automatic Deep Sea treasure events
• Manual admin start, stop and status command
• Uses native Deep Sea metal detector spots
• Main treasure and optional treasure support
• Configurable loot profiles
• Configurable treasure types
• Per-island variant treasure layouts
• Protected treasure crates with finder lock
• Optional treasure island map marker
• Admin-only debug markers for setup and testing
• Clean event cleanup on stop, Deep Sea close, unload or completion

How It Works

When Deep Sea becomes active, the plugin checks the live Deep Sea islands and selects valid native buried treasure spots.

Players still use normal Rust detector gameplay. Once a selected spot is found, the plugin converts that specific native detector flag into a pirate treasure objective.

After the required digs, the flag reveals a custom loot crate. Main treasures can be required for event completion, while optional treasures can be used as extra side rewards.

Main and Optional Treasures

The plugin supports different treasure types.

A main treasure can be marked as required for the event to complete.

Optional treasures are extra rewards. They can be found and looted, but they do not have to be claimed before the event can finish.

This makes it possible to run a simple event like:

1 main treasure
1 optional treasure

Or a larger event with more optional rewards, depending on the island layout and server balance.

Configuration

The plugin uses separate data files, so server owners can edit the event without touching the plugin code.

The main files are:

• TreasureTypes
• LootProfiles
• IslandVariantProfiles

TreasureTypes controls things like crate prefab, dig count, lifetime, display name and whether the treasure is required for event completion.

LootProfiles controls what loot goes inside the crate.

IslandVariantProfiles controls which treasure types can appear on each Deep Sea island variant.

Commands

/dstreasure
Shows the command help.

/dstreasure start
Manually starts a treasure event using a live Deep Sea island.

/dstreasure stop
Stops the active event and cleans spawned content.

/dstreasure status
Shows the current event status.

/dstreasure debug
Draws the active treasure debug marker for yourself while inside Deep Sea.

Permission

deepseapiratetreasure.admin

Required for the admin command.

Notes

The plugin is best tested with Debug Logging enabled first.

For testing, go inside Deep Sea and use /dstreasure debug after the event starts. This shows the selected treasure spots only to you.

For live servers, Debug Logging can be disabled once setup is confirmed.

For setup help, updates and support, join my Discord:

https://discord.gg/jewGrSqHB4