Carpet PvP Documentation

Overview

Carpet PvP is a server-side mod for Minecraft 1.21.5 built on Fabric that provides a wealth of features, commands, and configuration options for server administrators and players. It's based on the popular Carpet Mod and includes:

100+ Configurable Rules

Tweak game mechanics, performance, and behavior with extensive configuration options.

Comprehensive Commands

Advanced debugging, monitoring, and player management tools.

Scarpet Scripting

Custom automation and features with built-in scripting language.

Performance Tools

Real-time profiling and optimization features.

Installation

Requirements

  • Minecraft 1.21.5
  • Fabric Loader 0.16.9+
  • Fabric API 0.111.0+1.21.5

Modrinth Installation (Recommended)

Quick Install

  1. Download from Modrinth
  2. Place the JAR file in your mods folder
  3. Ensure Fabric API is also installed
  4. Start your server

Manual Installation

  1. Download from GitHub Releases
  2. Place in your server's mods folder
  3. Start the server

Commands

Core Commands

/carpet - Main Configuration

Access and modify Carpet rules and settings.

/carpet - List all available rules
/carpet <rule> - Show current value and options
/carpet <rule> <value> - Set a rule to specific value

/counter - Item Counting

Monitor item flow through hopper counters.

/counter - Show all counter channels
/counter <color> - Display specific color counter
/counter <color> reset - Reset specific counter

/spawn - Mob Spawning Analysis

Track and analyze mob spawning patterns.

/spawn tracking start [from] [to] - Start tracking
/spawn test [ticks] [counter] - Run spawn rate test
/spawn mobcaps - Show current mob caps

/player - Fake Player Control

Control and spawn fake players for testing.

/player <name> spawn - Spawn fake player
/player <name> <action> - Perform action
/player <name> kill - Remove fake player

/log - Event Logging

Subscribe to various game event loggers.

/log - List available loggers
/log <logger> - Toggle subscription

Debug Commands

/info - Block Information

/info block <pos> - Get detailed block info

/distance - Distance Measurement

/distance from [pos] to [pos] - Measure distance

/profile - Performance Profiling

/profile health [ticks] - Profile server health

/tick - Game Clock Control

/tick rate <tps> - Set tick rate
/tick warp <ticks> - Fast-forward ticks

Rules & Settings

Carpet PvP includes over 100 configurable rules organized by category:

Command System Rules

Rule Type Default Description
commandSpawn String ops Enables /spawn command for spawn tracking
commandTick String ops Enables /tick command to control game clocks
commandProfile String true Enables /profile command for performance monitoring
commandPlayer String ops Enables /player command to control fake players

Performance & Optimization

Rule Type Default Description
optimizedTNT Boolean false TNT causes less lag when exploding in same spot
lagFreeSpawning Boolean false Spawning requires much less CPU and Memory
fastRedstoneDust Boolean false Lag optimizations for redstone dust
maxEntityCollisions Integer 0 Customizable maximal entity collision limits

TNT & Explosions

Rule Type Default Description
explosionNoBlockDamage Boolean false Explosions won't destroy blocks
mergeTNT Boolean false Merges stationary primed TNT entities
tntRandomRange Double -1 Sets TNT random explosion range to fixed value

Block & Item Mechanics

Rule Type Default Description
hopperCounters Boolean false Hoppers pointing to wool count items passing through
stackableShulkerBoxes String false Empty shulker boxes can stack when thrown
movableBlockEntities Boolean false Pistons can push block entities like hoppers, chests

Creative Mode Features

Rule Type Default Description
creativeNoClip Boolean false Creative No Clip - phase through walls
creativeFlySpeed Double 1.0 Creative flying speed multiplier
antiCheatDisabled Boolean false Prevents rubberbanding when moving too fast

Key Features

Hopper Counters

Setup Instructions

  1. Enable rule: /carpet hopperCounters true
  2. Place colored wool block
  3. Point hopper into the wool block
  4. Items passing through are counted and destroyed

Features:

  • 16 separate counter channels (one per dye color)
  • Real-time rate monitoring
  • Persistent across server restarts
  • Survival-friendly with carpet interactions

Fake Players

Create and control fake players for testing and automation.

Capabilities

  • Spawn persistent fake players
  • Control movement and actions
  • Simulate player interactions
  • Test multiplayer mechanics

Available Actions

  • use, attack, jump, sneak, sprint
  • drop, dropStack, swapHands
  • hotbar, inventory management
  • look, turn, move directions

Spawn Tracking

Comprehensive mob spawning analysis and monitoring.

  • Real-time tracking: Monitor spawning attempts live
  • Spawnable spot analysis: Find optimal locations
  • Mob cap monitoring: Track current and maximum mob counts
  • Rate testing: Measure spawning rates over time
  • Statistical analysis: Detailed spawning statistics

Scarpet Scripting

Scarpet is Carpet's built-in scripting language for automation and custom features.

Basic Syntax

// Simple expressions
print('Hello World');

// Variables
x = 10;
y = 20;
result = x + y;

// Functions
square(n) -> n * n;
print(square(5));

World Interaction

// Get block at position
block = block(0, 64, 0);

// Set block
set(0, 64, 0, 'stone');

// Scan area for specific blocks
scan(pos1, pos2, block('air'));

Event Handling

// Player join event
__on_player_joins(player) -> (
    print(player + ' joined the server');
);

// Block placement
__on_player_places_block(player, block_pos) -> (
    print(player + ' placed block at ' + block_pos);
);

Examples

Setting Up Hopper Counters

// Enable the feature
/carpet hopperCounters true

// Monitor white wool counter
/counter white
/counter white realtime

Basic Spawn Farm Testing

// Start tracking in area
/spawn tracking start ~ ~-10 ~ ~ ~10 ~

// Run 5-minute test
/spawn test 6000 white

// View results
/spawn tracking
/counter white

Fake Player Automation

// Spawn and control fake player
/player TestBot spawn
/player TestBot attack
/player TestBot look north
/player TestBot move forward

// Clean up
/player TestBot kill

Performance Optimization

// Enable key optimizations
/carpet optimizedTNT true
/carpet lagFreeSpawning true
/carpet fastRedstoneDust true
/carpet maxEntityCollisions 20

// Monitor performance
/log tps
/profile health 200

Troubleshooting

Common Issues

Commands Not Working

  • Check rule status with /carpet <rule>
  • Verify permissions (ops level required for many commands)
  • Double-check command syntax and arguments

Hopper Counters Not Counting

  • Enable rule: /carpet hopperCounters true
  • Ensure hopper points directly into wool block
  • Verify items are actually flowing through hopper

Fake Players Not Spawning

  • Cannot spawn if real player with same name is online
  • Check /carpet commandPlayer permission setting
  • Some servers may limit fake player creation

Performance Tips

  • Disable unnecessary rules that impact performance
  • Limit complex Scarpet scripts and fake player actions
  • Monitor chunk loading with creative players
  • Use /profile command to identify bottlenecks

Getting Help

  • Use /carpet <rule> for detailed rule information
  • Enable logging with /carpet scriptsDebugging true
  • Test features in creative mode first
  • Check GitHub Issues for known problems

Carpet PvP - Enhanced Minecraft Server Mod
GitHub | Modrinth | Home | Improve this page