# OperateMyServer (addon)

The **`oms` addon** is the default bundled addon that ships with the OperateMyServer system.\
While the OMS system provides the core runtime, lifecycle events, and feature infrastructure, this addon contains actual built-in features that run on top of it.

### Role of the Addon

* Registers bundled features (starting with `scheduled_restart`)
* Uses the same public API available to any addon
* Evolves independently of the OMS core system

This design allows the OMS system to remain minimal and stable, while the bundled addon can grow and receive updates without affecting system internals.

***

### Included Features

Currently included:

* [**Scheduled Restart**](/oms-wiki/addons/operatemyserver-addon/scheduled-restart.md)\
  Automatically restarts the server at specified times.\
  Supports multiple restart times and pre-defined in-game warning messages.\
  Can be skipped using `/oms skip`.

The list of bundled features may be expanded in future versions.

***

### Configuration

The addon uses a shared config file:

```
world/serverconfig/oms-server.toml
```

This file includes two logical sections:

#### `[common]` – OMS System Settings

System-wide configuration for OMS behavior.

Example:

```toml
[common]
# Enables logging the reason for each server shutdown to a persistent file
loggingStopReason = false
```

#### `[features]` – Feature Configuration

All features declared by the `oms` addon are listed here.\
Each feature has its own sub-section.

Example:

```toml
[features.scheduled_restart]
enabled = true
times = ["00:00", "06:00", "12:00", "18:00"]
warning_times = ["2h", "30m", "15m", "10m", "5m", "2m", "1m", "30s", "15s", "10s", "5s", "4s", "3s", "2s", "1s"]
```

Each feature defines its own format for time, thresholds, and behavior.\
Full documentation is available on individual feature pages.

***

### Installation

The `oms` addon is bundled with the OMS system by default.\
No separate installation is required.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://conboi.gitbook.io/oms-wiki/addons/operatemyserver-addon.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
