Open-source project
LiteLDev/LeviLamina avatar
LiteLDev/LeviLamina

LeviLamina for Minecraft Bedrock Server and Client Mods

A lightweight, modular and versatile mod loader for Minecraft Bedrock Edition, formerly known as LiteLoaderBDS

1,701 stars128 forksC++LGPL-3.0

At a glance

What is it?
LeviLamina is an unofficial C++ mod loader for Minecraft Bedrock Edition, formerly known as LiteLoaderBDS. It provides APIs, events, and client or server installation paths, subject to its EULA and usage guidelines.
Who is it for?
Adopt LeviLamina when you are building C++ mods for a Bedrock dedicated server or client and can comply with its EULA and usage guidelines. Do not choose it for a project that requires an official extension API, a closed distribution model, or independence from the loader version.
Can I use it commercially?
Yes, with conditions. LGPL-3.0 is a weak copyleft licence: you can use it inside commercial and closed-source software, but if you distribute changes to its own files, you must publish those changes under the same licence.
Is it still maintained?
Yes. The repository received new commits within the last day.
What is it written in?
Mainly C++, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on October 23, 2026, and from our analysis. They are not legal advice.

Editorial analysis

LeviLamina's Bedrock Mod Loading Scope

LeviLamina addresses a specific problem in Minecraft Bedrock Edition modding: it gives C++ developers a runtime through which they can add gameplay features and other functionality. The project describes itself as an unofficial mod loader for Minecraft Bedrock Edition and notes that it was formerly known as LiteLoaderBDS. Its intended users are developers who want to extend Bedrock behavior, rather than players looking only for a settings panel or a prebuilt server manager.

The repository presents separate installation documentation for servers and clients. That distinction matters because LeviLamina supports two deployment contexts described in different guides. A server installation concerns the Bedrock dedicated server environment, while a client installation concerns the client-side mod environment. The README does not claim that one package or procedure automatically covers both cases, so users should select the guide that matches the intended deployment.

LeviLamina states that developers can write mods in C++. This makes it relevant to developers who already work with native code and want access to the interfaces exposed by the loader. It is not presented as a JavaScript, Python, or configuration-only extension system. The exact compatibility of a particular mod with a particular Bedrock release remains something to verify against the project documentation and the mod's own requirements.

The unofficial status is central to the tool's adoption decision. LeviLamina supplies its own APIs and installation process rather than representing an extension API published by Minecraft. Teams whose procurement, moderation, or support policies require an official platform should account for that difference before treating the loader as a standard server component.

LeviLamina APIs, Events, and Module Boundaries

The README identifies four broad technical areas: a comprehensive API, utility interfaces, an event system, and support for basic interfaces. These features describe the extension surface available to a LeviLamina mod. The README does not list individual class names, method signatures, event payloads, or a complete module-loading sequence. It directs developers to the documentation at `https://lamina.levimc.org` for those details.

The practical distinction is between running LeviLamina and developing against its interfaces. A mod can be designed to respond to game events, call loader-provided utility or basic interfaces, and add behavior through the API. The event system is relevant when a mod must react to game state rather than repeatedly inspect it. However, the README does not confirm which events exist, how event handlers are registered, whether an event can be cancelled, or whether handlers execute on a particular thread.

The project describes LeviLamina as modular. That means the loader is intended to support separate mods rather than requiring every change to be folded into a single modification. The README does not document dependency conflict handling, load order, permission boundaries, hot reload, or a formal compatibility matrix. Those points cannot be inferred merely from the word "modular." A developer should consult the LeviLamina documentation for the module conventions and interfaces required by the specific mod.

This documentation boundary affects code review. A team can choose LeviLamina based on the stated C++ approach, API support, and event system, but it still needs concrete interface definitions before estimating implementation work. Without those definitions, assumptions about calling frequency, failure handling, or lifecycle timing would remain unsupported.

Server and Client Installation Paths

The repository's installation section contains links rather than command-line instructions. LeviLamina directs users to separate guides titled `Install on Server` and `Install on Client`. Their addresses are shown below.

text
https://lamina.levimc.org/user_guides/install/
https://lamina.levimc.org/user_guides/install_on_client/

These are documentation URLs, not shell commands. The first opens the server installation guide, while the second opens the client installation guide. The README does not provide installation commands, package names, environment variables, ports, or configuration snippets, so this article does not invent any.

A first real use begins by choosing the environment that matches the intended deployment. For a dedicated server, follow the linked server guide for file placement and startup behavior. For a client-side mod, use the client guide instead. After installing LeviLamina, the next step is to add a mod built against its C++ interfaces.

The README does not include a sample mod source file, build command, generated output, or dependency declaration. Those details must come from the linked guides and the individual mod's files. The repository's top-level layout includes `xmake.lua`, `src-client/`, `src-server/`, `src-test/`, `scripts/`, and `src/`. This indicates that the loader is a C++ codebase with distinct source areas, but the directory names are not a substitute for the installation guide.

After the first successful start, check the server console or the documented client output for errors before adding more mods. The README does not identify a specific success message or logging location, so operators should not expect a particular string based on this page alone.

Undocumented Compatibility and Failure Boundaries

