Carpet-FGA-Addition

Carpet FGA Addition

Carpet FGA Addition is a server‑side Fabric Carpet extension providing fake‑player utilities, drop‑item tweaks, villager optimizations, command compatibility, health display and performance‑assisting features. Except where noted, all features are disabled by default and can be toggled via /carpet rules.

Supported Versions

Current release: 1.4.7. Supports Minecraft 1.16.5, 1.17.1, 1.18.2, 1.19.2, 1.19.4, 1.20.1, 1.20.4, 1.20.6, 1.21, 1.21.1, 1.21.3, 1.21.4, 1.21.5, 1.21.8, 1.21.10, 1.21.11, 26.1.2 and 26.2.

Documentation

Void new‑chunk generation is available for all supported versions. For 1.21.1 only, queued restart‑capable vanilla‑terrain regeneration and full‑air‑chunk purging are additionally provided.

• 中文规则文档
• English rules
• 中文命令文档
• English commands

Feature Overview

• Fake‑player region operations, name compatibility, Unicode argument support and end gateway regeneration.
• Villager trade/gift optimizations, wandering trader protection and hostile‑mob equipment‑bar access.
• For Minecraft 1.21.1: juvenile mob growth locking. Lock all young entities or only named young entities with exact custom‑name matching, including tadpoles. Server‑side only.
• Ground item stack‑limit adjustment, pre‑stacking for dropped items, drop‑distance tweaks and /fill compatibility fixes.
• Recipe‑book unlocking, hidden inventory‑advancement optimizations, tab‑list health display and client‑side dimension‑ID remapping.
• For Minecraft 1.21.1: item‑frame block‑mode. Moves item frames out of server‑entity tick scheduling; survival validation is driven by block updates to reduce server overhead with large quantities of item frames.
• For Minecraft 1.21.1: firework minecarts and chained minecart trains. Riders may use fireworks for configurable high‑speed travel; chains can link ordinary minecarts into persistent linear trains.
• Supported for all versions: vehicle dismount emergency stop. Per‑minecart, per‑boat or per‑player configurable horizontal‑velocity clearing when the driver dismounts.
• For Minecraft 1.17.1‑1.21.11: deepslate stone‑cutting completion. Lets deepslate be directly cut into all deepslate variants added in 26.1+.
• For Minecraft 1.16.5‑26.2: full shulker‑box crafting. Fully filled single‑item shulker boxes can be directly converted into finished full boxes using normal crafting recipes; empty‑box consumption/production is handled automatically.
• Exclusive to Minecraft 1.21.1: fake‑player full‑item sorting, offline quickopen, online summon, shulker‑box processing, inventory reconstruction and web‑cache API.
• For Minecraft 1.17.1‑1.21.11: toggle rule deepslateStonecuttingRecipes for deepslate direct stone‑cutting.
• For Minecraft 1.21.1: player load‑distance rule with /playerLoadDistance. Supports temporary / persistent modes, values -1, 0, 1‑32 and none.

Important Notes

Fake‑player full‑item sorting is registered only on Minecraft 1.21.1. quickopen reads and writes offline playerdata for target fake‑players directly; it does not spawn fake‑players to access inventories. summon uses online Carpet fake‑players. The sorcerer never reads or modifies equipment slots.

World configuration is stored under world/config/carpetfgaaddition/. When upgrading from older builds, existing files in world/carpet/carpetfgaaddition/ will be migrated after validation and backed up with a .migrated suffix. Corrupted files will not be overwritten or deleted.

Main Commands

Full syntax, permission levels, version constraints, pagination and click‑assisted help are documented in the command documentation. Frequently‑used entry points:

/dropPreStack help
/villagerPerformance help
/fakePlayerItemSort status
/fakePlayerItemSort help
/fakePlayerItemSort mode summon|quickopen
/minecart help
/vehicleStop help
/player <fakeplayer> bot_sort
/log playerHealth
/fga help

License & Acknowledgements

The project is released under the MIT License. Adapted components originating from LGPL‑licensed projects remain subject to their respective LGPL terms. Parts of the design draw inspiration from MIT‑licensed projects: Org Addition, SaveMyRecipeBook, InventoryAdvancementAccelerator and StackSizeTweaks. Attribution notices are distributed within the JAR under META‑INF/NOTICE‑*.