AfkPlus

# AfkPlus Fabric Mod for Minecraft

[!(https://github.com/sakura-ryoko/afkplus/actions/workflows/gradle.yml/badge.svg)](https://github.com/sakura-ryoko/afkplus/actions/workflows/gradle.yml)

!(https://sakuraryoko.com/files/1260026/afkplus.jpg)

[!(https://sakuraryoko.com/files/1398873/discord-300px.png)](https://discord.gg/ryokocraftmc)

## Basic Description: - A forked project based upon AfkDisplay by beabfc. He has given me his blessing with proceeding to create this mod, look under my Archived Issues pane. - Show which players are AFK in the player list, see the Reasons, Durations, and Times. - Fully configurable and with (https://placeholders.pb4.eu/user/general/), which includes all Placeholder API formatting nodes such as: yellow or bold natively. (You can even include a URL in your AFK Reason!) - Mod can now be used on Single Player, and Integrated Servers (Open to LAN). - [NEW] Mod has now been mostly rewritten as of December 2024; as a MultiVersion project based on (https://github.com/Fallen-Breath/fabric-mod-template) architecture. - [NEW] Mod Now is a dependency of my new library mod, (https://github.com/sakura-ryoko/corelib), and the More Color system has also been forked into my (https://github.com/sakura-ryoko/more-color-api) mod. - They are both included in the AfkPlus JAR file.

## MOD ReWrite & NEW Features - Entire mod ecosystem has been migrated to a multi-version architecture to more quickly port the mod to versions 1. 19. 2-1. 21. 4+ at the same time, using a single branch. - Config no longer uses TOML, and has been converted to the Data Driven (https://github.com/sakura-ryoko/corelib) based JSON config system; which works similar to how Pat's Mod ecosystem works. - Most Player / Server Events are now managed by (https://github.com/sakura-ryoko/corelib) interfaces; with a few AFK Specific exceptions. - All Commands are now registered and managed by a (https://github.com/sakura-ryoko/corelib) interface. - All abstract Text Placeholder API formatting, and extra color tags are now managed by (https://github.com/sakura-ryoko/more-color-api). See the `/morecolors` command. - All new abstract TimeDate / Duration formatting interfaces are managed by (https://github.com/sakura-ryoko/corelib). - Entirely rewritten AfkPlayer / Afk Player List system based on abstraction; instead of being managed via Mixin classes. This should help with any strict mod compatibility issues; and fight off ugly code. - Entire mod EcoSystem from CoreLib to AfkPlus each has an API / Event system for other mods to implement and make compatible in their own mods. - AfkPlus adds API compat handling for `Vanish`, `Carpet Mod`, and `Styled Player List`. Each mod's integration varies based on any compatibility needs. - Added several `message` options, and forked the `afkKick` and `disableDamage` systems into their own configuration categories. See the config below for more defaulted information. - Several other annoyances, bugs, and features have been added as requested; such as the ability to fully configure the `Gone for: XXX` messages by various config options.

## Features - Added a placeholder `%afkplus:afk%` for you to offer a very basic '' tag to players who are AFK. - Added a placeholder `%afkplus:name%`/`%afkplus:display_name%` so that you can use this as a replacement for the '%player:displayname%' placeholder under other Mods, such as (https://modrinth.com/mod/styledplayerlist "Styled Playerlist"). NOTE that this method was designed to be fully compliant with LuckPerms Prefixes under Styled Playerlist, because the standard method for playerlist updating fails, or you can simply use %afkplus:afk% to add formatting to existing names if you like. - Added a placeholder `%afkplus:duration%` so that you can get the time since someone went AFK, with configuration for a format prefix. - Added a placeholder `%afkplus:time%` so that you can get the Time/Date when someone went AFK, with configuration for a format prefix. - Added a placeholder `%afkplus:reason%` so that you can port the Afk Reason for why someone went AFK, with configuration for a format prefix. - Added a placeholder `%afkplus:invulnerable%` so that you can display the "Disable Damage" status for all users, similar to the "" placeholder tag, but more or less an "add on". - There is a special configuration option 'prettyDuration' to configure the AFK Duration in a more human-readable format, instead of the default (HH:mm:ss.mss) format. Each method has its advantages though. ((https://modrinth.com/mod/styled-nicknames) or (https://modrinth.com/mod/styled-chat) comes to mind here) - There are several mod / data pack conflict warnings for administrators to help them make better decisions on what mods t