Piggy Admin

A server-side administration mod designed to help manage and enforce settings for compatible client-side mods (like Piggy Build and Piggy Inventory). Currently, it serves as a central point for managing anti-cheat options, logging, and detection, but it will evolve to include more administration tools.

---

⚠️ Disclaimer

This is a personal project. It comes AS IS and might cause issues.

• No Support: Do not expect regular support or bug fixes.
• No Forge Port: There are NO plans to port this mod to Forge.
• Use at your own risk.

Feel free to fork the project or submit a Pull Request if you want to contribute fixes or features!

---

Features

🛡️ Anti-Cheat Enforcement

• Centralized Control: Configure whether "cheat" features (like fast placement, tool swapping) are allowed on your server.
• Automatic Sync: When a player joins, the server's anti-cheat configuration is automatically sent to their client.
• Strict Enforcement: If the server disables cheats, client-side overrides are ignored, ensuring fair play.
• Granular Control: Enable/disable specific features individually (e.g., allow tool swapping but forbid fast placement).

🕵️ X-Ray Detection

• Heuristic Detection: The server monitors mining patterns to detect suspicious behavior.
• Ratio Analysis: Calculates the ratio of rare ores (Diamond, Ancient Debris) mined versus common blocks (Stone, Netherrack).
• Configurable Thresholds: Adjust sensitivity via xrayMaxRatio in config.
• Alerts: Admins are notified if a player's mining ratio exceeds the configured threshold.

📜 History & Logging

• Sign History: Tracks who placed a sign and what was written on it.
• Chat History: Logs all chat messages for administrative review.
• Blame Tool: Inspect existing signs/blocks to see who interacted with them and when.
• Persistent Storage: History survives server restarts (saved to config/piggy-admin-history.json).

---

Commands

All commands require OP level 2 or higher.

General Administration

• /piggy cheats <allow|forbid>: Globally allow or forbid "cheat" features for all players.
• /piggy feature list: List all controllable features and their current status.
• /piggy feature <id> <enable|disable>: Enable or disable a specific feature (e.g., flexible_placement, tool_swap).

Investigation & Logging

• /blame: Look at a sign or block and run this command to see who placed/modified it and when.
• /logs <player_name>: View the recent chat and sign history for a specific player.
  • Clickable Coordinates: Sign logs include coordinates that you can click to teleport to.

---

Configuration

The mod generates a configuration file at config/piggy-admin-server.json (server-side).

{
  "allowCheats": false,
  "features": {
    "flexible_placement": true,
    "fast_place": false,
    "tool_swap": true
  },
  "xrayMaxRatio": 0.15,
  "xrayMinBlocks": 20
}

• "allowCheats": false: Forces all connected clients to disable restricted features.
• "allowCheats": true: Allows clients to use their own local settings.
• "features": Granular control over individual features (only applies when allowCheats: true).
• "xrayMaxRatio": Maximum allowed ratio of rare ores to total blocks (default 15%).
• "xrayMinBlocks": Minimum blocks mined before X-Ray detection activates (default 20).

---

Dependencies & Installation

Requirements

• Minecraft: ~1.21.1
• Fabric Loader: >=0.18.1
• Java: >=21

Required Mods

• Fabric API: Any version
• YACL (Yet Another Config Lib): >=3.6.1+1.21-fabric (for clients to view config)
• Piggy Lib: >=1.0.1
• (Optional) Mod Menu: >=11.0.3 - Recommended for clients.

Installation

1. Download the .jar file from Releases.
2. Install Fabric Loader for Minecraft 1.21.1.
3. Place the piggy-admin jar (along with Fabric API and Piggy Lib) into your server's mods folder.
4. Launch the server!

---

Todo / Future Features

• Detect XRay: Implement heuristics/checks to detect players using XRay texture packs or mods.
• Moderate Sign Text: Add tools to inspect and filter text on signs to prevent inappropriate content.

---

Inspiration

This mod was inspired by:

• ItemSwapper - For the concept of server-side item management and swapping mechanics.

---

License: CC0-1.0