> This mod is VERY WIP so there're many bugs. Back up important worlds before playing
## What it does
- Prompt-controlled terrain height, relief, roughness, erosion and terraces
- Oceans, islands, floating islands and connected caves with configurable scale
- Exact vanilla block materials, including prompts such as diamond-block worlds
- Procedural cities.
- Vanilla fauna profiles.
- Saved, paginated and renameable generated worlds
The same prompt, model version and Minecraft world seed resolves to the same
generated sector. Only visited chunks are generated.
## Requirements
- Minecraft Java Edition 1.20.1
- Forge 47.4.10 or a newer compatible Forge 47.x build
- Java 17
- This mod on the server and every connecting client
- Ollama and an installed text model.
In singleplayer, the logical server is the player's computer. On a dedicated
server, only the server owner needs Ollama and the model; connecting players do
not.
## Installation
1. Create or select a Minecraft 1.20.1 Forge profile.
2. Put the Forge JAR in the profile's `mods` folder. For multiplayer, install
the same JAR on the dedicated server and all clients.
3. Install and start Ollama.
4. Install the default multilingual model(qwen3:4b) from a terminal:
```
ollama pull qwen3:4b
```
5. Start Minecraft.
## How to use
Craft the portal gun or run:
```
/give @s ricksgun:portal_gun
```
The shaped recipe is:
```text
E E
I N I
R I
```
`E` = Eye of Ender, `I` = Iron Ingot, `N` = Nether Star, `R` = Redstone.
1. Hold the gun and sneak + right-click to open the target screen.
2. Use **Find world** to enter a description, or choose a saved target from
**Worlds**. Use **Main world** for vanilla and loaded mod dimensions.
3. Close the screen and right-click to fire.
## Configuration
The first launch creates `config/ricksgun-ollama.json`:
```json
{
"model": "qwen3:4b",
"timeout_seconds": 180,
"concurrency": 2,
"queue_capacity": 14,
"keep_alive": "5m"
}
```
## Alpha limitations
- Generation quality and response time depend on the local model and hardware.
- The Minecraft build range remains `-64..319`; a prompt selects the usable
portion but cannot change the engine-level dimension height at runtime.
- Generated targets occupy isolated sectors in one registered dimension because
Minecraft cannot safely register new dimension types after startup.
