A parser for Minecraft's legacy formatting system, created with careful attention to the quirks of the vanilla client's implementation.
- Iterator-based, non-allocating parser
- Supports
#![no_std]
usage (withdefault-features
set tofalse
) - Implements the entire spec as well as vanilla client quirks (such as handling
of whitespace with the
STRIKETHROUGH
style) - Helpers for pretty-printing the parsed
Span
s to the terminal - Support for parsing any start character for the formatting codes (vanilla
uses
§
while many community tools use&
)
Using SpanIter
:
use mc_legacy_formatting::{SpanExt, Span, Color, Styles};
let s = "§4This will be dark red §oand italic";
let mut span_iter = s.span_iter();
assert_eq!(span_iter.next().unwrap(), Span::new_styled("This will be dark red ", Color::DarkRed, Styles::empty()));
assert_eq!(span_iter.next().unwrap(), Span::new_styled("and italic", Color::DarkRed, Styles::ITALIC));
assert!(span_iter.next().is_none());
With a custom start character:
use mc_legacy_formatting::{SpanExt, Span, Color, Styles};
let s = "&6It's a lot easier to type &b& &6than &b§";
let mut span_iter = s.span_iter().with_start_char('&');
assert_eq!(span_iter.next().unwrap(), Span::new_styled("It's a lot easier to type ", Color::Gold, Styles::empty()));
assert_eq!(span_iter.next().unwrap(), Span::new_styled("& ", Color::Aqua, Styles::empty()));
assert_eq!(span_iter.next().unwrap(), Span::new_styled("than ", Color::Gold, Styles::empty()));
assert_eq!(span_iter.next().unwrap(), Span::new_styled("§", Color::Aqua, Styles::empty()));
assert!(span_iter.next().is_none());
The editor-gui folder contains a small Rust GUI program built on top of egui. This program runs both natively and on the web, providing a side-by-side editor experience that allows you to enter text using legacy format codes (prefixed by &
) and instantly see the formatted output on the right-hand side.
Try it online or see the editor-gui README file for instructions on building it locally.
The Minimum Supported Rust Version is currently 1.56.0. This will be bumped to the latest stable version of Rust when needed.
Licensed under either of Apache License, Version 2.0 or MIT license at your option.Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.