Local Time (PlaceholderAPI) icon

Local Time (PlaceholderAPI) -----

Simple plugin that uses PlaceholderAPI to show in-game Local-time set through config

Download Now
8.4 KB .jar


LocalTime
Advanced Time & Date Placeholders for PlaceholderAPI
[​IMG]​
Overview
LocalTime is a powerful yet lightweight PlaceholderAPI expansion that brings customizable time and date placeholders to your server. Display server time in any format, show dates with custom patterns, and give your players timezone-aware information.


Features
  • Multiple Time Formats - Choose between 12-hour and 24-hour displays
  • AM/PM Support - Optional AM/PM indicators for 12-hour format
  • Flexible Date Display - Show dates in any format you need
  • Timezone Control - Use fixed timezones or follow server time automatically
  • 20+ Placeholders - Everything from basic time to Unix timestamps
  • Live Config Reload - Change settings without restarting
  • Zero Performance Impact - Optimized and lightweight


Placeholders
Basic Time & Date
Code (Text):
%localtime_time%          → 14:30:45 (configurable)
%localtime_time_12h%       → 02:30:45 PM
%localtime_time_24h%       → 14:30:45
%localtime_time_short%     → 14:30 or 2:30 PM
%localtime_date%           → 2026-03-09
%localtime_date_short%     → 03/09/2026
%localtime_date_long%      → March 09, 2026
%localtime_datetime%       → 2026-03-09 14:30:45
Components
Code (Text):
%localtime_day%            → 9
%localtime_month%          → 3
%localtime_year%           → 2026
%localtime_hour%           → 14
%localtime_minute%         → 30
%localtime_second%         → 45
Names
Code (Text):
%localtime_day_name%       → Monday
%localtime_day_name_short% → Mon
%localtime_month_name%     → March
%localtime_month_name_short% → Mar
Timezone & Unix
Code (Text):
%localtime_timezone%       → America/New_York
%localtime_timezone_offset% → -05:00
%localtime_unix%           → 1741535445
%localtime_unix_millis%    → 1741535445000

Configuration
Code (YAML):
# Timezone Settings
timezone-mode : "fixed"     # "fixed" or "server"
timezone : "GMT"           # Any valid timezone ID

# Time Format
time-format-12h : false     # true for 12h, false for 24h
show-am-pm : true           # Show AM/PM in 12h mode
time-pattern : "HH:mm:ss"   # Custom pattern

# Date Format
date-pattern : "yyyy-MM-dd"
date-time-separator : " "
 
Example Configurations

12-hour format with AM/PM:
Code (YAML):
time-format-12h : true
show-am-pm : true
time-pattern : "hh:mm:ss a"
European date format:
Code (YAML):
date-pattern : "dd/MM/yyyy"
Use server timezone:
Code (YAML):
timezone-mode : "server"
Specific timezone:
Code (YAML):
timezone-mode : "fixed"
timezone : "America/New_York"

Commands & Permissions

Commands
Code (Text):
/localtime         - Show plugin info
/localtime reload   - Reload configuration
/localtime info     - Display current settings

Alias: /lt
Permissions
Code (Text):
localtime.use      - Use commands (default: everyone)
localtime.reload   - Reload config (default: OP)

Installation

  1. Download LocalTime-2.0.0.jar
  2. Place in your server's plugins/ folder
  3. Make sure PlaceholderAPI is installed
  4. Restart your server
  5. Configure plugins/LocalTime/config.yml to your needs
  6. Use /papi reload if needed


Requirements

  • Minecraft: Paper/Spigot 1.19 or higher
  • Java: 8 or higher
  • Dependencies: PlaceholderAPI (required)


Changelog - Version 2.0.0

  • Added 20+ placeholders for comprehensive time/date display
  • Implemented 12-hour and 24-hour time format support
  • Added AM/PM indicator toggle
  • Added date placeholders with multiple formats
  • Added timezone offset placeholder
  • Added Unix timestamp placeholders
  • Added day/month name placeholders
  • Added component placeholders (day, month, year, hour, minute, second)
  • Implemented /localtime info command
  • Added command alias /lt
  • Improved config with detailed documentation
  • Added timezone mode: fixed or server
  • Enhanced config reload functionality
  • Optimized performance


Support

Found a bug? Have a suggestion? Post in the discussion thread or open an issue on GitHub.

Enjoying the plugin? Leave a review! ⭐

Made with ❤️ for the Minecraft community
by Anonventions​
View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 807
First Release: Feb 21, 2024
Last Update: Mar 9, 2026
Category: ---------------
All-Time Rating:
2 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings