Newer Version Available

This release has been superseded by v1.1.51 which includes the Windows Manager UI, professional installer, and enhanced configuration options.

View Latest Release (v1.1.51)

Archived Release

MCBDS Manager v1.1

Pack Management, Player Allowlist, and More

Released: January 2025 • Archived • View on GitHub

What's New

Resource & Behavior Pack Management

Upload packs directly from web interface
Support for .zip and .mcpack formats
Enable/disable packs with one click
Automatic manifest.json parsing
Pack validation before installation
Visual pack management dashboard

Player Allowlist (Whitelist) System

Manage allowed players via web UI
Xbox Live XUID automatic lookup
Manual XUID entry option
VIP player limit exceptions
Bulk import/export capabilities
Automatic allowlist.json sync

Xbox Live Integration

XUID lookup via OpenXBL API
24-hour result caching
Fallback to manual entry
Known gamertag mappings
API key configuration

Additional Improvements

Smart configuration merging on upgrades
Improved error handling
Enhanced API documentation
Performance optimizations
Bug fixes and stability improvements

Backward Compatibility

Fully Compatible!

v1.1 maintains full backward compatibility with v1.0:

Old UI + New Server: Works perfectly, new features not visible in UI
New UI + Old Server: Works perfectly, new features gracefully hidden
No Breaking Changes: All existing APIs and features continue working
Settings Preserved: Upgrade without reconfiguration

Read Full Compatibility Guide

Important: Docker Deprecation

Docker Version Will Be Deprecated in v1.2

We're consolidating on the Windows Service installer for better performance, easier updates, and native Windows integration.

Timeline:

Now (v1.1): Docker still supported
Q2 2025 (v1.2): Docker removed
Action: Migrate to Windows Service

Why Switch?

? Better performance (native execution)
? Automatic Windows updates
? Easier configuration
? Native service management

View Migration Guide

Technical Details

API Changes:

GET /api/version - Now returns supportsPackManagement and supportsAllowlist
GET /api/packs - NEW: List installed packs
POST /api/packs/upload - NEW: Upload pack files
POST /api/packs/enable - NEW: Enable pack for world
POST /api/packs/disable - NEW: Disable pack
GET /api/allowlist - NEW: Get allowlist data
POST /api/allowlist/add - NEW: Add player
DELETE /api/allowlist/remove - NEW: Remove player
GET /api/xboxlive/lookup/{gamertag} - NEW: XUID lookup

Configuration Changes:

// New in appsettings.json
{
  "XboxLive": {
    "ApiKey": "your-openxbl-api-key",
    "ApiBaseUrl": "https://xbl.io/api/v2",
    "EnableCaching": true,
    "CacheExpirationMinutes": 1440
  }
}

System Requirements:

Windows 10 (1809+), Windows 11, or Windows Server 2019+
.NET 10.0 Runtime (included in installer)
2GB+ RAM, 2+ CPU cores
Administrator privileges for installation

Installation

Fresh Install:

Download the installer
Run as Administrator
Follow configuration wizard
Point to your Bedrock server
Access dashboard at http://localhost:8080

Upgrading from v1.0:

Download v1.1 installer
Run installer (no uninstall needed)
Your settings are automatically preserved
Service restarts with new features
Done! No reconfiguration required

Full Installation Guide

Known Issues

Pack Upload Size: Limited to 100MB per file (configurable in IIS)
Xbox Live Lookup: Requires free API key from OpenXBL (xbl.io)
Windows Only: Linux/Docker support ending in v1.2

Report issues on GitHub ?

Credits & Thanks

Special thanks to:

OpenXBL (xbl.io) - Xbox Live XUID lookup API
Contributors - Bug reports and feature requests
Community - Testing and feedback

What's Next?

Planned for future releases:

v1.2 (Q2 2025): Docker removal, additional pack features, iOS app
v2.0 (TBD): Multi-server management, user authentication, scheduled commands

Join the discussion about future features ?

Ready to Upgrade?

Download MCBDS Manager v1.1

Free & Open Source • Windows 10/11 • ~50MB