Better With Dynmap

A Dynmap port for Better Than Adventure (BTA) – a Minecraft Beta 1.7.3 fork.

Features

• Full BTA block support with automatic texture extraction
• Season-aware rendering (Spring, Summer, Fall, Winter)
• Multi-dimension support:
• Overworld – Standard rendering with seasonal foliage colors
• Nether (DIM1) – BTA’s unique upper-half nether (y=128-256)
• Aether (DIM9) – Support for the Better With Aether (not included in base BTA)
• Paradise (DIM2) – Disabled by default, can be enabled in worlds.txt
• Custom BTA tree foliage colormaps (Oak, Birch, Pine, Eucalyptus, Shrub, etc.)
• Real-time season and day display on web interface
• Player tracking

Requirements

• Better Than Adventure (BTA) server
• Babric mod loader
• Java 17+
• ~500MB disk space for map tiles (varies with world size)

Installation

1. Download better_with_dynmap-1.0.0.jar from releases
2. Place in your BTA server’s mods/ folder
3. Start the server – Dynmap will generate default configuration
4. Access the map at http://localhost:8123 (default port)

Configuration

Configuration files are located in dynmap/ folder:

| File | Purpose |
|——|———|
| configuration.txt | Main settings (web server port, render threads, etc.) |
| worlds.txt | World/dimension settings and map types |
| custom-shaders.txt | BTA texture shader definitions |
| custom-perspectives.txt | Custom camera perspectives (includes BTA Nether) |

Changing Web Server Port

Edit configuration.txt:

webserver-port: 8123

Enabling Paradise Dimension

Edit worlds.txt and change enabled: false to enabled: true for DIM2.

Commands

| Command | Description |
|———|————-|
| dynmap fullrender <world> | Render entire world |
| dynmap radiusrender <world> <radius> | Render area around you |
| dynmap cancelrender <world> | Cancel active render |
| dynmap pause all | Pause all rendering |
| dynmap pause none | Resume rendering |
| dynmap stats | Show render statistics |
| dynmap hide / dynmap show | Hide/show yourself on map |

World Names

• world – Overworld
• DIM1 – Nether
• DIM9 – Aether
• DIM2 – Paradise

Building from Source

git clone https://github.com/yourusername/better-with-dynmap.git
cd better-with-dynmap
./gradlew clean build

Output JAR will be in build/libs/.

How It Works

1. Texture Extraction: On first run, extracts textures from BTA’s texture pack
2. Block Registration: Scans BTA’s block registry and generates Dynmap-compatible definitions
3. Colormap Loading: Loads BTA’s seasonal colormaps for grass/foliage tinting
4. Tile Rendering: Renders map tiles using extracted textures and colormaps

BTA-Specific Adaptations

• Nether Rendering: BTA’s Nether has terrain at y=128-256 (not y=0-127 like vanilla). Custom perspectives handle this.
• Season System: Colormaps change based on BTA’s in-game season
• Tree Types: Each BTA tree type has its own colormap (not just biome-based)
• Dimension IDs: BTA uses different dimension IDs than vanilla (Nether=1, Paradise=2, Aether=9)

Troubleshooting

Map shows only background color

• Run dynmap fullrender <world> to generate tiles
• Check server console for errors

Textures missing or wrong colors

• Delete dynmap/texturepacks/bta/ and dynmap/renderdata/bta-texture.txt
• Restart server to regenerate texture definitions

Credits

• Dynmap – Original dynmap mod by mikeprimm
• Better Than Adventure – The BTA mod team

License

Apache License 2.0 – See LICENSE for details.

Based on Dynmap, which is a registered trademark of Michael Primm.