夜猫子RustRUST SERVER MODS
免费插件

Monument Finder

纪念碑搜寻器

为其他插件提供 API 来查找纪念碑并确定其边界

monument服务器管理

原作者：WhiteThunder · 查看 uMod 官方页面 ↗

插件介绍

为其他插件提供 API 来查找纪念碑并确定其边界

The primary objective of Monument Finder is to accurately define the bounds of monuments. This is necessary because the bounds defined by the game are not accurate for every monument, and there is no way for map makers to define bounds for their custom monuments. Plugins that care where monuments are located and how much space they occupy can utilize Monument Finder to find out. Server owners can assist plugins that use Monument Finder by defining or overriding monuments bounds in the config as needed.

All plugins that use Monument Finder get the same information, allowing them to have a consistent view of which monuments occupy which space. This is a feature, but not every plugin necessarily wants the same view of monuments. For example, a plugin that wants to limit teleportation radius around a monument may want different bounds than defined in Monument Finder. In such a case, that plugin can provide its own logic/config for defining monument bounds and doesn't need to use Monument Finder.

For vanilla monuments that already have fairly accurate bounds, Monument Finder simply operates using those bounds. For vanilla monuments that have inaccurate bounds, as well as for underground Train Tunnel sections, Monument Finder provides hard-coded bounds that the developer and/or community has deemed accurate. The bounds can also be overriden by server owners in the config.

Underwater labs are procedurally generated collections of modules. Monument Finder considers each module as a separate monument, since the overall lab monument doesn't have a consistent layout. As a result, this allows server owners to, for example, use the Monument Addons plugin to place a vending machine in a moonpool module, causing every instance of that moonpool module to have an identical vending machine, across all underwater lab monuments.

主要用途

主要用于monument、服务器管理等服务端功能。 本插件由 WhiteThunder 发布，当前目录记录版本为 v3.1.5，uMod 累计下载 50,788 次。

适用场景

  • 需要管理、审计或维护能力的服务器

功能分类

monument服务器管理
查看 uMod 官方英文简介

Provides an API for other plugins to find monuments and determine their bounds

权限节点

monumentfinder.find

Allows players to find monuments. Intended for administrators.

授权示例：oxide.grant user 玩家名 权限节点；撤销使用 oxide.revoke。

指令说明

Note: The command mf can be changed in the plugin configuration.

mf

Prints help info about available commands.

mf list <filter>

List all monuments, train tunnels, and underwater lab modules. The filter is optional.

mf show <filter>

(Requires admin) Shows text above all monuments, train tunnels, and underwater lab modules. The filter is optional.

mf closest

Prints information about the closest monument, train tunnel, or underwater lab module. If admin, this also displays the monument bounds.

mf closest config

Adds an entry into the config for the closest monument.

相关依赖

  • Custom Vending Setup
  • Monument Addons
  • Monument Teleporter
  • Spawn Modular Car

配置说明

Default configuration:

{ "Command": "mf", "Default custom monument settings": { "Position": { "Auto determine from monument marker": true, "Auto determine from prevent building volume": false }, "Rotation": { "Auto determine from monument marker": true, "Auto determine from prevent building volume": false }, "Bounds": { "Auto determine from monument marker": false, "Auto determine from prevent building volume": false, "Use custom bounds": true, "Custom bounds": { "Size": { "x": 30.0, "y": 30.0, "z": 30.0 }, "Center adjustment": { "x": 0.0, "y": 10.0, "z": 0.0 } } } }, "Monuments": { "example_monument": { "Position": { "Auto determine from monument marker": true, "Auto determine from prevent building volume": false }, "Rotation": { "Auto determine from monument marker": true, "Auto determine from prevent building volume": false }, "Bounds": { "Auto determine from monument marker": false, "Auto determine from prevent building volume": false, "Use custom bounds": true, "Custom bounds": { "Size": { "x": 30.0, "y": 30.0, "z": 30.0 }, "Center adjustment": { "x": 0.0, "y": 10.0, "z": 0.0 } } } } } }

