================================================================================
     __  __ _                            _     ____  _
    |  \/  (_)_ __   ___  ___ __ _ _ __| |_  |  _ \| |_   _ ___
    | |\/| | | '_ \ / _ \/ __/ _` | '__| __| | |_) | | | | / __|
    | |  | | | | | |  __/ (_| (_| | |  | |_  |  __/| | |_| \__ \
    |_|  |_|_|_| |_|\___|\___\__,_|_|   \__| |_|   |_|\__,_|___/

              _____ _                         ____                  _
             |  ___| | __ _ _ __ ___   ___   | __ )  ___   ___  ___| |_
             | |_  | |/ _` | '_ ` _ \ / _ \  |  _ \ / _ \ / _ \/ __| __|
             |  _| | | (_| | | | | | |  __/  | |_) | (_) | (_) \__ \ |_
             |_|   |_|\__,_|_| |_| |_|\___|  |____/ \___/ \___/|___/\__|

================================================================================

                    ~~ SUPER FAST MINECARTS WITH FLAMES! ~~

================================================================================


HEY THERE, MINECART RACER!
--------------------------

Ever wished your minecart could go SUPER FAST like a rocket?
Well now it can! This datapack makes your minecarts zoom across the rails
with awesome flame trails shooting out the back!

    ___________
   |           |
   |  ( o  o ) |  <-- You in your speedy minecart!
   |     __    |
   |_____||____|
      O      O   ~~**FLAMES**~~


================================================================================
                         WHAT DOES THIS DO?
================================================================================

    [SPEED BOOST]
    When you ride over a POWERED RAIL (the gold ones with redstone),
    your minecart gets a speed boost! You'll zoom forward super fast!

    [FLAME TRAILS]
    While you're boosting, cool flame particles shoot out the back
    of your minecart - just like a rocket ship!

    [SMART SLOWING]
    Don't worry about crashing! The minecart automatically slows down
    when you go around corners or up/down hills so you don't fly off!

    [CHOOSE YOUR SPEED]
    Pick how fast you want to go - from a little boost to SUPER SONIC!


================================================================================
                         HOW TO USE - IT'S EASY!
================================================================================


STEP 1: GET IN A MINECART
-------------------------

    Just place a minecart on some rails and hop in!
    (Right-click the minecart to get in)


STEP 2: HIT A POWERED RAIL
--------------------------

    When your minecart touches a powered rail (make sure it has redstone
    power!), you'll get a speed boost with flames!

         ____
        |CART|
        |____|~~~~** WHOOOOSH! **
          OO
    =======P=======   <-- P = Powered Rail (gold colored)


STEP 3: ENJOY THE RIDE!
-----------------------

    Zoom around your rail systems super fast! The boost lasts for a
    short time, then you go back to normal speed until you hit another
    powered rail!


================================================================================
                         CHANGING YOUR SPEED
================================================================================

Want to go faster? Or maybe slower? You can change speeds using commands!

Just open chat (press T) and type one of these:


    +--------------------------------------------------+
    |                                                  |
    |   /trigger mcfix_speed_normal                    |
    |   ^ Turn OFF the speed boost (regular minecraft) |
    |                                                  |
    +--------------------------------------------------+

    +--------------------------------------------------+
    |                                                  |
    |   /trigger mcfix_speed_fast                      |
    |   ^ A little faster! (2 flames) - 20 tick boost  |
    |                                                  |
    +--------------------------------------------------+

    +--------------------------------------------------+
    |                                                  |
    |   /trigger mcfix_speed_faster                    |
    |   ^ Pretty fast!! (4 flames) - 15 tick boost     |
    |                                                  |
    +--------------------------------------------------+

    +--------------------------------------------------+
    |                                                  |
    |   /trigger mcfix_speed_fastest                   |
    |   ^ SUPER FAST!!! (6 flames) - 10 tick boost    |
    |                                                  |
    +--------------------------------------------------+


    SPEED COMPARISON:

    Normal:   o------>
    Fast:     o------------>
    Faster:   o-------------------->
    Fastest:  o------------------------------>


================================================================================
                         HIDE CHAT MESSAGES
================================================================================

Tired of seeing "[Minecart Fix] Loaded!" messages?
You can turn them off!

    Type in chat:

        /trigger mcfix_hide_msg

    To turn messages back on, type:

        /trigger mcfix_hide_msg set 2


================================================================================
                         TIPS AND TRICKS!
================================================================================


    TIP #1: MAKE A BOOST STATION!
    -----------------------------
    Put a few powered rails in a row to keep your boost topped up!

        ===P===P===P===   (P = Powered Rails)


    TIP #2: CORNERS AND HILLS
    -------------------------
    The minecart automatically slows down for corners and hills,
    so don't worry - you won't crash! It's smart!


    TIP #3: WORKS WITH ALL MINECARTS!
    ---------------------------------
    This works with:
      - Regular minecarts (for riding!)
      - Chest minecarts (for moving items!)
      - Hopper minecarts (for collecting items!)
      - Furnace minecarts
      - TNT minecarts (watch out!)


    TIP #4: FASTEST ISN'T ALWAYS BEST
    ---------------------------------
    Super fast is fun, but the boost doesn't last as long!
    Sometimes "Fast" or "Faster" is better for long trips!

        Fast:     Slower speed BUT longer boost (20 ticks)
        Fastest:  Super speed BUT shorter boost (10 ticks)


================================================================================
                         TROUBLESHOOTING
================================================================================


    PROBLEM: "My minecart isn't going fast!"
    ----------------------------------------
    SOLUTION: Make sure you're hitting POWERED rails (the gold ones),
              and make sure they have redstone power (lever, torch, etc.)!


    PROBLEM: "I don't see any flames!"
    ----------------------------------
    SOLUTION: You might have particles turned off in your settings!
              Go to Options > Video Settings > Particles > All


    PROBLEM: "The commands don't work!"
    -----------------------------------
    SOLUTION: Make sure you type them exactly right, starting with /trigger
              If it says "unknown command", the datapack might not be loaded.
              Try typing: /reload


    PROBLEM: "It's too fast and I keep crashing!"
    ---------------------------------------------
    SOLUTION: Try a slower speed! Type: /trigger mcfix_speed_fast
              Or turn it off with: /trigger mcfix_speed_normal


================================================================================
                         FOR SERVER ADMINS
================================================================================

This datapack is very lightweight and won't cause lag!

    - Only runs checks on minecarts
    - Particles are rendered client-side
    - Automatically slows on corners (no flying off rails)
    - Players can control their own speed settings


CHANGING THE DEFAULT SPEED
--------------------------

Default speed is set to FASTEST (3). To change the default, edit:
    data/minecart_fix/function/load.mcfunction

Change the line:
    scoreboard players set #speed mcfix 3

To 0 (off), 1 (fast), 2 (faster), or 3 (fastest)


ADMIN-ONLY MODE (Restrict Speed Changes to OPs)
-----------------------------------------------

Want to prevent regular players from changing the speed?
You can lock it so only server operators can change it!

    METHOD 1: In-game command (temporary, resets on reload)
    -------------------------------------------------------
    Run this command as an OP:

        /scoreboard players set #admin_only mcfix 1

    To allow players again:

        /scoreboard players set #admin_only mcfix 0


    METHOD 2: Edit the file (permanent)
    -----------------------------------
    Edit: data/minecart_fix/function/load.mcfunction

    Find this line:
        scoreboard players add #admin_only mcfix 0

    Change the 0 to 1:
        scoreboard players set #admin_only mcfix 1
                              ^^^
                        (also change 'add' to 'set' to force it)

    When admin_only is ON:
      - Players CANNOT use /trigger to change speed
      - Only OPs can change speed using scoreboard commands
      - The message hide trigger still works for everyone

    OPs can still change speed with:
        /scoreboard players set #speed mcfix 1   (fast)
        /scoreboard players set #speed mcfix 2   (faster)
        /scoreboard players set #speed mcfix 3   (fastest)
        /scoreboard players set #speed mcfix 0   (normal/off)


================================================================================
                              CREDITS
================================================================================


                    Made with love for Minecraft!

          +-----------------------------------------+
          |                                         |
          |     Thanks for using Minecart Plus!     |
          |                                         |
          |        Now go zoom around! :D           |
          |                                         |
          +-----------------------------------------+


                          *   *   *
                       *    *   *    *
                         *   *   *
                       __|___|___|__
                      |  MINECART   |
                      |   PLUS!     |
                      |_____________|
                          O    O
                    ~~~~~~~~~~~~~~~~~~~~~~


================================================================================
                            HAVE FUN!
================================================================================
