Local Time (PlaceholderAPI)

LocalTime
Advanced Time & Date Placeholders for PlaceholderAPI

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

%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

%localtime_day%            → 9
%localtime_month%          → 3
%localtime_year%           → 2026
%localtime_hour%           → 14
%localtime_minute%         → 30
%localtime_second%         → 45

Names

%localtime_day_name%       → Monday
%localtime_day_name_short% → Mon
%localtime_month_name%     → March
%localtime_month_name_short% → Mar

Timezone & Unix

%localtime_timezone%       → America/New_York
%localtime_timezone_offset% → -05:00
%localtime_unix%           → 1741535445
%localtime_unix_millis%    → 1741535445000

Configuration

# 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:

time-format-12h: true
show-am-pm: true
time-pattern: "hh:mm:ss a"

European date format:

date-pattern: "dd/MM/yyyy"

Use server timezone:

timezone-mode: "server"

Specific timezone:

timezone-mode: "fixed"
timezone: "America/New_York"

Commands & Permissions

Commands

/localtime         - Show plugin info
/localtime reload   - Reload configuration
/localtime info     - Display current settings

Alias: /lt

Permissions

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