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）。