Command

Determines the base command of the plugin.

Default custom monument settings

Defines how the plugin will determine the position, rotation and bounds of custom monuments. The behavior for individual custom monuments can be overriden in the Monuments section on the config.Position -- Defines how the plugin will determine the monument's "origin". Plugins such as Monument Addons or Custom Vending Setup will capture coordinates relative to the origin. Caution: Changing how the origin is determined for a monument may cause issues with plugins that have already generated coordinates relative to that monument, meaning you may have to redo setup for those plugins at that monument.Auto determine from monument marker (true or false) -- While true, plugins will see the monument's origin as the monument marker's position.Note: Since RustEdit does not currently allow custom prefabs to include a monument marker, map developers might not position/rotate monument markers consistently for every instance of a monument, so relying on the marker position/rotation may cause issues with plugins that use monument-relative coordinates.Auto determine from prevent building volume (true or false) -- While true, plugins will see the monument's origin as the center of the Prevent Building Sphere/Cube, if there is one overlapping the monument marker.Rotation -- Defines how the plugin will determine the monument's rotation. Caution: Changing how the rotation is determined for a monument may cause issues with plugins that have already generated coordinates relative to that monument, meaning you may have to redo setup for those plugins at that monument.Auto determine from monument marker (true or false) -- While true, plugins will see the monument's rotation as the monument marker's rotation.Note: Since RustEdit does not currently allow custom prefabs to include a monument marker, map developers might not position/rotate monument markers consistently for every instance of a monument, so relying on the marker position/rotation may cause issues with plugins that use monument-relative coordinates.Auto determine from prevent building volume (true or false) -- While true, plugins will see the monument's rotation as the rotation of the Prevent Building Sphere/Cube, if there is one overlapping the monument marker.Bounds -- Defines how the plugin will determine the monument's bounding box. Bounds are used by other plugins to accurately determine whether a given position is in a monument, and to determine specifically which monument.Auto determine from monument marker (true or false) -- While true, plugins will see the monument's bounding box as monument marker's bounding box. This is an appropriate choice only if the map developer scaled the monument marker to cover the monument, which you should encourage map developers to do since it makes it very easy for this plugin to determine monument bounds.Auto determine from prevent building volume (true or false) -- While true, plugins will see the monument's bounding box as the bounds of the Prevent Building Sphere/Cube, if there is one overlapping the monument marker.Use custom bounds (true or false) -- While true, plugins will see the monument's bounding box as you configure in Custom bounds.Custom boundsSize -- Determines the size of the bounding box relative to the monument's origin. For example, if the monument is shaped like a cube, set x, y and z to the same value.Center adjustment -- Adjusts the center of the bounding box, relative to the monument's origin. For example, if you want the center of the bounding box to be 10 meters above the monument's origin, set this to "x": 0, "y": 10, "z": 0.

Monuments

This section allows you to override the configuration for individual monuments, including vanilla monuments and custom monuments. Customizing train tunnels and underwater labs is not supported. The options are the same as for Default custom monument settings, but options such as Auto determine from monument marker and Auto determine from prevent building volume have no effect on vanilla monuments.

Position

Defines how the plugin will determine the monument's "origin". Plugins such as Monument Addons or Custom Vending Setup will capture coordinates relative to the origin. Caution: Changing how the origin is determined for a monument may cause issues with plugins that have already generated coordinates relative to that monument, meaning you may have to redo setup for those plugins at that monument.Auto determine from monument marker (true or false) -- While true, plugins will see the monument's origin as the monument marker's position.Note: Since RustEdit does not currently allow custom prefabs to include a monument marker, map developers might not position/rotate monument markers consistently for every instance of a monument, so relying on the marker position/rotation may cause issues with plugins that use monument-relative coordinates.Auto determine from prevent building volume (true or false) -- While true, plugins will see the monument's origin as the center of the Prevent Building Sphere/Cube, if there is one overlapping the monument marker.

