Group Effort

🌟 GroupEffort for Minecraft (Fabric & Forge via Sinytra Connector) 🌟

Tired of empty servers? GroupEffort encourages your community to play together!

This server-side Fabric mod makes server activity contingent on a minimum number of online players. When the player count falls below your configured threshold (after an optional grace period), the server enters a restricted "limbo" state until enough players join the effort!

 Core Concept

GroupEffort aims to make your server truly come alive when a community gathers. It can help:

• Foster a sense of community and encourage group play.
• Manage server resources during off-peak hours by restricting non-essential activities.

 Features

• Minimum Player Quota: Set how many players are needed for full server activity.
• Configurable Limbo States:
  • THE_VOID: Players are visually teleported very high up. The client renders The End skybox (if GroupEffort is also installed on the client), creating a distinct void experience. The world below is hidden by server-side packet filtering.
  • LOCALIZED_FREEZE: Players remain visually where they are when limbo activates.
• Movement & Interaction Blocking: In any limbo state, player movement, block interactions, and entity interactions are blocked.
• Grace Period: A configurable countdown before limbo restrictions apply.
• Customizable Chat Messages: Tailor all mod messages with color codes & placeholders.
• Configurable Chat Blocking: Optionally block chat for players in limbo.
• Operator Commands: Adjust key settings on-the-fly.
• Server-Side: Core logic runs on the server.

Limbo Types Explained

• THE_VOID:
  • Visually teleports the player high up.
  • The client renders The End skybox for a "void" atmosphere.
  • The world below is hidden by filtering server-to-client packets.
  • Movement/interactions are blocked; abilities are packet-modified to prevent falling.
• LOCALIZED_FREEZE:
  • Players stay visually where they are.
  • Movement/interactions are blocked; abilities are packet-modified.
  • Players see their surroundings (updates depend on server tick state).

 Installation

1. Requires Fabric Loader for Minecraft on your server.
2. Download GroupEffort .jar from CurseForge.
3. Place .jar into your server's mods folder.
4. Dependencies (MUST be in mods folder):
   • Fabric API
   • Cloth Config API (Fabric)
5. Recommended for Admins/Clients: ModMenu (client-side) for easier configuration if your server syncs configs or for local testing.

Configuration

Access settings via:

• ModMenu (if installed on a client with config access).
• Editing config/groupeffort.json in your server directory (after first run).

Key Options:

• General:
  • minimumPlayers: (Default: 2) Players needed for an active server (0 to disable).
  • blockChatMessages: (Default: false) If true, players in limbo can't chat.
  • limboType: (Default: THE_VOID) Choose THE_VOID or LOCALIZED_FREEZE.
• Grace Period:
  • enabled: (Default: true) Enable/disable grace period.
  • durationSeconds: (Default: 180) Grace period length.
• Chat Messages: Customize all mod announcements (supports color codes & placeholders like %player%, %needed%, etc.).

 Operator Commands

Base command: /groupeffort (requires permission level 2+)

• /groupeffort set minimumPlayers <count>
• /groupeffort set limboType <THE_VOID | LOCALIZED_FREEZE>
• /groupeffort set blockChatMessages <true | false>
• /groupeffort set graceEnabled <true | false>
• /groupeffort set graceDuration <seconds>
• /groupeffort status (View current settings)

 Dependencies

• Fabric API (Required)
• Cloth Config API (via AutoConfig) (Required)
• ModMenu (Client-side, Optional, for in-game config GUI)

 How It Works

GroupEffort monitors player counts. If below the minimum (after grace), players enter limbo. Actions are blocked by cancelling client packets. For THE_VOID, visuals are manipulated by teleporting high and filtering world data packets to show The End skybox. LOCALIZED_FREEZE keeps players in place. Server ticks may be restricted. When the quota is met, players are restored.

Reporting Bugs & Issues

Please report issues on the GitHub Issues page.

Include: Minecraft version, Fabric Loader version, GroupEffort version, other mod versions, clear description, steps to reproduce, and any logs/crash reports.