Repository navigation
Releases
Unreal BMFont 1.0.0
Unreal BMFont 1.0.0
首个稳定版本:导入 AngelCode BMFont 描述和图集,在 Slate / UMG 中渲染位图字体,提供普通文本控件和 Rich Text 适配器。
主要变化
- 字体度量和渲染资源变化会刷新已有控件;packed-channel 材质恢复可用后,画刷也能恢复。
- 明确公开 API、资产 schema 和非破坏性的 beta 升级路径。
- 可运行示例包含数字、A-Z、平假名、中文数字、缺字回退、packed 通道和多页图集。
- 修复字体检查器摘要、图集主题背景色、Alpha 为零的 packed 预览和缩略图,以及内容浏览器标准重导入操作。
- 文档、样例指南和贡献表单提供英文与简体中文版本。
兼容性与下载
已验证范围:UE 5.8.0 源码构建、CL 0 / Windows Win64。不声明支持其他 Unreal 版本、Launcher 发行版或其他平台。
- UnrealBMFont-1.0.0-Source.zip:源码、运行时内容、文档、样例和展示模板,使用目标引擎构建。
- UnrealBMFont-1.0.0-UE5.8.0-SourceBuild-Win64.zip:适用于本次确切引擎构建的预编译插件。Editor BuildId:e3415f47-6f61-4145-b84b-cfbeb0377ffa。
- SHA256SUMS.txt:两份归档的 SHA-256 校验值。
仅有相同的 5.8 版本号不足以保证二进制兼容。引擎构建不同时,请编译源码包,不要修改模块 BuildId。将 UnrealBMFont 文件夹解压到项目的 Plugins 目录并启用;替换已有插件前关闭编辑器。
验证结果
2026-10-15(Asia/Singapore,UTC+08:00),针对提交 fc4d051 验证:
- Editor Development、Game Development、Game Shipping 构建及插件包审计通过。
- 完整无 GPU 套件 44 项通过;其中在 NullRHI 下跳过渲染的案例,由第二轮完整真实 GPU 套件覆盖,44 项通过。两轮均为零警告结果、零失败、零未完成;这是同一套测试运行两次,不是额外增加的独立测试。
- Development、Shipping 各自通过 Plain、Packed、MultiPage、RichText 四类真实资产 GPU 探针,均为零不匹配像素。
- 最终预编译插件在全新纯内容宿主中直接加载,未重编译 DLL;无 GPU 和完整 GPU 两轮分别通过 44、44 项测试,零警告结果、零失败。
- 解压后的 160 个预编译文件与已测试插件包一致;源码归档的 142 个文件与提交的 Git blob 一致。
- 已交互检查编辑器 Play、字体检查器、图集页和字形选择,以及重导入;验收时的源码、材质、样例输入和示例插件设置与本版一致。
升级与限制
备份项目并保留原始 .fnt 和图集图片。现有资产及控件属性名称保持不变。先打开一次性副本,保存代表性资产,检查渲染和重导入,再使用目标引擎打包。详见升级说明、公开 API和兼容性。
布局从左到右,不提供自动 shaping、连字或双向重排。支持 packed 字形覆盖率,不单独合成 outline 通道。PNG 是已验证的图集格式。
采用 MIT License。两份归档均包含许可证、供参考的中文译文和第三方声明。
Unreal BMFont 1.0.0
The first stable release of the AngelCode BMFont importer and bitmap-font renderer for Slate and UMG, with a plain-text widget and Rich Text adapter.
Highlights
- Live font-metric and render-resource updates, including recovery when a packed-channel material becomes available.
- A documented public API, asset schema, and non-destructive beta upgrade path.
- A runnable example with digits, A-Z, hiragana, Chinese numerals, missing-glyph fallback, packed channels, and multiple atlas pages.
- Fixed font-inspector summaries, theme-aware atlas backgrounds, zero-alpha packed previews and thumbnails, and standard Content Browser reimport actions.
- English and Simplified Chinese documentation, sample guides, and contribution forms.
Compatibility and downloads
Validated scope: UE 5.8.0 source build, CL 0 / Windows Win64. Other Unreal versions, Launcher builds, and other platforms are not claimed as supported.
- UnrealBMFont-1.0.0-Source.zip: source, runtime content, documentation, samples, and the example template. Build with your target engine.
- UnrealBMFont-1.0.0-UE5.8.0-SourceBuild-Win64.zip: precompiled plugin for the exact tested engine build. Editor BuildId: e3415f47-6f61-4145-b84b-cfbeb0377ffa.
- SHA256SUMS.txt: SHA-256 checksums for both archives.
A matching 5.8 version number alone does not make precompiled binaries compatible. When the engine build differs, compile the source package; do not rewrite module BuildIds. Extract the UnrealBMFont directory into your project's Plugins directory and enable it. Close the editor before replacing an existing plugin.
Verification
Validated on 2026-10-15 (Asia/Singapore, UTC+08:00), at commit fc4d051:
- Editor Development, Game Development, and Game Shipping builds and package audits passed.
- Full headless suite: 44 passed. Rendering cases skipped under NullRHI were covered by a second complete real-GPU run: 44 passed. Both runs had zero warning results, failures, or incomplete tests; these are two runs of the same suite, not distinct additional tests.
- Packaged Development and Shipping each passed all four real-asset GPU probes: Plain, Packed, MultiPage, and RichText, with zero mismatched pixels.
- The final precompiled plugin loaded in a fresh content-only host without rebuilding its DLLs. Its headless and full GPU runs passed 44 and 44 tests respectively, with no warning results or failures.
- 160 extracted precompiled files matched the tested package; 142 source-archive files matched the committed Git blobs.
- Editor Play, the font inspector, atlas-page/glyph selection, and reimport were interactively checked; the accepted source, material, sample inputs, and example plugin settings match this release.
Upgrade and limitations
Back up your project and retain the original .fnt descriptors and atlas images. Existing asset and widget property names are unchanged. Open a disposable copy, resave representative assets, check rendering and reimport, then package with the target engine. See upgrading, public API, and compatibility.
Layout is left-to-right; automatic shaping, ligatures, and bidirectional reordering are out of scope. Packed glyph coverage is supported, but outline channels are not composited separately. PNG is the validated atlas format.
MIT License. Both archives include the license, its informational Chinese translation, and third-party notices.
Unreal BMFont 0.3.0
Unreal BMFont 0.3.0
This beta hardens descriptor parsing and release verification, keeps plain-text rendering proportional to the glyphs actually used, and adds end-to-end packaged runtime smoke coverage.
Highlights
- Adds configurable parser limits for descriptor size, text/XML shape, pages, glyphs, kerning pairs, page names, atlas dimensions, and total multi-page atlas pixels.
- Rejects XML
DOCTYPEdeclarations and oversized XML structures before DOM materialization. - Caps malformed-input diagnostics while preserving warning-only success and retaining suppressed error severity.
- Supports valid non-contiguous page IDs without confusing numeric IDs with the configured page-record limit.
- Scopes plain-text Slate brush caches to glyphs used by the current layout, including coverage for a generated 20,000-glyph asset.
- Moves packed-material resolution into asset lifecycle updates and allows one bounded render-time retry after a transient load failure.
- Adds a clean packaged-runtime harness that builds, cooks, packages, launches, and validates both Development and Shipping targets.
- Strengthens package auditing so licensing, documentation, samples, runtime content, and checksum requirements stay aligned.
Compatibility and verification
- Built from commit
82c4b1b1d76e9c1ac91cbe87bd1f57ab0722c78e. - Verified with Unreal Engine 5.8.0 source build on Windows 11 / Win64.
UnrealEditor Development,UnrealGame Development, andUnrealGame Shippingplugin targets built successfully.- Repository validation, Python compilation, PowerShell syntax checks, package audit, ZIP path-safety audit, and extracted-file SHA-256 comparison passed.
- Unreal automation passed: 36/36 tests under NullRHI, with 0 warning results and 0 failures.
- GPU automation passed: 7/7 render tests on D3D12 / NVIDIA GeForce RTX 3080, with 0 warning results and 0 failures.
- Fresh packaged Development and Shipping builds both launched successfully and produced deterministic markers for
UBMFontTextand/UnrealBMFont/M_BMFontPacked.M_BMFontPacked. - GitHub repository checks passed for the release commit; the opt-in UE self-hosted job was skipped, so Unreal verification comes from the archived local run above.
Install
- Download
UnrealBMFont-0.3.0-UE5.8-Win64.zip. - Extract the included
UnrealBMFontdirectory into<YourProject>/Plugins/. - Enable Unreal BMFont in the Plugins window and restart the editor when prompted.
The attached package is precompiled for Unreal Engine 5.8 / Win64. GitHub's source archives remain available for developers who want to build the plugin themselves.
Known limitations
- Unreal Engine 5.7 and earlier, future Unreal minors, Linux, macOS, consoles, and mobile are not yet claimed.
- PNG page images are covered by automated import tests; other formats accepted by
UTextureFactoryare outside the compatibility claim. - The renderer does not perform bidirectional layout, OpenType shaping, ligatures, or combining-mark positioning.
- Packed outline channels are flattened into glyph coverage rather than composited separately.
- Rich-text kerning does not cross run boundaries, and BMFont runs use the widget's appearance properties rather than named row styles.
- Interactive packaged screenshot comparison and cross-vendor GPU variance remain unverified.
See Format support, Rich Text, Compatibility, and Roadmap for details.
Verify the download with the attached SHA256SUMS.txt.
Unreal BMFont 0.2.0
Unreal BMFont 0.2.0
The second public beta of Unreal BMFont adds packed-channel atlas rendering, BMFont-backed Rich Text runs, safer reimport, richer editor tooling, and GPU screenshot regression tests.
Highlights
- Renders packed-channel (
packed=1) atlases through the bundledM_BMFontPackedUI material, with per-glyph channel masks and per-asset material overrides. - Imports packed atlas textures with sRGB disabled and preserves the material dependency in saved assets.
- Adds
UBMFontRichTextBlockfor tagged or plain BMFont runs, including inherited foreground colors, clipping, shadow bounds, empty tags, and ellipsis policies. - Makes multi-page reimport transactional: all replacement images are staged before commit, with rollback on failure.
- Adds BMFont asset thumbnails and a read-only font/atlas inspector with descriptor summary, atlas preview, glyph rectangles, selection, and glyph table.
- Adds real-RHI screenshot regression tests and checked-in ground-truth images.
Compatibility and verification
- Built from commit
2059cf8311052f2b08d01e52d2659bf3f92e2bd2. - Verified with Unreal Engine 5.8.0 source build on Windows 11 / Win64.
UnrealEditor Development,UnrealGame Development, andUnrealGame Shippingplugin targets built successfully.- Repository validation, PowerShell syntax checks, package audit, ZIP safety audit, and extracted-file hash comparison passed.
- Unreal automation passed: 30/30 tests under NullRHI, with 0 warning results.
- GPU automation passed: 7/7 render tests on D3D12 / NVIDIA GeForce RTX 3080, with 0 warning results.
- All four screenshot ground-truth PNGs were regenerated on the reference GPU with zero SHA-256 drift.
- Packaged Development and Shipping runtime launches passed with NullRHI and created the expected
UBMFontTextsmoke marker.
Install
- Download
UnrealBMFont-0.2.0-UE5.8-Win64.zip. - Extract the included
UnrealBMFontdirectory into<YourProject>/Plugins/. - Enable Unreal BMFont in the Plugins window and restart the editor when prompted.
The attached package is precompiled for Unreal Engine 5.8 / Win64. GitHub's source archives remain available for developers who want to build the plugin themselves.
Known limitations
- Unreal Engine 5.7 and earlier, future Unreal minors, Linux, macOS, consoles, and mobile are not yet claimed.
- PNG page images are covered by automated import tests; other formats accepted by
UTextureFactoryare outside the compatibility claim. - The renderer does not perform bidirectional layout, OpenType shaping, ligatures, or combining-mark positioning.
- Packed outline channels are flattened into glyph coverage rather than composited separately.
- Rich-text kerning does not cross run boundaries, and BMFont runs use the widget's appearance properties rather than named row styles.
- Interactive packaged screenshot comparison and cross-vendor GPU variance remain unverified.
See Format support, Rich Text, Compatibility, and Roadmap for details.
Verify the download with the attached SHA256SUMS.txt.
Unreal BMFont 0.1.0
Unreal BMFont 0.1.0
The first public beta of Unreal BMFont, an Unreal Engine plugin for importing and rendering AngelCode BMFont bitmap fonts in Slate and UMG.
Highlights
- Imports AngelCode BMFont text, XML, and binary v3 descriptors.
- Supports multiple atlas pages, Unicode code points, kerning, fallback glyphs, wrapping, justification, margins, tint, shadow, and pixel snapping.
- Provides the plain-text
UBMFontTextUMG widget and lower-levelSBMFontTextSlate widget. - Includes safe reimport, source tracking, editor asset integration, sample fixtures, and automated parser/layout/import tests.
Compatibility and verification
- Built from commit
7127f24d39d5cf93c3745e41572e24a07a53968e. - Verified with Unreal Engine 5.8.0 source build on Windows 11 / Win64.
UnrealEditor Development,UnrealGame Development, andUnrealGame Shippingplugin targets built successfully.- Repository validation passed.
- Unreal automation passed: 14/14 tests, with 0 warning results.
- Packaged Development runtime launch has been verified with NullRHI.
- Packaged Shipping runtime launch is not yet claimed.
Install
- Download
UnrealBMFont-0.1.0-UE5.8-Win64.zip. - Extract the included
UnrealBMFontdirectory into<YourProject>/Plugins/. - Enable Unreal BMFont in the Plugins window and restart the editor when prompted.
The attached package is precompiled for Unreal Engine 5.8 / Win64. Source archives generated by GitHub remain available for developers who want to build the plugin themselves.
Known limitations
- Unreal Engine 5.7 and earlier, Linux, macOS, consoles, and mobile are not yet claimed.
- PNG page images are covered by automated import tests; other TextureFactory formats are not part of the current compatibility claim.
- Packed-channel atlases are parsed for diagnostics but rejected by the importer.
- The renderer does not perform bidirectional layout, OpenType shaping, ligatures, or combining-mark positioning.
See Format support, Compatibility, and Roadmap for details.
Verify the download with the attached SHA256SUMS.txt.


