> For the complete documentation index, see [llms.txt](https://wiki.betabuddies.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.betabuddies.xyz/technical-troubleshoot.md).

# Technical troubleshoot

### BTA 7.3\_04 Performance Guide *For Better Than Adventure! 7.3\_04 with latest Babric*

1. Java 17 Required BTA 7.3+ requires **Java 17** (Temurin/Adoptium recommended) **Download:** <https://adoptium.net/temurin/releases/?version=17> **Setup in Prism Launcher:**
2. Edit Instance → Settings → Java
3. Check "Java installation"
4. Auto-detect or browse to Java 17

***

2. RAM Settings **Prism Launcher:** Edit Instance → Settings → Java | Your Total RAM | Allocate to BTA | |----------------|-----------------| | 8 GB | 3-4 GB | | 16 GB | 4-6 GB | | 32 GB | 6-8 GB | **⚠️ Don't allocate more than 8GB** - causes garbage collection stutter!

***

3. JVM Arguments Paste into Prism Launcher → Edit Instance → Settings → Java → JVM Arguments: -XX:+UnlockExperimentalVMOptions -XX:+UseG1GC -XX:G1NewSizePercent=20 -XX:G1ReservePercent=20 -XX:MaxGCPauseMillis=50 -XX:G1HeapRegionSize=32M

***

### 4. Video Settings (In-Game)

Press **ESC** → **Options** → **Video Settings**

| Setting             | Recommended |
| ------------------- | ----------- |
| **Render Distance** | **6-8**     |
| Graphics            | Fast        |
| Smooth Lighting     | **OFF**     |
| Clouds              | **OFF**     |
| Particles           | Minimal     |
| VSync               | **OFF**     |
| Max Framerate       | Unlimited   |

***

### 5. Force Dedicated GPU

Your game might be using integrated graphics instead of your dedicated GPU.

#### NVIDIA:

1. Right-click desktop → **NVIDIA Control Panel**
2. Manage 3D Settings → **Program Settings**
3. Click **Add** → browse to `javaw.exe` (in your Java 17 folder)
4. Select **High-performance NVIDIA processor**
5. Apply

#### AMD:

1. Right-click desktop → **AMD Software**
2. Gaming → **Add Game**
3. Browse to `javaw.exe`
4. Set Graphics Profile to **Gaming**

***

### 6. Match Server Mods

Your client needs these mods with **exact same versions** as server:

| Mod                                        | Version               |
| ------------------------------------------ | --------------------- |
| HalpLibe                                   | 5.3.3                 |
| Catalyst Core                              | 2.2.0-7.3\_04         |
| Catalyst Effects                           | 2.5.3-7.3\_04         |
| Stardew                                    | 3.4.3+7.3\_04         |
| Better with Aether                         | 1.0.0+7.3\_04         |
| Dragonfly                                  | 1.7.0-alpha.7-7.3\_04 |
| **Mismatched versions = crashes and lag!** |                       |

***

### 7. Quick Checklist

* [ ] **Java 17** selected (not 8, not 21)
* [ ] **4-6 GB RAM** allocated (not more!)
* [ ] **JVM arguments** set
* [ ] **Dedicated GPU** forced in driver settings
* [ ] **Render distance 6-8**
* [ ] **Smooth lighting OFF**
* [ ] **VSync OFF**
* [ ] All **mod versions match** server

***

### 8. Troubleshooting

#### "I still get low FPS"

* Press **F3** in-game
* Check **Display:** line - should show your GPU name (RTX/RX/etc)
* If it says "Intel" → you're using integrated graphics, see step 5

#### "Game stutters every few seconds"

* Too much RAM allocated → try lowering to 4GB
* Or not enough RAM → try increasing to 4GB

#### "Chunks load slowly"

* Normal when exploring new areas (server generating chunks)
* Already-visited areas should be smooth

#### "Lag only on this server"

* Check ping in F3 screen
* High entity count in area (lots of mobs/dropped items)
* Server might be overloaded

***

### 9. Still Having Issues?

Press **F3** and take a screenshot showing:

* **fps:** Your framerate
* **E:** Entity count
* **Mem:** Memory usage (shouldn't be 100%)
* **Display:** Your GPU Post screenshot in Discord for help!

***

### Downloads

* **Java 17:** <https://adoptium.net/temurin/releases/?version=17>
* **BTA Mods:** <https://modrinth.com/collection/Nur20P9G>