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.