Описание
# TimeFormatter
[](https://opensource.org/licenses/MIT)
A simple client-side Minecraft mod that automatically finds and formats Discord-style timestamps in chat, converting them to your local time.
## Features
- **Client-Side Only**: No server-side installation is required. It works on any server you join. The formatting works only with the mod installed.
- **Automatic Formatting**: Detects timestamps like `` in chat messages.
- **Literal Sending** (not timezone aware): If a timestamp like `` is sent in the chat, it will get replaced by a matching literal assuming it won't overflow the 256 character limit, thus visible to everyone.
- **Local Time Conversion**: All timestamps are converted and displayed in your computer's local time zone.
- **Multiple Formats**: Supports all of Discord's standard timestamp formatting styles.
- **Relative Time**: Can display time relatively, such as "5 minutes ago" or "in 2 hours".
## How It Works
The mod checks incoming chat messages for timestamps like `` (or ``).
- `TIMESTAMP`: A Unix timestamp (in seconds). You can also use the special values `yesterday`, `now` and `tomorrow` to represent the respective time.
- `STYLE`: An optional single character that controls the output format. If you don't provide a style, it defaults to `f` (Short Date/Time).
### Supported Styles
| Style | Example Output | Description |
|:-----:|:-------------------------------------|:--------------------------|
| `t` | `14:30` | Short Time |
| `T` | `14:30:00` | Long Time |
| `d` | `31/12/2023` | Short Date |
| `D` | `December 31, 2023` | Long Date |
| `f` | `December 31, 2023 at 14:30` | Short Date/Time (Default) |
| `F` | `Sunday, December 31, 2023 at 14:30` | Long Date/Time |
| `R` | `5 minutes ago` | Relative Time |
### Example
If another player let's say in the UTC timezone sends the following message in chat:
> `The server event will start at .`
And you're in the GMT+1 timezone, you'll see:
> `The server event will start at Monday, January 1, 2024 at 01:00.`
However, if the player in UTC sends this message in chat:
> `My date and time is .`
Everyone (even players without this mod) will see this:
> `The server event will start at Monday, January 1, 2024 at 01:00.`
## Installation
This is a Fabric mod and requires the [Fabric API](https://modrinth.com/mod/fabric-api).
1. Download the latest version.
2. Place the downloaded `.jar` file into your `.minecraft/mods` folder.
3. Launch the game using the Fabric Loader.
## Building from Source
1. Clone the repository: `git clone https://github.com/m3z0id/TimeFormatter.git`
2. Navigate into the project directory: `cd TimeFormatter`
3. Build the project using Gradle: `./gradlew build -Pmc= -Pyarn= -Papi= -Padventure=`
4. The compiled `.jar` file will be located in the `build/libs/` directory.
## License
This project is licensed under the MIT License. See the `LICENSE` file for more details.