Carpet-Primaryuan-Addition

Carpet PRY Addition is a server-side Fabric extension for the fabric-carpet mod, developed for the Primaryuan Server. It adds 15 configurable Carpet rules and several new commands covering bug fixes, fake player enhancements, and survival gameplay expansion.

Fix

Xaero Minimap + LuckPerms Compatibility Fix (xaerolibFix)

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)

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).

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 (TppFakePlayer)

A fully custom teleport network powered by 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.

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, giving you a second chance.

Riding Players (ridingPlayers)

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

Additional related rules:

• ridingPlayersDismountOnGameModeChange — passengers dismount when a player's game mode changes.
• ridingPlayersClientAllowInteractions — a client-side rule 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 a Golden Carrot in your off-hand, then right-click another player to pick them up (they ride on your head). Players control whether others may pick them up via /pickup on|off. Shares the same stack limit as riding (ridingPlayersPickUpLimit).

Other Features

• 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).

Why Download

• All features are toggleable — every mechanic is a Carpet rule, disabled by default. You only enable what you need.
• Wide version coverage — supports Minecraft 1.21 through the latest snapshots (26.2), with 10 versions actively maintained.
• Server-side only — players do not need to install the mod on their clients (except for the optional ridingPlayersClientAllowInteractions client rule).
• Lightweight and focused — built on the Carpet framework, integrates naturally with existing Carpet setups.

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 ridingPlayersClientAllowInteractions rule.
• All rules are off by default — use /carpet or the Carpet configuration files to enable the ones you want.
• Source code: GitHub
• Documentation: Wiki | GitHub README