Rotation

Defines how the plugin will determine the monument's rotation. Caution: Changing how the rotation is determined for a monument may cause issues with plugins that have already generated coordinates relative to that monument, meaning you may have to redo setup for those plugins at that monument.Auto determine from monument marker (true or false) -- While true, plugins will see the monument's rotation as the monument marker's rotation.Note: Since RustEdit does not currently allow custom prefabs to include a monument marker, map developers might not position/rotate monument markers consistently for every instance of a monument, so relying on the marker position/rotation may cause issues with plugins that use monument-relative coordinates.Auto determine from prevent building volume (true or false) -- While true, plugins will see the monument's rotation as the rotation of the Prevent Building Sphere/Cube, if there is one overlapping the monument marker.

Bounds

Defines how the plugin will determine the monument's bounding box. Bounds are used by other plugins to accurately determine whether a given position is in a monument, and to determine specifically which monument.Auto determine from monument marker (true or false) -- While true, plugins will see the monument's bounding box as monument marker's bounding box. This is an appropriate choice only if the map developer scaled the monument marker to cover the monument, which you should encourage map developers to do since it makes it very easy for this plugin to determine monument bounds.Auto determine from prevent building volume (true or false) -- While true, plugins will see the monument's bounding box as the bounds of the Prevent Building Sphere/Cube, if there is one overlapping the monument marker.Use custom bounds (true or false) -- While true, plugins will see the monument's bounding box as you configure in Custom bounds.Custom boundsSize -- Determines the size of the bounding box relative to the monument's origin. For example, if the monument is shaped like a cube, set x, y and z to the same value.Center adjustment -- Adjusts the center of the bounding box, relative to the monument's origin. For example, if you want the center of the bounding box to be 10 meters above the monument's origin, set this to "x": 0, "y": 10, "z": 0.

Auto determine from monument marker (true or false) -- While true, plugins will see the monument's origin as the monument marker's position.Note: Since RustEdit does not currently allow custom prefabs to include a monument marker, map developers might not position/rotate monument markers consistently for every instance of a monument, so relying on the marker position/rotation may cause issues with plugins that use monument-relative coordinates.

Auto determine from prevent building volume (true or false) -- While true, plugins will see the monument's origin as the center of the Prevent Building Sphere/Cube, if there is one overlapping the monument marker.

Note: Since RustEdit does not currently allow custom prefabs to include a monument marker, map developers might not position/rotate monument markers consistently for every instance of a monument, so relying on the marker position/rotation may cause issues with plugins that use monument-relative coordinates.

Auto determine from monument marker (true or false) -- While true, plugins will see the monument's rotation as the monument marker's rotation.Note: Since RustEdit does not currently allow custom prefabs to include a monument marker, map developers might not position/rotate monument markers consistently for every instance of a monument, so relying on the marker position/rotation may cause issues with plugins that use monument-relative coordinates.

Auto determine from prevent building volume (true or false) -- While true, plugins will see the monument's rotation as the rotation of the Prevent Building Sphere/Cube, if there is one overlapping the monument marker.

Auto determine from monument marker (true or false) -- While true, plugins will see the monument's bounding box as monument marker's bounding box. This is an appropriate choice only if the map developer scaled the monument marker to cover the monument, which you should encourage map developers to do since it makes it very easy for this plugin to determine monument bounds.

Auto determine from prevent building volume (true or false) -- While true, plugins will see the monument's bounding box as the bounds of the Prevent Building Sphere/Cube, if there is one overlapping the monument marker.

Use custom bounds (true or false) -- While true, plugins will see the monument's bounding box as you configure in Custom bounds.

Custom boundsSize

Determines the size of the bounding box relative to the monument's origin. For example, if the monument is shaped like a cube, set x, y and z to the same value.Center adjustment -- Adjusts the center of the bounding box, relative to the monument's origin. For example, if you want the center of the bounding box to be 10 meters above the monument's origin, set this to "x": 0, "y": 10, "z": 0.

