ship it

content/docs/advanced/meta.json

@@ -0,0 +1,5 @@
+{
+  "title": "Advanced",
+  "pages": ["private-server"],
+  "defaultOpen": false
+}

content/docs/advanced/private-server.mdx

@@ -0,0 +1,68 @@
+---
+title: Private Server Setup
+---
+
+import {Tab, Tabs} from 'fumadocs-ui/components/tabs';
+import {File, Folder, Files} from 'fumadocs-ui/components/files';
+
+## Starting a server
+
+In each of the mod file folders we provide server files as well (one for each operating system), you can use these files to run your own server.
+
+<Tabs items={['Windows', 'Mac/Linux']}>
+	<Tab value="Windows">
+		Download `server-win.exe` and run that file.
+	</Tab>
+	<Tab value="Mac/Linux">
+		Download `server-mac`. Once you download that open terminal and navigate to where that file is
+		by running
+		```sh
+		cd /path/to/directory/where/server-mac/is
+		```
+
+		Then, run
+		```sh
+		chmod +x server-mac
+		```
+
+		After that you can run
+
+		```sh
+		./server-mac
+		```
+		to run the server.
+	</Tab>
+</Tabs>
+
+## Connecting to the server
+
+Once the server is running you will have to modify your config to point to the server.
+To modify your config go to the location where your `Mods` folder is,
+beside that folder will be another folder called `config`, inside the `config` folder will be a file called `Multiplayer.jkr`.
+If this file is not there for you then you need to launch the game with the Multiplayer mod installed at least once.
+
+<Files>
+	<Folder name="Mods">
+		<File name="Multiplayer"/>
+	</Folder>
+	<Folder name="config" defaultOpen>
+		<File name="Multiplayer.jkr"/>
+	</Folder>
+
+</Files>
+
+The contents of this file will look something like this by default:
+
+```lua
+return {
+    ["username"] = "Guest",
+    ["server_url"] = "balatro.virtualized.dev",
+    ["server_port"] = 8788,
+}
+```
+
+If you are running the server on your computer you can change the `server_url` field to `"localhost"`,
+but your friends will have to connect to you over the internet or through a tunnel service like Hamachi or ZeroTier.
+
+For them to connect over the internet you will have to port forward port `8788` on your PC and router,
+then they will have to input your public IP address in the `server_url`. You can find your public IP address by going to a site like this: https://www.whatismyip.com.

content/docs/getting-started/faq.mdx

