Перейти к содержимому
Mineforgian

Played

Played is a lightweight Fabric mod that tracks local playtime for singleplayer worlds and multiplayer servers, with a total playtime display and optional Mod Menu config.

Загрузки
2K
Подписчики
9
Обновлён
18 июля 2026 г.
Лицензия
Played-Proprietary-License-1.0

Опубликован 18 апреля 2026 г.

Сообщить об ошибке

Played

Requires Fabric APICurseForgeModrinth

WebsiteDiscord

Played is a lightweight, client-side Fabric mod that tracks how long you play in each singleplayer world and on each multiplayer server. It also keeps a combined all-time total and displays your playtime directly in Minecraft's existing menus.

All data stays on your device. Played does not require installation on the server and does not upload or synchronize your statistics.

Features

  • Tracks playtime separately for every singleplayer world
  • Tracks playtime separately for every multiplayer server address
  • Keeps a combined all-time total across worlds and servers
  • Shows playtime in the singleplayer world list and multiplayer server list
  • Shows total playtime on the title screen
  • Can show the current world or server playtime in the pause menu
  • Can show an optional playtime HUD while playing, with four selectable screen corners, adjustable size and offsets, and an optional background
  • Provides the client-side /played command for session, current, and all-time statistics
  • Provides /played session, /played current, and /played total shortcuts
  • Supports optional AFK detection with a configurable timeout
  • Pauses tracking while Minecraft itself is paused
  • Can sort world and server lists by playtime in ascending or descending order
  • Offers verbose, compact, and clock-style time formats
  • Supports separate MiniMessage templates for lists, the title screen, and the pause menu
  • Supports gradients and the {time}, {session}, {current}, and {total} placeholders in display templates
  • Offers an optional translucent background behind list playtime text
  • Places list text responsively around scrollbars and narrow screens
  • Keeps title-screen and pause-menu text away from existing bottom-left text where possible
  • Adds optional reset buttons to the Edit World and Edit Server screens
  • Lets world tracking, server tracking, and every display location be enabled separately

Configuration

When Mod Menu is installed, Played provides an in-game configuration screen powered by Cloth Config.

Available settings include:

  • Singleplayer and multiplayer tracking
  • AFK pausing and AFK timeout
  • World-list and server-list playtime displays
  • Optional list backgrounds
  • Title-screen and pause-menu displays
  • Optional HUD display, background, anchor corner, size, horizontal and vertical offsets, and template
  • World and server reset buttons
  • Ascending, descending, or disabled playtime sorting
  • Verbose, compact, or clock time formatting
  • Custom list, title-screen, pause-menu, and HUD templates

The HUD is disabled by default, so updating Played does not add a new permanent overlay unless it is explicitly enabled.

Individual world or server playtime can be reset from its edit screen with the compact ⏱ button. A confirmation dialog prevents accidental resets.

Without Mod Menu, Played continues to track and display playtime normally. Its properties file can still be edited manually while Minecraft is closed.

Reliable Local Storage

Played saves data periodically and whenever tracking pauses, the active world or server changes, a connection closes, or the client shuts down.

Writes use temporary replacement files instead of truncating existing data. Before an existing file is replaced, Played creates a .bak backup and can recover from that backup if the primary file becomes unreadable. Older storage layouts are migrated automatically, including recovery from an interrupted partial migration.

Server addresses are normalized consistently, so capitalization does not create duplicate entries. Renaming a saved server keeps its accumulated playtime.

Storage Locations

Each singleplayer world's playtime is stored inside that world:

saves/<world>/Played/playtime.properties

The combined all-time total is stored at:

Played/alltime.properties

Multiplayer server playtime is stored at:

Played/server.properties

Configuration is stored at:

config/Played/config.properties

Updating

Existing world, server, total-playtime, and configuration data remain compatible when updating from previous Played versions. Replace only the old mod JAR; do not delete the Played or config/Played directories.

Requirements

  • Minecraft 26.2
  • Java 25 or newer
  • Fabric Loader 0.19.3 or newer
  • Fabric API
  • Cloth Config

Optional

  • Mod Menu, for convenient access to the in-game configuration screen

Ченджлог

mc26.2-26.7.0-fabricРелиз26.2 · 18 июля 2026 г.

Changelog

Optional Playtime HUD

  • Added an opt-in playtime HUD that can be placed in any screen corner.
  • Added adjustable HUD sizing from 50% to 200%.
  • Added horizontal and vertical offsets for precise placement relative to the selected corner.
  • Added an optional translucent HUD background for readability.
  • The HUD background is disabled by default for a cleaner display.
  • The HUD stays hidden while another screen is open and remains disabled by default.

Richer Display Templates

  • Display templates now support {session}, {current}, and {total} alongside the existing {time} placeholder.
  • Added a separate MiniMessage HUD template, defaulting to the current world or server playtime.

Command Improvements

  • Added /played session, /played current, and /played total shortcuts.
  • /played command output now follows the configured time format.

Configuration Screen

  • Reorganized settings into clear collapsible sections.
  • Grouped every HUD option, including its template, inside a dedicated HUD section.
  • All collapsible sections are expanded by default while remaining manually collapsible.

Dependency Updates

  • Updated Fabric API to 0.155.2+26.2.
  • Updated Mod Menu to 20.0.1.
  • Cloth Config remains on the current 26.2.155+fabric release.

