Operate My Server

Operate My Server (OMS) is a server-side utility mod for Forge that handles automated restarts and server lifecycle control.

Use OMS if you run a modded Minecraft server and want scheduled restarts, player warnings, safer shutdown handling, and expandable server automation without installing a bunch of unrelated utility mods.

Lightweight, modular, and built to be extended through addons.

What it does

• Scheduled server restarts with player warnings
• Centralized restart & shutdown handling
• Modular system - features can be enabled or disabled independently
• Addon support for extra server automation and monitoring features

Condition-based triggers such as low TPS detection, empty server detection, and health checks are provided through addons like Watchdog Essentials.

Why OMS

Most mods solve one problem.

OMS gives you a base system where you can:

• run only what you need
• add new behavior later via addons
• disable features without removing the whole mod

Simple setup, flexible control, and extensible by design.

Requirements

Server-side mod (client not required)

• Minecraft 1.20.1
• Forge 47.4.0+
• KotlinForForge 4.11.0

Support for newer Minecraft and Forge versions is planned.

Installation

Download:

OMS

• CurseForge
• Modrinth
• OMS Maven

Kotlin For Forge 4.11.0

• CurseForge
• Modrinth

Required files:

• oms-x.y.z.jar
• kotlinforforge-4.11.0.jar

Place them into your mods/ folder.

Start the server normally - OMS will initialize automatically.

For automatic restart functionality, run the server through the provided OMS restart script. OMS handles the controlled shutdown and restart request, while the script starts the Java process again. See the Restart Script Setup

Basic usage

Restart the server manually:

/oms restart

View available OMS features:

/oms feature

Enable or disable a feature:

/oms feature <feature> enable
/oms feature <feature> disable

Use /oms feature to control features without removing the mod from your server.

Config

Main OMS config:

world/serverconfig/oms-server.toml

Each addon may create its own config file.

Addons

OMS supports addons - separate mods that add new features.

Install them like any other mod: drop the .jar into mods/.

Start with:

• Watchdog Essentials - server monitoring and automatic restart triggers.
  • CurseForge
  • Modrinth
  • OMS Maven
  • Wiki

More addons coming soon…

Documentation

Full documentation and guides are available on the OMS Wiki

Want to build your own addons? Check the Development Guide on the same wiki