MAGICCARPET DOCUMENTATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Comprehensive setup, tuning, and technical guide for network administrators
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. INSTALLATION
────────────────────────────────────────────────────
-
Download the high-performance MagicCarpet.jar.
-
Upload it into the server /plugins/ directory.
-
Make sure you are using Paper/Spigot 1.21.4 or higher.
-
Restart the instance to automatically generate local YAML stacks.
-
Customize gui.yml to construct and scale visual style unlocks.
2. CONFIGURATION BREAKDOWN
────────────────────────────────────────────────────
Global Engine Metrics:
-
walk-speed: Sets linear horizontal movement thrust multiplier (Default: 0.35). Reverts naturally when leaving the carpet.
-
disabled-worlds: A dynamic world blacklist stack. Moving into forbidden airspace causes instant automatic dismount and purge.
-
allow-fall-damage-prevent: Activates physical buffers to protect entities from critical falling momentum upon dismount.
Security & Combat Tagging:
-
enable-combat-tag: Hooks into damage listeners to prevent flying exploit escapes during intensive direct combat scenarios.
-
combat-duration: Wait threshold cooldown in seconds before an entity can resume valid carpet usage post-attack.
Visual Dynamics:
-
enable-glow: Overrides rendering states to paint a visible outlines shell around the flying vector.
-
glow-color: Primary global HEX hexcode color injected into the render layer pipelines.
-
default-size: Default geometric footprint applied to constructed vehicles.
System GUI Structure (gui.yml):
-
items.<id>.material: The physical visual object constructed as the flight foundation.
-
items.<id>.permission: Restrict aesthetic item choices to explicit permission holders (Elite, VIP tiers).
-
items.<id>.particle: Configures dynamic particle emissions tied strictly to the selection of this carpet style.
️ 3. COMBAT-PREVENTION LOGIC
────────────────────────────────────────────────────
MagicCarpet implements hardened safety loops to stop aerial cheating:
-
Automatic Dismount — Any direct hit immediately dissolves underlying support infrastructure, sending players to the ground safe zone.
-
Dual Tag Propagation — Both Attacker AND Victim are flagged, removing flight privileges completely for the combat duration.
-
Command Disablement — The central toggler query explicitly rejects any /mc requests until the countdown resolves.
️ 4. COMMAND REFERENCE
────────────────────────────────────────────────────
| /mc |
Primary command to materialise or dissolve your active carpet entity. |
| /mc set |
Triggers opening the full-blown interactive visual style customizer GUI. |
| /mc <pseudo> |
Administrator override to activate or forcibly drop another player's magic carpet. |
| /mc offall |
Global emergency clean-up tool instantly removing all persistent vehicles on the network. |
| /mc reload |
Hot-recycles message stacks, sound registries, and visual customization configs. |
5. PERMISSIONS INFRASTRUCTURE
────────────────────────────────────────────────────
-
magiccarpet.use — Fundamental node to summon and manipulate personal flight entities (Default: Op).
-
magiccarpet.reload — Grants permission to utilize internal configuration refresh mechanisms.
-
magiccarpet.admin.others — Grants power to toggle flight on behalf of targeted server inhabitants.
-
magiccarpet.admin.offall — Access rights to issue nuclear reset broadcast / emergency cleanups.
-
magiccarpet.style.<custom> — Arbitrary strings defined directly within gui.yml to secure specific item designs.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Need live support debugging configurations? Connect on Discord!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
![[IMG]](//proxy.spigotmc.org/d0a30626b5d2fb81a070a9a88cf2e187738dea11/68747470733a2f2f696d6167652e6e6f656c736861636b2e636f6d2f66696368696572732f323032362f31392f322f313737383030323430342d756e6976657273616c2d62616e6e65722d6564697465642d66696e616c2d3137373830303232343738363131322e706e67)