Release Automation

  • publishPatch and publishMinor now create a matching GitHub release after the Modrinth and CurseForge uploads finish.
  • GitHub releases use the Gradle mod version and provide platform download links plus .public/changelog.md as release notes without attaching a mod JAR.
  • Version auto-bumps are skipped for Gradle help requests and dry runs, so previewing a publish no longer changes gradle.properties.
  • GitHub download links are maintained separately in .public/release-header.md and prepended to the generated release notes.
  • Modrinth uploads now retry safely after timeouts and verify the exact online version before CurseForge or GitHub runs.
  • Releases now run strictly in the order Modrinth, CurseForge, then GitHub, and only store the bumped version after every platform succeeds.
  • A release preflight now validates local credentials, release files, and GitHub CLI authentication before uploading anything.

Source Available

  • The mod is now source available on GitHub for transparency, private modifications, and contributions.
  • Added the Played Source-Available License 1.0, which reserves publishing and distribution to Zorblock.
mc26.2-26.5.0-fabricРелиз26.2 · 12 июля 2026 г.

Changelog

Improved Data Storage

  • Playtime, server, and configuration data are now saved atomically, preventing crashes during saving from corrupting or emptying files.
  • A .bak backup of the previous file is created automatically before every update.
  • Played automatically restores playtime data from its backup if a file is corrupted or cannot be read.
  • Reliable immediate saving on world/server changes, AFK, disconnects, and client shutdown remains in place.

Stability Fixes

  • Disconnect handling now runs on Minecraft's client thread instead of racing the render thread from Netty I/O.
  • AFK and periodic-save timing now use a monotonic clock and are unaffected by system clock changes.
  • Interrupted legacy storage migrations recover whichever central data file is missing without restoring intentionally deleted server entries.
  • Server addresses are normalized consistently, renamed servers update their stored display name, and locale-specific casing can no longer create duplicate entries.
  • Invalid boolean config values retain the last valid setting, and negative AFK timeouts are clamped safely.
  • Cloth Config is now declared as a required dependency, preventing a missing-library crash when opening Played's config screen.
  • Added automated storage, migration, overflow, and invalid-config regression tests.
mc26.2-26.4.2-fabricРелиз26.2 · 11 июля 2026 г.

Changelog

  • Updated the mod icon.
  • Resized the mod icon to the optimal 256x256 resolution.
mc26.2-26.4.1-fabricРелиз26.2 · 11 июля 2026 г.

Changed

  • Config: Changed the default value of the "List Background" option from true to false for a cleaner look out of the box.
mc26.2-26.4.0-fabricРелиз26.2 · 11 июля 2026 г.

Fixed

  • Crash Fix: Fixed critical java.lang.NoClassDefFoundError crashes (net/kyori/examination/Examinable, net/kyori/adventure/key/InvalidKeyException, and JSONComponentSerializer) that occurred on the title screen when the mod attempted to parse MiniMessage formats. The missing Kyori Adventure dependencies (examination-api, examination-string, adventure-key, adventure-text-serializer-json, and option) are now properly embedded into the mod JAR.
  • Publish Script: Fixed the Modrinth and CurseForge upload configuration. The script now correctly specifies the Modloader ("Fabric") and properly passes all required dependencies to Modrinth.
  • IDE / Workspace: Fixed several development workspace issues in VS Code related to incorrect Java version enforcement (Java 25 is now correctly used) and an incompatible CurseForgeGradle parser target.
  • Code Quality: Resolved various IDE static analysis warnings regarding null safety and type safety across the client UI components.
mc26.2-26.1.0-fabricРелиз26.2 · 8 июля 2026 г.

Changed

  • Updated Fabric Loader to 0.19.3.
  • Updated Fabric API to 0.152.1+26.2.
  • Updated Fabric Loom to 1.17.
  • Updated the Gradle wrapper to 9.5.1.
  • Switched the mod versioning scheme to the new year-based format, starting with 26.0.6.

Fixed

  • Updated screen switching calls for Minecraft 26.2's GUI API changes.
  • Verified the mod builds successfully against Minecraft 26.2.
mc26.2-26.0.6-fabricРелиз26.2 · 16 июня 2026 г.

Changed

  • Updated Played to Minecraft 26.2.
  • Updated Fabric Loader to 0.19.3.
  • Updated Fabric API to 0.152.1+26.2.
  • Updated Fabric Loom to 1.17.
  • Updated the Gradle wrapper to 9.5.1.
  • Switched the mod versioning scheme to the new year-based format, starting with 26.0.6.

Fixed

  • Updated screen switching calls for Minecraft 26.2's GUI API changes.
  • Verified the mod builds successfully against Minecraft 26.2.
mc26.1.2-1.0.5-fabricРелиз26.1.2 · 9 июня 2026 г.

Added

  • Added a new time format option in the Played config screen.
  • Added three display formats for playtime values: Verbose, Compact, and Clock.
  • The selected time format now applies to world/server lists, the title screen, and the pause menu.

Changed

  • Simplified the mod to use English text only.
  • Removed all bundled language files and translation-based UI text.
  • Kept all config screen labels, tooltips, reset dialogs, and sorting messages in English.

Fixed

  • Cleaned up config screen text handling to avoid Java null-safety warnings in supported IDEs.

Комментарии

Загружаем…