26.3 GameRules and Configuration

Dynamic GameRules & Configuration — MC 26.3

This page provides the exhaustive configuration reference, GameRule commands, permissions, and client GUI integration for Max Elytra Fly Speed (MC 26.3).

---

📋 Subsystem Infobox

Parameter	Technical Details
Configuration Engine	Namespaced Dynamic GameRules via DynamicGameRuleManager (DasikLibrary)
GameRule Category	max-elytra-fly-speed:max-elytra-fly-speed
Storage Mechanism	World Save Data (level.dat / vanilla GameRules system)
Dedicated Server Dependency	Zero external config libraries required on servers
Optional Client GUI	ModMenu (>=0.19.3) + Cloth Config (me.shedaniel.clothconfig2)
Permission Requirement	Operator Level 2 (requires(source -> source.hasPermission(2)))

---

🎮 Administrator Workflow & Commands

All settings are configured natively in-game or via server console using standard vanilla /gamerule commands. Changes take effect instantly without restarting the server or reconnecting players.

1. View Current GameRule Values

/gamerule max-elytra-fly-speed:max_elytra_fly_speed
/gamerule max-elytra-fly-speed:elytra_initial_boost_speed
/gamerule max-elytra-fly-speed:elytra_high_speed_acceleration

2. Set Custom Flight Speed Limits

# Set maximum Elytra flight speed ceiling to 150 Blocks/Second
/gamerule max-elytra-fly-speed:max_elytra_fly_speed 150

# Set initial snappy rocket boost speed to 40 Blocks/Second
/gamerule max-elytra-fly-speed:elytra_initial_boost_speed 40

# Set high-speed rocket acceleration rate to 25% per tick
/gamerule max-elytra-fly-speed:elytra_high_speed_acceleration 25

---

📑 Exhaustive GameRules Reference Table

GameRule Identifier	Data Type	Default Value	Valid Range	Localized Name	Functional Description
max-elytra-fly-speed:max_elytra_fly_speed	Integer	50	1 to 2147483647	Max Speed (Blocks/Sec)	Hard ceiling for Elytra fall-flying velocity in Blocks/Second. Relaxed aerodynamic drag scaling applies above 50 BPS.
max-elytra-fly-speed:elytra_initial_boost_speed	Integer	30	1 to 2147483647	Initial Boost Speed	Velocity threshold (Blocks/Second) up to which snappy vanilla rocket boost ($50%$ convergence) is applied.
max-elytra-fly-speed:elytra_high_speed_acceleration	Integer	15	1 to 1000	High Speed Acceleration	High-speed rocket acceleration percentage ($15 \implies 15%\text{ per tick}$) applied above the initial boost speed.

---

📊 Visual Configuration Architecture

                    [ DEDICATED SERVER / WORLD HOST ]
                                    |
            +-----------------------+-----------------------+
            |                                               |
   [ Vanilla /gamerule CLI ]                     [ DynamicGameRuleManager ]
            |                                               |
            v                                               v
  [ level.dat GameRules ] <===============> [ World Save & Fast Access Cache ]
                                                            |
                                    +-----------------------+-----------------------+
                                    |                                               |
                                    v                                               v
                        [ LivingEntityMixin ]                          [ FireworkRocketEntityMixin ]
                        • Dynamic Drag Scaling                         • Two-Tier Propulsion Boost
                        • Velocity Clamping                            • Vector Convergence

---

🖥️ Optional Client GUI Integration

When playing in Singleplayer or LAN worlds with client configuration mods installed:

• ModMenu Integration: Max Elytra Fly Speed implements ModMenuApi in net.instantgratification.maxelytraflyspeed.config.ModMenuIntegration.
• Cloth Config Builder: If cloth-config is present in the mods folder, clicking Configure in ModMenu opens the configuration screen constructed by ClothConfigScreenHelper.java.
• Headless Server Safety: If Cloth Config is absent, the mod cleanly falls back without classloading errors or crashes on dedicated servers.

---

🌐 Complete Localization Keys (en_us.json)

{
  "gamerule.category.max-elytra-fly-speed.max-elytra-fly-speed": "Max Elytra Fly Speed",
  "gamerule.max-elytra-fly-speed.max_elytra_fly_speed": "Max Speed (Blocks/Sec)",
  "gamerule.max-elytra-fly-speed.max_elytra_fly_speed.description": "Maximum velocity of Elytra flight in Blocks/Second. Default: 50 blocks/sec.",
  "gamerule.max-elytra-fly-speed.elytra_initial_boost_speed": "Initial Boost Speed",
  "gamerule.max-elytra-fly-speed.elytra_initial_boost_speed.description": "Speed threshold (Blocks/Second) up to which snappy vanilla rocket boost is applied. Default is 30.",
  "gamerule.max-elytra-fly-speed.elytra_high_speed_acceleration": "High Speed Acceleration",
  "gamerule.max-elytra-fly-speed.elytra_high_speed_acceleration.description": "High-speed acceleration rate percentage above initial boost speed. Default is 15 (15% per tick)."
}

---

💻 Developer & Addon Extension Hooks

To query GameRule values programmatically from addons or custom server plugins:

import net.dasik.social.api.gamerule.DynamicGameRuleManager;
import net.instantgratification.maxelytraflyspeed.MaxElytraFlySpeedFabric;
import net.minecraft.world.level.Level;

public class FlightDiagnostics {
    public static void logConfiguredCeiling(Level level) {
        int maxSpeedBps = DynamicGameRuleManager.getInt(level, MaxElytraFlySpeedFabric.MAX_ELYTRA_FLY_SPEED);
        double maxSpeedTicks = maxSpeedBps / 20.0;
        System.out.println("Current flight ceiling: " + maxSpeedBps + " BPS (" + maxSpeedTicks + " blocks/tick)");
    }
}

---

🧭 Navigation

• 📖 MC 26.3 Overview
• 🌀 Kinetic Physics & Drag
• 🚀 Rocket Propulsion & Acceleration
• 🧩 Architecture & Mixins
• 🏠 Wiki Home