Inline is a minecraft library for rendering in-line with text. It has some player facing features, mostly for fun, but also to serve as examples and helpers for future devs.
See the Modrinth Gallery for images.
Inline has 3 core components: Matchers, Data, and Renderers.
Matchers are responsible for parsing any and all text before it's rendered in-game and attaching appropriate Data to that text. For most cases you'll want to use a RegexMatcher. Matchers only exist on the client.
Data is primarily just a standardized box used to pass arbitrary data to the renderer. It gets passed around by being stuck to a text's Style. Notably, data exists on the server as well as the client. This is so that mods can attach data to text directly instead of going through a matcher.
Finally, Renderers take in some data and render something in place of a character. Inline comes with a variety of built in renderers, in some cases it may be beneficial to re-use these either by extending its data or by composition.
Inline comes with a couple of built-in matchers:
- Items -- ex:
[item:diamond_sword]-- supports any item id - Entity -- ex:
[entity:pig]-- supports any entity type id - Player heads -- ex:
[face:samsthenerd]-- supports player name or uuid. - Mod Icon -- ex:
[mod:inline]
Some other mods, such as emi, rei, and probably others, add the name of the mod that an item comes from to its tooltip. Inline will look for this and attach the mod's icon to it.
All of these are configurable from the in-game config screen.
Inline is hosted on the BlameJared Maven
You can depend on it using gradle:
// add it to your maven repos
repositories {
maven { url "https://maven.blamejared.com" }
}
// depend on it in common if multiloader:
modApi "com.samsthenerd.inline:inline-common:${project.inline_version}"
// and in fabric
modApi "com.samsthenerd.inline:inline-fabric:${project.inline_version}"
// and forge
modApi "com.samsthenerd.inline:inline-forge:${project.inline_version}"The library is documented using javadoc, with an online version available at https://inline.samsthenerd.com/. If you have any trouble using the library feel free to open an issue or find me in one of the larger modding discords.
While Inline is mostly done and the existing API should remain stable, there are still a few features I'd like to add before calling it feature complete:
- animated spritelikes
- better sign glow outline and transparency handling
- a suggestion prompt mechanism (maybe)
- stylers (maybe) -- for adding various styles to text without replacing it.
Once I get enough of these done that I feel Inline is complete, I'll port it to other versions and keep it up to date and whatnot.