Changelog

Important

A Note on the Future of BSM: Preparing for Version 3.6.0

As part of the ongoing effort to modernize the Bedrock Server Manager codebase for better performance, stability, and maintainability, the upcoming version 3.6.0 will introduce major architectural changes. I want to be transparent about these developments so you can plan accordingly, as these changes will change the way you interact with the application.

The core goal of 3.6.0 is to unify the server management experience across all platforms (Windows, Linux, etc.) by moving away from platform-specific implementations like named pipes and separate system services.

Key changes to expect in BSM 3.6.0 include:

Unified Process Management: All Bedrock servers will be managed within a single, multi-threaded BSM process. This replaces the current model of launching a separate process for each server, which will significantly improve performance, resource usage, and allow for more reliable features like health checks and automatic crash recovery.
Mandatory Web Server: The web server will become the central, always-running component of BSM. The Command Line Interface (CLI) will be refactored to communicate directly with the web server’s API for all operations. This change is essential for the new unified process model.
Simplified Services: Individual server services (systemd on Linux, Windows Services) will be deprecated. Instead, the main BSM web server service will be responsible for automatically starting all designated servers on boot.
Database Migration: To consolidate the various .json configuration files and prevent potential file-locking issues, BSM will migrate to a dedicated database (a simple, file-based one by default). This will also pave the way for future enhancements like multi-user accounts and permissions. (May not be included in 3.6.0)
Deprecation of CLI Plugins: A side effect of the new architecture is that custom CLI plugins, introduced in v3.5.0, will likely be removed. Since the CLI will now be a client for the web API, this plugin type will no longer be compatible.

I understand that frequent breaking changes can be frustrating. Many of the recent updates have involved significant refactoring to evolve BSM from its simple script origins into the robust management tool it’s become. This upcoming 3.6.0 release represents the final major step in this architectural overhaul. These changes will create a more stable and feature-rich foundation for the future of Bedrock Server Manager.

3.5.7

Tip

Experience the new CLI before the 3.6.0 now:

pip install bedrock-server-manager[cli]

Use the bsm-api-client command to interact with the web server

View all commands at: BSM API Commands

Added generic task manager for FastAPI background task
- Background task now retun a task ID you can use to monitor various task such as server installs, backups and more.
- Added /api/tasks/status/{task_id} for status tracking
- If your FASTAPI plugin uses background task, consider migrating to the bedrock_server_manager.web.tasks functions for a consistent user experience
Fixed server version api endpoint
Improved CLI permissions menu experience
No longer restart server after properties change

3.5.6

Fixed allowlist remove command
Filter logs to only show BSM and Plugin logs
Minor backend changes
Added various tests for the CLI and Web API
BREAKING CHANGE: Task shceduler functionality has been removed from the CLI and Web API.

Note

The current task scheduler functionality will be reintroduced in a future as optiaonal plugins.

3.5.5

Hot fix for server properties path

3.5.4

FIxed custom cli/web plugins not being loaded correctly.

3.5.3

Optimzed class initialization

3.5.2

Fixed missing html for Content Upload Plugin.
Hardcode uvicorn workers to 1 to avoid potential conflict with flile locking and theme loading issues.

3.5.1

Fixed a bug where running the web server behind a reverse proxy was causing issues with the web UI and API routes.

3.5.0

Warning

BREAKING CHANGE: WEB USERS If you are using the web server, you must regenerate your password hash and auth tokens.

Tip

Documentation for the Bedrock Server Manager (BSM) has been completely revamped and is now available at:

Main: https://bedrock-server-manager.readthedocs.io/

Mirror: https://dmedina559.github.io/bedrock-server-manager/

CLI/WEB Plugins: Experimental support for custom CLI and Web plugins

Important

When using these new plugin types that extend Bedrock Server Manager (BSM) functionality, exercise caution during installation and execution. Always ensure you understand the plugin’s operations before running it.

Warning

Plugins that add web endpoints have the potential to expose sensitive data. If you’re developing such a plugin, it’s highly recommended to use the bedrock_server_manager.web get_current_user dependencies within your FastAPI routers. This helps secure your endpoints with the same authentication system the main web app uses.
- Plugins can add custom CLI commands or entities to the CLI menu
- Plugins can add custom web API endpoints/UI menus
- New default plugin: Upload Content Plugin (disabled by default)
- Support for package format plugin
  - In addition to the standalone py file plugins, support for plugins in a python package format has been added
Windows Service:

Running Bedrock Server Manager components (Web UI, individual Bedrock Servers) as Windows Services allows them to run in the background, start automatically on boot, and be managed by the Windows Service Control Manager.

Important

