EcoPower

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 <config>	Show status for a specific config
/ecopower set plan <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 和广播消息。
• 支持热重载配置，无需重启服务器。
  ✅ 便捷控制
• 命令手动切换电源计划。
• 实时查看配置状态。

---

命令列表

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

---

配置文件说明

路径: 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）。