Size

Determines the size of the bounding box relative to the monument's origin. For example, if the monument is shaped like a cube, set x, y and z to the same value.

Center adjustment

Adjusts the center of the bounding box, relative to the monument's origin. For example, if you want the center of the bounding box to be 10 meters above the monument's origin, set this to "x": 0, "y": 10, "z": 0.

官方配置示例

{
  "Command": "mf",
  "Default custom monument settings": {
    "Position": {
      "Auto determine from monument marker": true,
      "Auto determine from prevent building volume": false
    },
    "Rotation": {
      "Auto determine from monument marker": true,
      "Auto determine from prevent building volume": false
    },
    "Bounds": {
      "Auto determine from monument marker": false,
      "Auto determine from prevent building volume": false,
      "Use custom bounds": true,
      "Custom bounds": {
        "Size": {
          "x": 30.0,
          "y": 30.0,
          "z": 30.0
        },
        "Center adjustment": {
          "x": 0.0,
          "y": 10.0,
          "z": 0.0
        }
      }
    }
  },
  "Monuments": {
    "example_monument": {
      "Position": {
        "Auto determine from monument marker": true,
        "Auto determine from prevent building volume": false
      },
      "Rotation": {
        "Auto determine from monument marker": true,
        "Auto determine from prevent building volume": false
      },
      "Bounds": {
        "Auto determine from monument marker": false,
        "Auto determine from prevent building volume": false,
        "Use custom bounds": true,
        "Custom bounds": {
          "Size": {
            "x": 30.0,
            "y": 30.0,
            "z": 30.0
          },
          "Center adjustment": {
            "x": 0.0,
            "y": 10.0,
            "z": 0.0
          }
        }
      }
    }
  }
}
{
  "NoPermission": "You don't have permission to do that.",
  "NoMonumentsFound": "No monuments found",
  "AtMonument": "At monument: {0}\nRelative position: {1}",
  "ClosestMonument": "Closest monument: {0}\nDistance: {1:f2}m",
  "Closest.Config.Success": "Added monument <color=#9f6>{0}</color> to the plugin config.",
  "Closest.Config.AlreadyPresent": "Monument <color=#9f6>{0}</color> is already in the plugin config.",
  "List.Header": "Listing monuments:",
  "Help.Header": "Monument Finder commands:",
  "Help.List": "<color=#9f6>{0} list <filter></color> - List monuments matching filter",
  "Help.Show": "<color=#9f6>{0} show <filter></color> - Show monuments matching filter",
  "Help.Closest": "<color=#9f6>{0} closest</color> - Show info about the closest monument",
  "Help.Closest.Config": "<color=#9f6>{0} closest config</color> - Adds the closest monument to the config"
}

更新日志

最新版本： v3.1.5
最后版本发布： 2025-09-14
最后更新（条目）： 2026-07-19

本站记录 uMod 官方插件信息。完整的历史更新日志请参阅 uMod 官方页面。

安装方法

  1. 确认服务器已安装 Oxide / uMod 或兼容的 Carbon 框架。
  2. 登录本站后点击"下载"，由 uMod 官方地址获取作者发布的文件。
  3. 将 .cs 文件放入服务器的 oxide/plugins 目录。
  4. 观察服务端控制台，确认插件编译并成功加载。
  5. 具体配置、权限、指令和依赖请查看原作者的 uMod 页面。

使用前注意

  • Rust 更新后，请先确认插件是否仍兼容当前服务端版本。
  • 修改配置前建议备份原配置文件，并在测试服验证后再部署到正式服。
  • 若插件依赖其他扩展或库，以 uMod 原作者页面的最新说明为准。
  • 本站中文内容用于辅助理解，遇到版本差异时以官方英文文档和源码为准。
来源说明

中文介绍由 uMod 官方简介翻译整理。插件著作权、许可证、完整文档和最新发布状态均以原作者及 uMod 官方页面为准。