Carpet PRY Addition

Carpet PRY Addition is a server-side Fabric extension for the fabric-carpet mod, developed for the Primaryuan Server. It adds 35 configurable Carpet rules and 9 new commands (plus /player extensions) covering bug fixes, fake player enhancements, player interaction, and survival gameplay expansion.

---

Bug Fixes

Xaero Minimap + LuckPerms Compatibility Fix (fixXaeroLib)

Resolves an issue where fake player (carpet bot) data is lost or inventory is forced empty when Xaero's Minimap / World Map and LuckPerms are used together on the server.

Related upstream issues:

• Xaero's World Map #1191 — When using with LuckPerms and carpet, carpet bot's player data initialize failed
• LuckPerms #4232 — When using with Xaero's Minimap and Xaero's World map, carpet bot's inventory empty
• fabric-carpet #2158 — Bot's inventory force empty with LuckPerms xaerolib (include in Xaero's Minimap and Xaero's Worldmap)

BlueMap Compatibility Fix (fixBlueMap)

Fixes an issue where fake players do not trigger Fabric API connection events, causing mods like BlueMap to fail tracking fake player join/leave correctly.

Related upstream issues:

• fabric-carpet #1962 — Compatibility issue with Bluemap
• BlueMap #598 — Unable to properly handle fake players who go offline

End Crystal Position Sync (fixEndCrystalSync)

Fixes client-side position desync when end crystals are pushed by pistons, including invulnerable crystals.

Standing On Air Misjudgment Fix (fixStandingOnAir)

Moves support-block resends after player movement, matching the official 26.4 Snapshot 1 fix, and additionally suppresses the standing-on-air INFO log. Resends and the 200-tick cooldown remain active. Only affects 26.3.

Related upstream issues:

• MC-311474 — standing on air log false positives
• MC-311727 — root cause (check runs before movement), fixed in 26.4 Snapshot 1

---

Fake Player Enhancements

Fake Player Skin (fakePlayerSkinMode / fakePlayerSkinSet)

Customize the appearance of carpet fake players by integrating with the optional skinrestorer mod. Install skinrestorer on the server to enable these features.

• summon mode — the fake player uses the skin of the player who summoned it.
• same_skin mode — all fake players share a unified skin, specified by fakePlayerSkinSet (default: Brokeyuan).
• Skins apply to the fake player's session only — nothing is persisted to skinrestorer's storage, so real players sharing the same name (same UUID on offline-mode servers) never get reskinned.
• Skins are applied before spawn when available. A pending lookup may briefly show the default skin; real players are unaffected.
• With Carpet TIS Addition installed, /player <name> rejoin gets the same skin treatment — rejoin reuses Carpet's spawn logic, where the skin hook applies.

Fake Player Name Suggestions (fakePlayerNameSuggestions)

Customize the name suggestion list shown when using the /player command to spawn fake players. Define a comma-separated list of names for quick selection.

Fake Player Pearl Teleport System (fakePlayerTpp)

A teleport network using fake players and ender pearls. Admins set up stations at key locations, and players teleport between them by having a temporary fake player right-click a pearl at the destination.

Commands:

• /tpp <station> — teleport to a station.
• /tppset — manage stations, player aliases, and per-station pearl use counts. Data is persisted in config/carpet-pry-tpp.json.

/tpp requires Carpet TIS Addition — its /player rejoin respawns the station's fake player at its logged-off position and orientation. This is a soft dependency: without it, /tpp immediately reports the missing requirement, while /tppset and everything else work normally.

Fake Player Continuous Drop (fakePlayerDropAll)

Use /player <name> dropall (or dropall once) to empty the inventory immediately. Timed modes drop one stack per trigger: every tick, at a fixed or random interval, after a delay, or N times per second. dropall stop cancels the task.

Fake Player Inventory Link (fakePlayerSendto)

Adds a /player <name> sendto <target> sub-command creating a one-way item flow between fake players: one stack is transferred per trigger, round-robin across multiple targets, and the source buffers items when a target is full. The same pace modifiers as dropall are supported; sendto stop removes all links. Links live in memory only and do not survive restarts.

Fake Player Brain (fakePlayerBrain)

Give fake players one of 19 mob behavior modes with /player <name> brain <mode>. They keep their player body and inventory; no extra entities or items are created. Supports CJK mode names, colored name suffixes and keep for rejoins during the current server run.

---

Gameplay Expansion

Player Hat (playerHat)

Wear any main-hand item on your head with the /hat command. When a Totem of Undying is placed in the helmet slot, taking fatal damage triggers a survival effect: Regeneration II + Absorption II + Fire Resistance I.

Player Head Skin (playerHeadSkin)

Real and Carpet fake players wear a player head to use its full skin; swapping heads updates it, and removing it or disabling the rule restores the previous skin. The head stays visible. Server-side, with no skin mod or playerHat required.

Riding Players (ridingPlayers)

Hold a Totem of Undying in your main hand and right-click another player's head to ride on top of them. Players can control whether others may ride them via /riding on|off. Up to ridingPlayersStackLimit (default 16) players can stack in one tower.

