# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.betabuddies.xyz/technical-troubleshoot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.