@@ -0,0 +1,157 @@
+---
+title: FAQ
+---
+
+import {DownloadIcon} from "lucide-react";
+import {Steps, Step} from "fumadocs-ui/components/steps";
+import {Tab, Tabs} from 'fumadocs-ui/components/tabs';
+
+## How does the mod work?
+
+When you install the mod you will have two extra buttons on the main menu to start a lobby and to join a lobby.
+The person who starts the lobby will be given game mode options and are able to invite others by sending them a code.
+For the most popular game mode, each player will play the small and big blinds normally, and each boss blind
+will be a PvP blind where you are trying to beat the other player's score.
+You won't lose when you fail a blind, but you will lose a life every time you lose to the other person,
+and there are lobby options set by the lobby host to modify how the game modes work or change
+the amount of lives each player has.
+
+## I don't know how to or am having trouble installing the mod, what do I do?
+
+There is instructions for installing the mod
+[here.](/docs/getting-started/installation)
+If you followed the instructions and are still having trouble you can open a support ticket in
+the [Discord server](https://discord.com/channels/1226193436521267223/1227357106064326727)
+and a Developer, Admin, or Helper will help you ASAP.
+
+## Do I need to start a server to play with my friends?
+
+**TL;DR:** No, there is an official one.
+
+**Long answer:**
+
+No, there is an official server that you will automatically connect to
+when you start the game with the mod installed,
+although if you have problems connecting or want to host a private server you can follow these instructions:
+
+<Card
+	href="/docs/advanced/private-server"
+	title="Private Server Setup"
+>
+	Host your own server for your friends to connect to.
+</Card>
+
+## Can you play with more than 2 people?
+
+**TL;DR:** Not yet.
+
+**Long answer:**
+
+Not right now but there is a Battle Royale mode being worked on and tested actively which will allow up to 8 players.
+
+## Is there a co-op mode?
+
+**TL;DR:** Not yet.
+
+**Long answer:**
+
+There have been many ideas for co-op modes posted in
+[# old_suggestions](https://discord.com/channels/1226193436521267223/1226416122685816914),
+we don't have a co-op mode right now, but it is planned.
+If you have an idea for how a co-op mode would work, feel free send a suggestion in.
+
+## I am having an issue installing the mod or crash when I launch Balatro, what should I do?
+
+Open a support ticket by going to
+our [Discord server](https://discord.com/channels/1226193436521267223/1227357106064326727)
+and pressing "Open support thread."
+This will create a private thread in the support channel where a Developer, Admin or Helper
+will respond as soon as someone is available.
+
+## I am not able to connect to the Multiplayer server, what should I do?
+
+The first thing you can do is open a
+[ticket](https://discord.com/channels/1226193436521267223/1227357106064326727)
+to try and figure out if it is a fixable problem, but sometimes you may not be able to connect to the server due to your network or country.
+In the case that you cannot connect to the server you and your friends will have to play on a private server,
+you can follow these instructions:
+
+<Card
+	href="/docs/advanced/private-server"
+	title="Private Server Setup"
+>
+	Host your own server for your friends to connect to.
+</Card>
+
+## Is the Multiplayer mod compatible with other mods?
+
+The Multiplayer mod **should be compatible with most other mods** that use Steamodded version **1.0.0 or higher** or Lovely directly.
+If there is a mod that is problems or crashes with the Multiplayer mod you can submit a bug report
+in [# bug-report](https://discord.com/channels/1226193436521267223/1226614033503752253),
+and we will try and make the Multiplayer mod compatible with it.
+
+## I want to try this mod, but I don't have anyone to try it with, how can I find people in this server that want to play
+
+**TL;DR:** Go to [# custom-lfg.](https://discord.com/channels/1226193436521267223/1226597231289827458)
+
+**Long answer:**
+
+There is a role in
+[# roles](https://discord.com/channels/1226193436521267223/1227405578268315708)
+that anyone can give themselves called **The Lovers (LFG)**,
+anyone who has this role is welcoming pings in the
+[# custom-lfg](https://discord.com/channels/1226193436521267223/1226597231289827458)
+channel. If you want to find someone to play with you can ping the LFG role in the
+[# custom-lfg](https://discord.com/channels/1226193436521267223/1226597231289827458)
+channel and ask if anyone wants to play. Alternatively if you give yourself the role
+you will be pinged when someone else is looking for someone to play.
+
+## Is there a way to see your opponents jokers or hands?
+
+**TL;DR:** Not yet.
+
+**Long answer:**
+
+No, not right now, but this will probably be implemented as a mechanic in a future update,
+such as having a joker or voucher that tells you what the opponent's jokers are.
+
+## I don't want to or can't play on the official server, how do I open a private server?
+
+You can follow these instructions:
+<Card
+	href="/docs/advanced/private-server"
+	title="Private Server Setup"
+>
+	Host your own server for your friends to connect to.
+</Card>
+
+## When I download Lovely my browser and antivirus tell me that it is dangerous, is it safe?
+
+**TL;DR:** Lovely is safe.
+
+**Long answer:**
+The reason that lovely is marked as a virus by your browser and antivirus software is because it is a trojan (just not the bad kind).
+What lovely does is takes the code of all the mods in your mods folder and injects it into Balatro so that the mods can modify
+Balatro's code directly. This is dangerous when used by a bad actor because they could inject something dangerous into something
+you run all the time, this dangerous injection could steal your information, hold your files hostage, or control your computer.
+So, although Lovely is injecting stuff into your Balatro exe it is not doing anything dangerous.
+**You should be careful of the mods you install** though, any mod that is injected into Balatro will have full access to your computer as
+if it was Balatro trying to do those things which makes it much harder to detect.
+
+
+## Does the mod work if I don't use Steam (App Store/Mobile/Switch/Console/etc)?
+
+**TL;DR:** No.
+
+**Long answer:**
+
+No, not only will you not be able to mod those versions easily,
+the game differs from platform to platform so the mod may not even work on another platform even if you could mod it.
+
+## Will we be putting the mod on platforms like Thunderstore mod manager?
+
+The mod is probably compatible with Thunderstore mod manager as of 0.1.6 but as Steamodded is not updated past 0.9.8 on
+Thunderstore it wouldn't make sense for us to upload it there.
+Every multiplayer version past 0.1.3 requires Steamodded 1.0.0+.
+If Steamodded gets updated on Thunderstore we will look into supporting Thunderstore more seriously.
+If you are a die hard Thunderstore fan you could probably add our mod and Steamodded 1.0.0 as local mods and see if it works properly.

content/docs/getting-started/installation.mdx

@@ -0,0 +1,68 @@
+---
+title: Installation
+---
+
+import {DownloadIcon} from "lucide-react";
+import {Steps, Step} from "fumadocs-ui/components/steps";
+import {Tab, Tabs} from 'fumadocs-ui/components/tabs';
+
+## General Instructions
+
+<Steps>
+	<Step>
+
+		### Install Lovely and Steamodded
+		Follow the guide here to install: https://github.com/Steamopollys/Steamodded/wiki
+
+	</Step>
+
+	<Step>
+
+		### Download the latest version of the Multiplayer mod
+		<Button asChild className='no-underline'><a
+			href="https://github.com/Balatro-Multiplayer/BalatroMultiplayer/releases/latest/download/BalatroMultiplayer.zip"
+			rel={'noopener noreferrer'}><DownloadIcon/>Download the latest version</a></Button>
+
+	</Step>
+	<Step>
+
+		### Add the mod to your `Mods` folder
+
+		Unzip the `Multiplayer.zip` file and put the folder in the Mods folder described by the Steamodded instructions.
+	</Step>
+</Steps>
+>
+
+
+
+If you need any further help or run into any problems feel free to open a ticket [in the Discord server.](https://discord.com/channels/1226193436521267223/1227357106064326727)
+
+## Video Instructions
+
+<Tabs items={['Windows', 'Mac', 'Linux/Steamdeck', 'Balatro Mod Manager (Windows/Mac)']}>
+	<Tab value="Windows" className={'flex justify-center'}>
+		<iframe width="560" height="315" src="https://www.youtube.com/embed/iqTpHz5vZgA" title="YouTube video player"
+				frameBorder="0"
+				allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+				allowFullScreen></iframe>
+	</Tab>
+	<Tab value="Mac" className={'flex justify-center'}>
+		<iframe width="560" height="315" src="https://www.youtube.com/embed/05Hs8f1t8eo" title="YouTube video player"
+				frameBorder="0"
+				allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+				allowFullScreen></iframe>
+	</Tab>
+	<Tab value="Linux/Steamdeck" className={'flex justify-center'}>
+		<iframe width="560" height="315" src="https://www.youtube.com/embed/zaVy_AwojQk" title="YouTube video player"
+				frameBorder="0"
+				allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+				allowFullScreen></iframe>
+	</Tab>
+	<Tab value="Balatro Mod Manager (Windows/Mac)" className={'flex justify-center'}>
+		<iframe width="560" height="315" src="https://www.youtube.com/embed/JG3jw0oqRZo?si=LaHTjWe6xX6EVdqa"
+				title="YouTube video player"
+				frameBorder="0"
+				allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+				allowFullScreen></iframe>
+	</Tab>
+</Tabs>

content/docs/getting-started/meta.json

@@ -0,0 +1,5 @@
+{
+  "title": "Getting Started",
+  "pages": ["installation", "faq"],
+  "defaultOpen": true
+}

content/docs/index.mdx

@@ -1,7 +1,20 @@
 ---
-title: Hello World
+title: Introduction
 ---
 
-## Introduction
+Balatro Multiplayer is a mod for Balatro that allows you to play with your friends or against other players.
 
-I love Anime.
+<Cards>
+	<Card
+		href="/docs/getting-started/installation"
+		title="Installation"
+	>
+		Learn how to install the mod.
+	</Card>
+	<Card
+		href="/docs/getting-started/installation"
+		title="FAQ"
+	>
+		Answers to common questions.
+	</Card>
+</Cards>

content/docs/meta.json

@@ -0,0 +1,5 @@
+{
+  "title": "Advanced",
+  "pages": ["index", "getting-started", "advanced"],
+  "defaultOpen": true
+}

src/app/(home)/about/page.tsx

@@ -1,3 +1,10 @@
 export default async function About() {
-  return <div>About</div>
+  return (
+    <div className={'container mx-auto pt-8'}>
+      <div className={'prose'}>
+        <h1>About</h1>
+        <p>This is empty for now, we'll add some content here soon.</p>
+      </div>
+    </div>
+  )
 }

src/app/(home)/page.tsx

@@ -24,7 +24,7 @@ export default function Home() {
         <section className='space-y-6 pt-6 pb-8 md:pt-10 md:pb-12 lg:py-32'>
           <div className='container mx-auto flex flex-col items-center gap-4 text-center'>
             <Link
-              href='https://github.com'
+              href='https://github.com/Balatro-Multiplayer'
               className='rounded-2xl bg-muted px-4 py-1.5 font-medium text-sm'
               target='_blank'
             >
@@ -44,7 +44,7 @@ export default function Home() {
                 size='lg'
                 className='w-full bg-red-600 text-white hover:bg-red-700 sm:w-auto'
               >
-                <Link href='/docs/installation'>
+                <Link href='/docs/getting-started/installation'>
                   Get Started
                   <ChevronRight className='ml-2 h-4 w-4' />
                 </Link>
@@ -71,8 +71,7 @@ export default function Home() {
               Features
             </h2>
             <p className='max-w-[85%] text-muted-foreground leading-normal sm:text-lg sm:leading-7'>
-              Everything you need to enjoy Balatro with friends and the wider
+              Play with friends, compete globally, join tournaments
-              community.
             </p>
           </div>
           <div className='mx-auto grid justify-center gap-4 sm:grid-cols-2 md:max-w-[64rem] md:grid-cols-3'>
@@ -81,10 +80,7 @@ export default function Home() {
                 <CardTitle>Real-time Matches</CardTitle>
               </CardHeader>
               <CardContent>
-                <p>
+                <p>Challenge friends to head-to-head Balatro matches.</p>
-                  Challenge friends to head-to-head poker matches with
-                  synchronized gameplay.
-                </p>
               </CardContent>
             </Card>
             <Card>
@@ -93,7 +89,7 @@ export default function Home() {
               </CardHeader>
               <CardContent>
                 <p>
-                  Create and join tournaments with custom rules and brackets.
+                  Join our weekly tournaments and compete against other players.
                 </p>
               </CardContent>
             </Card>
@@ -110,12 +106,12 @@ export default function Home() {
             </Card>
             <Card>
               <CardHeader>
-                <CardTitle>Spectator Mode</CardTitle>
+                <CardTitle>Active Community</CardTitle>
               </CardHeader>
               <CardContent>
                 <p>
-                  Watch live matches between top players and learn new
+                  Join our Discord server to find matches, share strategies, and
-                  strategies.
+                  participate in community events.
                 </p>
               </CardContent>
             </Card>
@@ -164,8 +160,7 @@ export default function Home() {
               </CardHeader>
               <CardContent className='flex-grow'>
                 <p className='mb-4 text-muted-foreground'>
-                  Create a lobby and share the code with friends for casual
+                  Challenge friends in private matches
-                  matches.
                 </p>
                 <ul className='space-y-2 text-sm'>
                   <li className='flex items-start gap-2'>
@@ -190,11 +185,11 @@ export default function Home() {
                   </li>
                 </ul>
               </CardContent>
-              <div className='mt-auto p-6 pt-0'>
+              {/*<div className='mt-auto p-6 pt-0'>*/}
-                <Button variant='outline' className='w-full' asChild>
+              {/*  <Button variant='outline' className='w-full' asChild>*/}
-                  <Link href='/docs/direct-play'>Learn More</Link>
+              {/*    <Link href='/docs/direct-play'>Learn More</Link>*/}
-                </Button>
+              {/*  </Button>*/}
-              </div>
+              {/*</div>*/}
             </Card>
 
             <Card className='flex h-full flex-col'>
@@ -206,8 +201,7 @@ export default function Home() {
               </CardHeader>
               <CardContent className='flex-grow'>
                 <p className='mb-4 text-muted-foreground'>
-                  Join ranked queues with MMR-based matchmaking and
+                  Compete in two distinct queues:
-                  leaderboards.
                 </p>
                 <div className='space-y-4'>
                   <div className='space-y-2 text-sm'>
@@ -228,11 +222,11 @@ export default function Home() {
                   </div>
                 </div>
               </CardContent>
-              <div className='mt-auto p-6 pt-0'>
+              {/*<div className='mt-auto p-6 pt-0'>*/}
-                <Button variant='outline' className='w-full' asChild>
+              {/*  <Button variant='outline' className='w-full' asChild>*/}
-                  <Link href='/docs/matchmaking'>Learn More</Link>
+              {/*    <Link href='/docs/matchmaking'>Learn More</Link>*/}
-                </Button>
+              {/*  </Button>*/}
-              </div>
+              {/*</div>*/}
             </Card>
 
             <Card className='flex h-full flex-col'>
@@ -244,8 +238,7 @@ export default function Home() {
               </CardHeader>
               <CardContent className='flex-grow'>
                 <p className='mb-4 text-muted-foreground'>
-                  Find players for games with custom rulesets via our Discord
+                  Organize custom matches with unique rules and mods
-                  community.
                 </p>
                 <ul className='space-y-2 text-sm'>
                   <li className='flex items-start gap-2'>
@@ -270,8 +263,8 @@ export default function Home() {
               </CardContent>
               <div className='mt-auto p-6 pt-0'>
                 <Button variant='outline' className='w-full' asChild>
-                  <Link href='https://discord.gg/balatro' target='_blank'>
+                  <Link href='https://discord.gg/E4ZFwWbtT5' target='_blank'>
-                    Join Discord
+                    Join Our Discord
                   </Link>
                 </Button>
               </div>
@@ -313,8 +306,8 @@ export default function Home() {
                     <div className='space-y-1'>
                       <h3 className='font-bold text-xl'>Install the Mod</h3>
                       <p className='text-muted-foreground'>
-                        Download and install the multiplayer mod using our
+                        Download and install the multiplayer mod by following
-                        simple installer.
+                        the instructions on our documentation.
                       </p>
                     </div>
                   </li>
@@ -323,9 +316,7 @@ export default function Home() {
                       2
                     </div>
                     <div className='space-y-1'>
-                      <h3 className='font-bold text-xl'>
+                      <h3 className='font-bold text-xl'>Start a match</h3>
-                        Create or Join a Game
-                      </h3>
                       <p className='text-muted-foreground'>
                         Host your own game or join an existing one with a simple
                         game code.
@@ -351,7 +342,9 @@ export default function Home() {
                     className='w-full bg-red-600 text-white hover:bg-red-700 sm:w-auto'
                     asChild
                   >
-                    <Link href='/docs/installation'>Install Now</Link>
+                    <Link href='/docs/getting-started/installation'>
+                      Install Now
+                    </Link>
                   </Button>
                 </div>
               </div>
@@ -373,15 +366,16 @@ export default function Home() {
               Ready to Play?
             </h2>
             <p className='max-w-[600px] text-muted-foreground md:text-xl/relaxed'>
-              Join thousands of Balatro players already enjoying multiplayer
+              Join our competitive community of 3,000+ ranked players.
-              matches.
             </p>
             <Button
               size='lg'
               className='mt-4 w-full bg-red-600 text-white hover:bg-red-700 sm:w-auto'
               asChild
             >
-              <Link href='/docs/installation'>Get Started Now</Link>
+              <Link href='/docs/getting-started/installation'>
+                Get Started Now
+              </Link>
             </Button>
           </div>
         </section>
@@ -405,12 +399,12 @@ export default function Home() {
             >
               About
             </Link>
-            <Link
+            {/*<Link*/}
-              href='/credits'
+            {/*  href='/credits'*/}
-              className='text-muted-foreground text-sm underline-offset-4 hover:underline'
+            {/*  className='text-muted-foreground text-sm underline-offset-4 hover:underline'*/}
-            >
+            {/*>*/}
-              Credits
+            {/*  Credits*/}
-            </Link>
+            {/*</Link>*/}
             <GithubLinks>
               <DropdownMenuTrigger asChild>
                 <Button variant='ghost' size='icon'>

src/app/docs/[[...slug]]/page.tsx

@@ -1,3 +1,5 @@
+import { Button } from '@/components/ui/button'
+import { ImageZoom } from 'fumadocs-ui/components/image-zoom'
 import defaultMdxComponents from 'fumadocs-ui/mdx'
 import {
   DocsBody,
@@ -23,7 +25,13 @@ export default async function Page(props: {
       <DocsTitle>{page.data.title}</DocsTitle>
       <DocsDescription>{page.data.description}</DocsDescription>
       <DocsBody>
-        <MDX components={{ ...defaultMdxComponents }} />
+        <MDX
+          components={{
+            ...defaultMdxComponents,
+            img: (props) => <ImageZoom {...(props as any)} />,
+            Button: (props) => <Button {...(props as any)} />,
+          }}
+        />
       </DocsBody>
     </DocsPage>
   )

src/app/layout.config.tsx

@@ -18,11 +18,11 @@ const links = [
     url: '/about',
     icon: <Info />,
   },
-  {
+  // {
-    text: 'Credits',
+  //   text: 'Credits',
-    url: '/credits',
+  //   url: '/credits',
-    icon: <Award />,
+  //   icon: <Award />,
-  },
+  // },
 ]
 const nav = {
   title: (