Mods / ToastLib

Description
Files
Issue tracker
Source
Donate

Tags: #Utility
Author: AriesLR
Side: Both
Created: Oct 22nd at 7:57 AM
Last modified: Nov 7th at 7:58 AM
Downloads: 675
Follow Unfollow 18

Recommended download (for Vintage Story 1.21.1 - 1.21.5):
toastlib_0.3.1.zip 1-click install

Description

ToastLib is a library leveraging the ImGui implementation by Maltiez to draw toast style popups.

This mod will not really do anything by itself, other mods should use this to have any messages show outside of chat.

The reason I made this was because a few players on my server complained about how annoying some mods are with spamming the game chat. One of my own mods was even worse and swapped to the info channel to keep messages out of the general chat, but that ended up being even more annoying having to manually switch chat channels again.

Requirements

ImGui

Features

Toast Notifications — Display customizable toast notifications on the screen.
Configurable Styles — Easily change the appearance of the toast notifications by using the ShowToastAdv() method.
Smooth Animations — Smooth slide-in and slide-out animations for the toast notifications.
Minimal VTML Support — Support for a limited subset of VTML, allowing for basic markup and styling.
Easy To Use — Send toast notifications in nearly the same format as the vanilla SendMessage() method.

Supported VTML Tags

Tag	Description	Example	Result
`<font color=" ">`	Sets text color	`<font color="lightcoral">Alert</font>`	Alert
`<font color=" ">`	Sets text color	`<font color="#00F2FF">Info</font>`	Info
`<font weight="bold">`	Makes text bold	`<font weight="bold">Important</font>`	Important
`<strong>`	Alias for bold text	`<strong>Warning</strong>`	Warning
`<br>`	Inserts a line break	`Line 1<br>Line 2`	Line 1 Line 2

Documentation

For documentation view the README

Mod(s) Using ToastLib

Claim Flight - Outdated Usage, but still functional.

Support

Mod Version	Mod Identifier	For Game version	Downloads	Released	Changelog	Download	1-click mod install*
0.3.1	toastlib	1.21.1 - 1.21.5	426	Nov 7th at 7:58 AM	Show	toastlib_0.3.1.zip	1-click install
- Small change to fix null warnings in other mods.
0.3.0	toastlib	1.21.1 - 1.21.5	7	Nov 7th at 7:28 AM	Show	toastlib_0.3.0.zip	1-click install
- Moved commands to a new file to clean up code. - Added server-side commands. - Substantial code refactoring. - Added comments within code to assist in understanding how the code works. - Added logic to allow toasts to be called from the server easier. In the past the user would have to implement protobuf in their own mod to send toasts via `ShowToast()`. Now the proper server-side usage would be `toastLib.Server.ShowToast()`. - Removed `FormatLang()` method and the usage of said method. `Lang.Get` already handles this. - Updated README with proper documentation as well as adding the server-side documentation.
0.2.0	toastlib	1.21.1 - 1.21.5	191	Oct 23rd at 5:42 AM	Show	toastlib_0.2.0.zip	1-click install
Added - `ShowToastAdv()` method for users who want more control over the toast's display color and time. - New example/testing subcommands: `.toastlib placeholder`, `.toastlib placeholderadv`, `.toastlib multi`, and `.toastlib multiadv` Changed - Reversed the order toasts are displayed in; the newest toast is now displayed on top. - Changed command descriptions to use a lang key instead of plain text. Fixed - Fixed spacing between toasts if multiple toasts are visible at the same time. - Fixed 8 digit hex color code support. - Fixed vertical alignment on text in relation to the toast's background. - Improved toast display and hide animations.
0.1.0	toastlib	1.21.1 - 1.21.5	51	Oct 22nd at 7:58 AM	Show	toastlib_0.1.0.zip	1-click install
- Initial Release

0 Comments (oldest first | newest first)

(edit comment delete)