It is highly recommended to use a Python installation downloaded from python.org rather than the version available from the Microsoft Store. The Microsoft Store version of Python has been observed to cause significant file locking issues when used with Windows Services, preventing other Python scripts or applications (including new BSM CLI sessions) from running correctly, even when using virtual environments. Using the python.org installer typically avoids these specific locking problems.
- General Considerations:
  - Administrator Privileges: Creating, configuring, starting, and stopping Windows services requires Administrator privileges. You can achieve this by:
    - Running your Command Prompt or PowerShell as an Administrator before executing bsm commands.
    - Using the sudo command on recent versions of Windows if you have it configured.
      - See Microsoft Sudo for Windows documentation.
  - Service Account: By default, services created by BSM might be configured to run as the “Local System” account. For Bedrock servers, which often need to access user-specific paths for server files, content, and backups (e.g., in your user profile or a directory your user owns), it is usually necessary to change the service’s “Log On As” account to your local Windows user account. This can be done via the Services app (services.msc) after the service has been created by BSM. This step ensures the service has the correct permissions. Failure to do this is a common cause of services not starting or functioning correctly.
Web server as a service:
- Create a system service (Systemd on Linux / Windows Service).
- On Linux, you’ll need to manually create an environment file with your BSM environment variables and add the EnvironmentFile= line to your systemd file.
- The host will be read from the JSON config file.
- On Windows, uvicorn workers will default to 1 instead of the configured settings value.
Web UI Themes:
- Added support for custom themes in the Web UI.
- Themes can be placed in the themes directory.
- The Web UI will automatically list them in the settings menu.
- Various themes are available, including:
  - dark
  - light
  - red
  - blue
  - yellow
  - green
  - black
  - gradient
- The default theme is dark theme (original OreUI insipred).
Config JSON migrations:
- The global script_config.json has been renamed to bedrock_server_manager.json.
- Global settings have been migrated to a new nested format. A backup will be created, and an auto-migration will be attempted.
- Server config JSONs have been migrated to a new nested format. Auto-migration will be attempted, and any custom config options will be moved to a nested custom section.
- Added web_server_host to config. If the web server is started without a host argument, it will read from the JSON file.
- BASE_DIR has been migrated to paths.servers.
Background Task:
- API routes for update, start, stop, and other long running endpoints have been converted to FastAPI’s BackgroundTasks for better responsiveness.
- As a result Web APIs now instantly return a success response instead of the actual result for the task. In future versions, these endpoints will be updated to handle this.
New plugin APIs:
- APIs to read global and server configurations.
- API to set custom global and server configurations.
Custom Bedrock Server Zips
- Added support for custom Bedrock Server zips.
- These can be placed in the DOWNLOAD_DIR/custom directory.
- The Web/CLI UI will automatically list them in the server creation, when target version is set to CUSTOM.
Fixed world icon API route path typo: word -> world.
Plugin Event: The before_server_stop event no longer uses the mode variable.
Added a settings menu to the Web UI.

```{note}
Not all settings (like web host/port) will be reloaded on the fly. These require a full application restart to take effect.
```

BREAKING CHANGE: Migrated Flask to FastAPI for the Web API.
- This allows for better performance and more modern features.
- The Web UI has been updated to work with the new FastAPI routes.
- Always up-to-date HTTP API docs are now available in the Web UI footer HTTP API link or at http(s)/bs.host.url/docs.
- The OpenAPI json are also available at http(s)/bs.host.url/api/openapi.json.
- Switched to uvicorn as the ASGI server for the Web API.
- Switched to bcrypt for password hashing in the Web API.
  - This requires you to regenerate your password hash and auth tokens.
BREAKING CHANGE: /api/login has been changed to /auth/token
Noteworthy change:
- /api/plugins/reload method changed to PUT instead of POST.

3.4.1

Fixed settings target version for new server installations.
For simplicity, documentation has been removed from the web server and moved to the repository’s /docs folder.

3.4.0

Warning

STOP SERVERS BEFORE UPDATING

BREAKING CHANGE: Linux systemd service files have been changed.
- You must reconfigure autostart (autostart --reconfigure) to update your systemd service files.
- This is due to the service type being changed from forking to simple.
- BSM now directly manages the bedrock_server process, and screen has been removed as a dependency. You can uninstall it with sudo apt remove screen.
- A note to Linux users: I apologize for the repeated systemd reconfigurations, but this should be the last time!
The biggest feature since the web server: PLUGINS!
- Plugins are a new way to extend BSM’s functionality.
- Install plugins by placing the .py file in the plugins folder (e.g., ~/bedrock-server-manager/plugins).
- Enable/disable plugins in plugins.json located in the config directory (e.g., ~/bedrock-server-manager/.config). Plugins are disabled by default.
- See the Plugin Documentation for details.
- See default plugins for examples.
- Added a plugin command to the CLI. See the updated CLI Commands.
- Added plugin management to the CLI and Web UI.
- Default plugins are included and can be enabled, disabled, or overridden.
- A custom event system allows plugins to communicate with each other and external sources.
BREAKING CHANGE: Removed /restore/all route. This is now part of the /restore/action route, where all is a type parameter in the JSON body.
BREAKING CHANGE: Removed /world_name route. Use the get properties route instead.
Changed /backups/list/ to /backup/list/.
Optimized various HTML routes. Pages now render faster, with data being pulled dynamically via JavaScript. The servers table in the Web UI updates automatically without a page refresh.
Improved resource usage monitoring by refactoring it into a generic ResourceMonitor class.
Improved filesystem functions by using threading.Lock to prevent race conditions.