LeviLamina offers a general compatibility statement for Minecraft Bedrock Edition, but the README does not state a supported Bedrock version range, a list of supported operating systems, or a precise mapping between loader releases and game versions. The listed release names include `v26.51.7`, `v26.51.6`, and `v26.51.5`. Those version identifiers do not by themselves establish which Minecraft build a server should use.

The README also does not document performance overhead, memory consumption, crash-report format, hot-reload behavior, plugin isolation, permission controls, or rollback procedures. An operator therefore cannot conclude from the README that installing LeviLamina has no effect on server resources or that a failed mod has a documented removal command. These are concrete checks for the linked documentation and the chosen mod.

Client use has a separate uncertainty. LeviLamina provides a client installation guide, but the README does not say whether clients need matching server-side components, how network compatibility changes when a mod is installed, or how mismatched versions are diagnosed. A mod that changes synchronized behavior should be treated as part of the deployment contract until its documentation establishes the exact requirement.

There is also no documented fault-isolation guarantee in the README. Modular loading does not automatically mean that one faulty mod will be prevented from affecting the game process or other mods. An operator who cannot tolerate unstable server startup should review that boundary before adding LeviLamina to production.

LeviLamina Versus Official Bedrock Integration Paths

A real alternative is an official or separately supported Bedrock integration path that defines its own extension model instead of relying on LeviLamina's loader. The difference is architectural. LeviLamina is an unofficial C++ mod loader with its own API, event system, utility interfaces, client installation path, and server installation path. A different integration may define another module format, packaging process, update policy, and source-level interface.

The choice affects more than the programming language. Selecting LeviLamina means accepting that the mod is built against its interfaces and distributed for that runtime. Selecting another platform means accepting that platform's API and packaging rules. Without documentation for a specific alternative, it would be misleading to claim feature parity, lower resource use, or better stability. The supported comparison is limited but concrete: LeviLamina explicitly provides C++ modding facilities through an unofficial loader, and its own documentation is the source for supported versions and deployment procedures.

LeviLamina is the wrong tool when an official, vendor-supported extension mechanism is a firm requirement. The project explicitly calls itself unofficial. It is also a poor match for a distribution process that cannot include third-party server or client components. In those cases, the absence of a vendor extension path for the required Bedrock behavior is a more important constraint than LeviLamina's feature list.

LeviLamina Releases, License, and Upgrade Work

The repository is not archived, and its last push was on 2026-10-15. Recent releases include `v26.51.7` on 2026-10-12, `v26.51.6` on 2026-09-29, and `v26.51.5` on 2026-09-21. These dates show recent repository and release activity. They do not guarantee that every mod remains compatible or that a particular release supports every Bedrock version.

LeviLamina uses the `LGPL-3.0` license for its non-closed source parts. The repository includes `COPYING` and `COPYING.LESSER`, so source consumers should inspect those files for license details. The README separately warns developers to read `EULA.en.md` and `docs/main/contents/common_guides/usage_guidelines.en.md`. Distribution of LeviLamina-derived code or operation of a mod may therefore involve both license obligations and project-specific usage restrictions. This article does not interpret those documents or provide legal advice.

Upgrades require checking the loader, target Bedrock version, mod source, and any module dependencies together. The README does not include a migration guide, compatibility table, or automated upgrade process. A team should therefore avoid assuming that moving from `v26.51.5` to `v26.51.7` is source-compatible. The changelog in `CHANGELOG.md` is the first repository-specific file to inspect when planning a version change.

Editorial conclusion

Adopt LeviLamina when you are building C++ mods for a Bedrock dedicated server or client and can comply with its EULA and usage guidelines. Do not choose it for a project that requires an official extension API, a closed distribution model, or independence from the loader version. Verify the applicable Bedrock version, the selected LeviLamina release, and the corresponding server or client installation guide before deployment.

Frequently asked questions

What is LeviLamina used for in Minecraft Bedrock Edition?

LeviLamina is an unofficial C++ mod loader intended to add gameplay features and other functionality to Minecraft Bedrock Edition. The README lists an API, utility interfaces, an event system, and support for basic interfaces.

How do I install LeviLamina on a Bedrock dedicated server?

The README directs server users to the `Install on Server` guide at `https://lamina.levimc.org/user_guides/install/`. It does not provide installation commands or file-placement steps in the README itself.

Does LeviLamina support client-side Minecraft Bedrock mods?

Yes. The README links to an `Install on Client` guide at `https://lamina.levimc.org/user_guides/install_on_client/`, so client installation is a documented deployment path. It does not state the supported client versions or the complete mod-loading workflow.

Which license applies to LeviLamina?

The repository identifies `LGPL-3.0` as the license for LeviLamina's non-closed source parts. It directs users to `COPYING` and `COPYING.LESSER` for the license details.

What should be checked before upgrading LeviLamina?

Check `CHANGELOG.md`, the selected LeviLamina release, the target Bedrock version, and the requirements of every installed mod. The README does not document a compatibility matrix or automated migration procedure.

Official sources

  1. License: LGPL-3.0
  2. LiteLDev/LeviLamina on GitHub
  3. Project website
  4. README
  5. Releases
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/liteldev-levilamina.svg)](https://hysenlabs.com/projects/liteldev-levilamina)

Was this useful?