Mod Introduction

EcoPower is an energy-saving plugin for Minecraft servers on Windows. It dynamically switches system power plans based on predefined online player ranges, reducing power consumption during idle periods.

---

Key Features

✅ Smart Power Management

• Auto-switch power plans (e.g., Power Saver/High Performance) via player count thresholds.
  ✅ Bot Player Filtering
• Exclude fake players using name prefixes (e.g., bot_), suffixes (e.g., _bot), or regex patterns.
  ✅ Flexible Configuration
• Customize power plan GUIDs and broadcast messages.
• Hot-reload configs without server restart.
  ✅ Easy Control
• Manually switch plans via commands.
• Real-time config status monitoring.

---

Commands

Command	Description
/ecopower reload	Reload config file instantly
/ecopower show	Show all configs and current status
/ecopower show	Show status for a specific config
/ecopower set plan	Manually switch power plan

---

Configuration Guide

Path: config/ecopower/config.yaml

# Define Power Plans
plan:
  power_saver:  # Custom plan name
    guid: a1841308-3541-4fab-bc81-f71556f20b4a  # Windows power plan GUID
    range: [-2147483648, 0]  # Player range [min, max] (inclusive)
    broadcastMessage: "§a[Eco Power] §7Switched to §aPower Saver Mode"
  balanced:
    guid: 381b4222-f694-41f0-9685-ff5bb260df2e
    range: [1, 2]
    broadcastMessage: "§a[Eco Power] §7Switched to §eBalanced Mode"
  high_performance:
    guid: 8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c
    range: [3, 2147483647]
    broadcastMessage: "§a[Eco Power] §7Switched to §cHigh Performance Mode"

# Player Exclusion Rules
exclude:
  prefixes: ["bot_"]     # Exclude by prefix (e.g., bot_Steve)
  suffixes: ["_bot"]     # Exclude by suffix (e.g., Steve_bot)
  regexes: []            # Exclude by regex (e.g., ".*bot.*")

broadcastChanges: true # Broadcast plan switch messages

##### **Configuration Details**

*   **`plan`**  
    *   `guid`: Obtain via `powercfg /list` in Command Prompt.
    *   `range`: Player count range to trigger the plan (boundaries inclusive).
    *   `broadcastMessage`: Broadcast message on plan switch (supports § color codes).
*   **`exclude`**: Rules to exclude players from counts (priority: prefix > suffix > regex).
*   **`broadcastChanges`**: Set to `false` to disable switch broadcasts.

***

#### **插件介绍**

**EcoPower** 是一款专为 Windows 平台 Minecraft 服务器设计的节能插件。通过监测在线玩家数量范围，自动切换系统电源计划，显著降低服务器闲置时的电力消耗。

***

#### **核心功能**

✅ **智能电源管理**

*   根据预定义的在线玩家数量范围，自动切换高性能/节能电源计划。  
    ✅ **假人玩家过滤**
*   支持名称前缀（如 `bot_`）、后缀（如 `_bot`）和正则表达式排除假人玩家。  
    ✅ **灵活配置**
*   自定义电源计划 GUID 和广播消息。
*   支持热重载配置，无需重启服务器。  
    ✅ **便捷控制**
*   命令手动切换电源计划。
*   实时查看配置状态。

***

#### **命令列表**

| 命令                                     |功能          |
| -------------------------------------- |----------- |
| <code>/ecopower reload</code>          |热重载配置文件     |
| <code>/ecopower show</code>            |显示所有配置及当前状态 |
| <code>/ecopower show <配置名></code> |查看指定配置状态    |
| <code>/ecopower set plan <计划名></code> |手动切换电源计划    |

***

#### **配置文件说明**

**路径**: `config/ecopower/config.yaml`

电源计划定义

plan: power_saver: # 计划名称（自定义） guid: a1841308-3541-4fab-bc81-f71556f20b4a # Windows 电源计划 GUID range: [-2147483648, 0] # 玩家数范围 [最小值, 最大值]（闭区间） broadcastMessage: "§a[Eco Power] §7服务器已切换至§a节能模式" # 切换时广播消息 balanced: guid: 381b4222-f694-41f0-9685-ff5bb260df2e range: [1, 2] broadcastMessage: "§a[Eco Power] §7服务器已切换至§e平衡模式" high_performance: guid: 8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c range: [3, 2147483647] broadcastMessage: "§a[Eco Power] §7服务器已切换至§c高性能模式"

玩家排除规则

exclude: prefixes: ["bot_"] # 名称前缀排除（如 bot_Steve） suffixes: ["_bot"] # 名称后缀排除（如 Steve_bot） regexes: [] # 正则表达式排除（如 ".bot."）

broadcastChanges: true # 是否广播计划切换消息

##### **配置详解**

*   **`plan`**  
    *   `guid`：通过 `powercfg /list` 获取的电源计划 GUID。
    *   `range`：触发该计划的在线玩家数量范围（含边界值）。
    *   `broadcastMessage`：计划切换时的广播消息（支持 Minecraft 颜色代码 §）。
*   **`exclude`**：不计入玩家统计的规则（优先级：前缀 > 后缀 > 正则）。
*   **`broadcastChanges`**：设为 `false` 可禁用切换广播。

***

> **注意 (Note)**
> 
> *   插件仅支持 Windows 服务器（Requires Windows Server）。
> *   使用 `powercfg /list` 获取系统电源计划 GUID（Run as Administrator）。