3.3.1

Fixed panorama display in the Web UI.
Fixed server process handling in the Web API.
Fixed task command execution in the Web UI.

3.3.0

Caution

MAJOR BREAKING CHANGES - READ FULL CHANGELOG BEFORE UPDATING

Warning

STOP SERVERS BEFORE UPDATING

Start/Stop methods have been revamped. If you update before stopping your servers, you may need to manually terminate the running bedrock_server processes.

Revamped all CLI modules: Any scripts or scheduled tasks using the old CLI commands must be recreated.
- See the updated CLI_COMMANDS.md for the new command structure.
- The CLI has been modernized using the click and questionary modules for a better interactive experience.
Changed allowlist remove player route to /api/server/{server_name}/allowlist/remove.
Revamped start server actions:
- Windows: Starting a server now creates a named pipe for sending commands. The -m/--mode flag controls behavior (detached for background, direct for foreground).
- Linux: The start command now incorporates systemd logic. The -m/--mode flag controls behavior (detached tries systemctl first, direct uses screen). You must recreate your systemd service files.
Added reset-world action to delete a server’s world folder (available in CLI and Web UI).
Added command sending for actions like shutdown messages and reloading configurations.
Application can now be run as a module with python -m bedrock_server_manager <command>.
Changed list-backups backup-type from ‘config’ to ‘allowlist’, ‘properties’, or ‘permissions’.
CLI and File log levels now have separate configuration values (CLI_LOG_LEVEL, FILE_LOG_LEVEL).
Fixed stop-web-server bug where it could kill the wrong process.
Removed getting started guides and other extra content from the web server.
Refactored core functions and classes (BedrockServerManager, BedrockServer, BedrockDownloader) for better structure and capabilities.
Migrated task schedulers to their own classes to reduce redundant logic.
General code cleanup, file reorganization, and removal of redundant functions.

3.2.5

Fixed the server download function to use the updated Minecraft website URL.

3.2.4

Fixed the restart-server command in the CLI.

3.2.3

Added /api/server/{server_name}/backups/list/{type} route.
Added /api/content/worlds route.
Added /api/content/addons route.
Added /api/players/get route.
Added /api/players/add route.
Added /api/server/{server_name}/permissions_data route.
File/folder paths for HTTP restore and prune APIs must now be relative.
Routes like /api/servers/{server_name}/ are now /api/server/{server_name}/.
Fixed passing the host argument to the web server.

3.2.2

Fixed wrong module being used for the “read server properties” route.

3.2.1

Added /api/info route.
Added /api/server/{server_name}/read_properties route.
The server is now stopped before exporting a world.

3.2.0

Added “export world” functionality to the Web UI. The export now goes to the content folder.
Added “remove player from allowlist” to the Web UI and CLI.
Added a command blacklist for sensitive commands like stop.
Added more splash text.

3.1.4

Revised HTTP docs included with the web server.
Added /api/servers endpoint to list all servers and their status.

3.1.3

Revised docs included with the web server.

3.1.2

Fixed various JavaScript, allowlist, backup, and session token issues in the Web UI.

3.1.1

Fixed missing assets (JS/images) for the web server.
Added missing generate-password command.
Fixed manage-script-config command.

3.1.0

Added Web Server:
- Requires environment variables for configuration: BEDROCK_SERVER_MANAGER_USERNAME, BEDROCK_SERVER_MANAGER_PASSWORD (hashed), BEDROCK_SERVER_MANAGER_SECRET, and BEDROCK_SERVER_MANAGER_TOKEN.
- It is strongly recommended to run this behind a reverse proxy (e.g., NGINX, Caddy).
- Features a mobile-friendly UI and customizable panorama.
Added generate-password command to create password hashes.
Added start-web-server command with direct and detached modes.
Added stop-web-server command.
Refactored CLI and handler code into new cli/api modules.
Added more detailed logging and documentation throughout the codebase.
Added splash text to the CLI Main Menu.
SEMI-BREAKING CHANGE: Changed the data directory structure. You may need to update your environment variable path if upgrading from older 3.0 versions.

3.0.3

Fixed resource usage monitor on Linux.
Fixed systemd enable/disable functionality on Linux.

3.0.2

Fixed EXPATH variable in the Linux scheduler.
Fixed “Modify Windows Task” functionality.

3.0.1

Refactored the CLI to use a new handlers module.
Refactored settings into a class-based structure.
Fixed logger variables.
[WIP] Initial support for sending commands on Windows (requires pywin32).

3.0.0

BREAKING CHANGE: Completely refactored from a single .py script to a proper Pip package. Installation and updates are now done via pip.
Use the BEDROCK_SERVER_MANAGER_DATA_DIR environment variable to set the data location.
Logging was refactored to use Python’s standard logging module, and functions now raise exceptions instead of returning error codes.
Removed windows-start/stop commands.
Added several new commands and new configuration variables to script_config.json.