FoilCarpet
For players and server administrators seeking to push the boundaries of standard Minecraft mechanics without the complexity of a Fabric loader, FoilCarpet offers a revolutionary solution. This innovative plugin brings the power of the legendary Carpet Mod to stock Folia servers, specifically tailored for version 1.21.11. By re-implementing core Carpet rules using events and Folia region threading, it allows server owners to customize gameplay dynamics like TNT behavior, rail power limits, and entity stacking without needing the Fabric environment.
Why Choose FoilCarpet for Your Server?
The primary advantage of FoilCarpet lies in its ability to run on a stock Folia server. Unlike the original Carpet Mod, which relies on Fabric mixins to alter game code, this plugin uses Bukkit events and the unique region threading architecture of Folia. This means you can enjoy features like tntDoNotUpdate or stackableShulkerBoxes without installing a separate mod loader. The plugin is designed to handle world regions efficiently, ensuring that performance remains stable even when complex rules are active.
If you are looking for a streamlined way to manage these rules, you might find that using a specialized launcher simplifies the process significantly. For instance, the foxygame.net launcher features a dedicated catalog where you can find FoilCarpet and install it with a single click, automatically handling dependencies and version compatibility for you.
Key Features and Rules
While FoilCarpet is an experimental hobby project and does not include every single rule from the original Carpet Mod, it covers a robust subset that significantly alters server mechanics. The following rules are currently supported:
- tntDoNotUpdate: Prevents TNT from updating physics if ignited by redstone in the same tick, allowing for precise timing in contraptions.
- mergeTNT: Merges nearby TNT explosions to prevent lag spikes and improve rendering performance.
- railPowerLimit: Scans loaded chunks to rewrite rail power flags, ensuring trains do not exceed the maximum power limit even on inclines.
- movableBlockEntities: Allows entities like parrots and shulkers to be moved by pistons, a feature often desired by builders.
- stackableShulkerBoxes: Permits players to stack shulker boxes inside other shulker boxes, expanding inventory capacity.
- pushLimit: Adjusts the maximum number of entities that can be pushed by pistons.
- creativeNoClip: Enables creative mode players to clip through blocks for easier editing.
How to Install FoilCarpet
Installing this plugin is a straightforward process, but it requires specific server software to function correctly. You must use Folia 1.21.11 because the plugin relies heavily on region threads that are not present in standard Paper builds. Attempting to run this on a non-Folia server will result in failure.
To get started, you will need to download the jar file. Once you have the file, simply drop it into your server's plugins folder and restart your server. The installation is complete, and you are ready to configure the rules. This simplicity is part of what makes FoilCarpet for Minecraft so appealing to server operators who want quick setup times.
Configuring Rules and Commands
Configuration is handled entirely through in-game commands rather than a static config.yml file. This dynamic approach allows for real-time adjustments without needing to restart the server every time you want to tweak a setting. The primary command is /carpet, which accepts various arguments:
/carpet <rule> <value>: Sets a specific rule to a desired value. You can run this from the console or as an admin in-game./carpet <rule>: Displays the current value of a specific rule./carpet profile: Runs the built-in profiler to help identify performance bottlenecks./carpet log tnt: Logs all TNT placement events for debugging or tracking purposes.
By default, rules reset to their defaults upon server restart unless you confirm the prompt asking if you want to change the rule permanently. This ensures that your server returns to a safe baseline after a reboot unless you explicitly choose to keep your custom settings. Permissions are strict; only the console or operators with admin rights can access the /carpet command.
Important Considerations and Warnings
It is crucial to understand that this is an experimental project. The developers have only tested it on Folia 1.21.11, and while it works well in that environment, you should expect bugs on any other version. Because the plugin interacts deeply with world region threading and chunk loading, there is a risk of data corruption if something goes wrong. Always backup your world before installing or making significant changes to your server configuration.
If you encounter a bug, the best course of action is to report it via the GitHub repository. Please include the specific rule you were using, the commands you ran, and your server logs to help the developers diagnose the issue. Remember that this project is a fork of gnembon's work, and while it shares the MIT license, the original creator is not responsible for bugs in this specific implementation.
For those who enjoy the mod, donations are accepted via Ko-fi to support the continued development. Whether you are building massive redstone contraptions or managing a complex survival server, FoilCarpet provides the tools needed to customize your Minecraft experience on a high-performance Folia backend. Download FoilCarpet today to unlock these unique capabilities on your server.