===========================================================
   MECH BAY
   Everything you need to join

   Server address:  mechbay.modded.fun
   Minecraft Java Edition 1.20.1  /  Fabric
===========================================================

WHAT IS ON THIS SERVER

   Pomkots Mechs             pilotable mechs
   Create                    gears, shafts, contraptions
   Create Crafts & Additions electricity <-> rotation
   Powah                     solar panels, cells, cables
   Leawind Third Person      the camera that makes mechs
                             actually playable

You install ONE thing. Everything above downloads itself the
first time you connect. You never hunt down a mod file and
you never match a version by hand.

About 15 minutes, once, and then never again.


===========================================================
   BEFORE YOU START  -  two things that will stop you dead
===========================================================

1.  YOU NEED MINECRAFT JAVA EDITION.
    It is the paid PC version from minecraft.net.

    Bedrock Edition will NOT work - that is the version on
    consoles, phones, and the Microsoft Store. If you press
    play and it asks about Realms or shows a Marketplace,
    you are on Bedrock. There is no setting that changes
    this. They are different games.

2.  YOU MUST BE ON THE WHITELIST.
    Send Dan your EXACT Minecraft Java username - the one
    that shows in the top corner of the launcher. Spelling
    and capitals matter.

    If you are not on the list, the server will refuse you
    with "You are not white-listed on this server" no matter
    how perfectly you do everything else below.

Get both of those sorted first. Then continue.


===========================================================
   MAIN ROUTE  -  the launcher you already have
===========================================================

Use this unless you already play other Fabric 1.20.1 mods.
If you do, skip to the ALTERNATIVE further down.

-----------------------------------------------------------
STEP 1.  Install Fabric
-----------------------------------------------------------
    Go to:   fabricmc.net/use/installer

    Download the installer, run it, and set:

        Minecraft Version:  1.20.1
        Loader Version:     leave it alone

    Click INSTALL.

    This adds a new profile to your normal launcher. It does
    not touch your existing game, your worlds, or anything
    you already play.

-----------------------------------------------------------
STEP 2.  Download two files
-----------------------------------------------------------
    modrinth.com/mod/automodpack
        Versions tab -> filter to 1.20.1 and Fabric
        Download 4.0.6
        File:  automodpack-mc1.20.1-fabric-4.0.6.jar

    modrinth.com/mod/fabric-api
        Versions tab -> filter to 1.20.1 and Fabric
        Download 0.92.12
        File:  fabric-api-0.92.12+1.20.1.jar

    That is all you download by hand. Everything else is
    handled for you in Step 5.

-----------------------------------------------------------
STEP 3.  Put them in your mods folder
-----------------------------------------------------------
    WINDOWS   Press Win+R, paste this, press Enter:
                  %appdata%\.minecraft

    MAC       Finder -> Go menu -> Go to Folder, paste:
                  ~/Library/Application Support/minecraft

    Look for a folder called  mods  inside. If there isn't
    one, make it - lowercase, spelled exactly "mods".

    Drop both .jar files in there.

-----------------------------------------------------------
STEP 4.  Give it memory        <-- DO NOT SKIP THIS
-----------------------------------------------------------
    Minecraft Launcher
      -> Installations tab
      -> find  fabric-loader-1.20.1
      -> the "..." menu on the right -> Edit
      -> More Options
      -> JVM Arguments

    Find  -Xmx2G  near the start of that line.
    Change it to  -Xmx8G
    Save.

    (If your computer has 8GB of RAM total, use -Xmx6G
     instead. Never set it higher than half your RAM.)

    The mech models alone are a 50MB download, and Create
    and Powah stack on top of them. Skip this step and the
    game will stutter and freeze, and you will be certain
    the server is broken when it isn't.