Additional related rules:

• ridingPlayersAutoDismount — passengers dismount when a player's game mode changes.
• ridingPlayersClientInteract — a client-side rule (on by default) that allows interacting with blocks and entities even when carrying passengers. Requires the mod to be installed on the client.

Picking Up Players (pickupPlayers)

Hold a Totem of Undying in your main hand and right-click another player's legs to pick them up (they ride on your head). Torso clicks do nothing, and fake players don't participate. Players control whether others may pick them up via /picking on|off. Shares the same stack limit as riding (ridingPlayersStackLimit).

Pat Players (patPatPlayers)

Pat other real players on the head, cat-petting style: each right-click is a stroking pulse — the target bobs down and up with the rhythm with hearts above their head, while the patted player gets a heart in front of their eyes, a soft directional sound and a per-player opt-out (/patnod, persisted in config/carpet-pry-patnod.json). Fake players are excluded; works with any item in hand and never consumes the interaction.

Peaceful Players (peacefulPlayers)

Enables the /pvp command: each player can turn their own PVP on or off. Players with PVP off cannot attack players and take no damage from players (self-inflicted damage unaffected); blocked attacks play a cue sound so the "poke" signal is preserved. Admins can toggle PVP for anyone or server-wide with /pvp on|off @a, and /pvp list shows everyone who currently has PVP off. States persist across restarts in config/carpet-pry-pvp.json.

Who Called Me (whoCalledMe)

Naming a player in chat triggers three sounds and a title; self-mentions also work and fake players are excluded. Matching is case-insensitive, with longer names taking precedence; mention mode requires @name. whoCalledMeSound chooses the sound, and whoCalledMeHighlight chooses one of 16 colors, rainbow or false (default aqua).

MiSide Subtitles (textAnimation)

Use /text @a|player <message> to play MiSide-style subtitles on vanilla clients. Text types in, holds, then drops and fades; trailing exclamation marks enlarge it. Defaults to white, supports & color codes and inline options. The first 12 eligible recipients get entity subtitles; the rest get an actionbar typewriter. Fake players are excluded.

Click Through (clickThrough)

Right-click wall signs, wall hanging signs, wall banners, item frames or paintings to open the container directly behind them. Sneaking keeps normal interaction, and blocked containers remain blocked. Works on vanilla clients; installing ClickThrough Server disables this handler.

---

Player Scaling

Player Scale (playerScale + playerScaleMin / playerScaleMax)

Registers the vanilla minecraft:scale attribute for players and enables the /scale set|reset|info command: players adjust their own size, and admins (or everyone, depending on the mode) can adjust others. Values only need to be greater than 0, bounded by playerScaleMin (default 0.1) and playerScaleMax (default 1.5). Includes automatic FOV compensation on clients with the mod installed.

Realistic Player Scale (playerScalePhysics)

Optional physics linkage in three modes (gentle √scale curve, gentle + small-size floors, or strictly proportional): movement speed, jump height, step height, interaction range, fall safety and gravity all scale with size. Transient modifiers only — nothing is written to the save.

Player Scale Linked Entities (playerScaleLinkedEntities)

Living entities spawned directly by a player using an item (armor stands, spawn-egg mobs, built golems, ...) inherit the player's size snapshot at spawn time.

---

Other Features

• More End Crystal Types (moreEndCrystalTypes) — place end crystals on crying obsidian; invulnerable places an invulnerable crystal. Their beams point to (0, 128, 0).
• Daydreaming (sleepingDuringTheDay) — sleep in a bed during daytime to skip forward to night (inspired by PCA).
• Better Snowball (betterSnowball) — snowballs deal knockback and damage to players ("stones hidden in snow").
• Invisibility Grass (invisibleInTallGrass) — standing with your head inside tall grass grants automatic invisibility.
• Unicode Command Arguments (unicodeArgumentsSupport) — allows non-ASCII characters (Chinese, Japanese, Korean, etc.) in command arguments, enabling fake players with CJK names (ported from YACA).

---

Before You Download

• Required dependencies: fabric-carpet and Fabric API must be installed on the server.
• Fabric Loader >= 0.16.0 is required.
• Optional: skinrestorer is needed for the fake player skin features (fakePlayerSkinMode / fakePlayerSkinSet).
• This is a server-side mod. Place it in the server's mods folder. Client installation is only needed for the player-scaling FOV compensation and the ridingPlayersClientInteract rule.
• All rules are off by default (except ridingPlayersClientInteract) — use /carpet or the Carpet configuration files to enable the ones you want.
• Source code: GitHub
• Documentation: Wiki | GitHub README

---

Credits

• BlueMap fix — referenced from fabric-carpet PR #2142
• XaeroLib fix — thanks to Wzp-2008 for the patch in LuckPerms #4232
• Fake Player Name Suggestions — referenced from Ivan-Carpet-Addition
• Daydreaming — referenced from plusls-carpet-addition (PCA)
• Unicode arguments — ported from YetAnotherCarpetAddition (YACA)
• Thanks to Liuyue_awa and Carpet-Igny-Addition
• Built on fabric-carpet