> For the complete documentation index, see [llms.txt](https://conboi.gitbook.io/oms-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://conboi.gitbook.io/oms-wiki/introduction.md).

# Introduction

**Operate My Server (OMS)** is a modular Minecraft Forge mod designed to give server owners fine-grained control over server behavior, automated actions, and event-based lifecycle management.

Whether you're running a private server for friends or hosting a more complex public server, OMS empowers you to build your own logic around restarts, monitoring, scheduled events, and beyond - using a clean addon-based architecture.

***

#### Why Use Operate My Server?

* Automate server restarts with fully configurable schedules and in-game warnings
* Extend OMS with addons that react to server conditions such as low TPS, low memory, or an empty player list
* Interact with every feature via powerful in-game `/oms` commands
* Modular system: each addon contains isolated features you can enable or disable
* Reload supported configuration at runtime without restarting the server
* Easy to extend: write your own addons using a clean, documented API

***

#### Who Is It For?

* **Server Owners** – manage restarts, shutdowns, and server conditions while keeping startup and process management in your existing scripts, hosting panel, or service manager
* **Modpack Developers** – bundle smart server logic like scheduling, idle detection, and watchdogs into your pack
* **Mod Developers** – build powerful lifecycle-based features and admin tools using the OMS addon API

***

#### Requirements

* **Minecraft:** 1.20.1
* **Forge:** 47.4.0 or latest stable version for 1.20.1
* **Kotlin for Forge:** 4.11.0
* **Server-side only** - no client installation required