-----------------------------------------------------------
STEP 5.  Launch and connect
-----------------------------------------------------------
    In the launcher, use the dropdown next to the big PLAY
    button and pick  fabric-loader-1.20.1 . Press PLAY.

    At the title screen:

        Multiplayer -> Add Server

        Server Name:     Mech Bay
        Server Address:  mechbay.modded.fun

        Done -> then double-click Mech Bay to join.

    Now jump to "THE FIRST CONNECT" below. There are two
    prompts and they surprise people.


===========================================================
   ALTERNATIVE  -  Prism Launcher
===========================================================

Use this if you ALREADY play other Fabric 1.20.1 mods. The
main route shares one mods folder across everything on that
version, so your existing mods would all load alongside
these and may fight each other. Prism keeps this server
sealed in its own box.

    1.  Install Prism Launcher from  prismlauncher.org
        (The Modrinth App also works. The CurseForge app
         does NOT - it cannot open .mrpack files.)

    2.  Add Instance -> Import -> choose the file
            Mech-Bay-Connect-1.1.0.mrpack
        that came in this kit.

    3.  Right-click the new instance -> Edit -> Settings
        -> Memory -> set maximum to 8192 MB.

    4.  Launch it, sign in, then:
            Multiplayer -> Add Server
            Address:  mechbay.modded.fun

    Then read "THE FIRST CONNECT" below.


===========================================================
   THE FIRST CONNECT  -  what is supposed to happen
===========================================================

The first time you connect, you get two prompts. Both are
normal. Neither means something went wrong.

PROMPT 1 - "Certificate Verification"

    A screen appears asking you to verify the server's
    certificate or fingerprint. Accept it.

    This is the sync mod confirming it is talking to the
    real Mech Bay and not something pretending to be it.
    You only ever see this once.

PROMPT 2 - the modpack download

    It offers to download the server's modpack. Say yes.

    It pulls roughly 200MB. On a normal connection that is
    a couple of minutes. The progress bar can appear to sit
    still on the mech models - they are one very large file.
    Let it finish.

    When it is done it will ask to restart the game. Let it.

After the restart, join the server again. This time you go
straight in. You will never see either prompt again.


===========================================================
   YOU ARE IN.  NOW WHAT?
===========================================================

    F5              switch camera angles. In a mech you
                    want third person - that is what the
                    Leawind mod is for.

    Find Royal      he has been building here a while and
                    knows where things are.

    Press E, look   Create's items are all in the Create
    for the Create  creative tab. Start with Andesite
    stuff          Alloy - everything else is built from it.

    Solar power     Powah's Solar Panels need open sky and
                    daylight. Wire them to Create's Electric
                    Motor to spin a shaft with sunlight.


===========================================================
   IF SOMETHING GOES WRONG
===========================================================

"You are not white-listed on this server"
    Your username isn't on the list, or it is on the list
    spelled differently. Send Dan the exact username from
    your launcher, character for character.

"Incompatible client" / kicked immediately on join
    Your Fabric Loader is too old. Re-run the Fabric
    installer from Step 1 and let it install the newest
    loader for 1.20.1.

Game crashes while loading, or right after the download
    Almost always memory. Go back to Step 4 and confirm
    the JVM Arguments line really says -Xmx8G. This is the
    single most common failure.

Stuck on "Connecting to the server..."
    Give it a full minute on the first attempt. If it times
    out, quit all the way out of Minecraft and try once
    more - the sync mod sometimes needs a clean start.

Can't see any of the mech or Create items
    The modpack download didn't finish. Leave the server,
    rejoin, and let the sync run again from the top.

Anything else
    Tell Dan what the screen said, word for word. The exact
    wording is what identifies the problem.


===========================================================
   THE SHORT VERSION
===========================================================

    1. Minecraft Java Edition, and get whitelisted
    2. Fabric installer -> 1.20.1
    3. AutoModpack 4.0.6 + Fabric API 0.92.12 -> mods folder
    4. JVM arguments -> -Xmx8G
    5. Add server  mechbay.modded.fun
    6. Accept the certificate, accept the download, restart
    7. Build mechs

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